述語データ オブジェクト - Customer Management

  • [アーティクル]

SearchAccounts、SearchClientLinks、SearchCustomers、SearchUserInvitations など、いずれかの検索操作を使用して要求されたエンティティの一覧の述語を定義します。

構文

<xs:complexType name="Predicate" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Field" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Operator" type="tns:PredicateOperator" />
    <xs:element minOccurs="0" name="Value" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

要素

Predicate オブジェクトには、Field、Operator、Value の各要素があります。

要素 説明 データ型
フィールド 検索するオブジェクトの要素の名前。

使用可能な値については、以下の 「備考」を 参照してください。		 string
オペレーター フィールドと値の間のリレーションシップを定義します。 PredicateOperator
値 指定したフィールドで検索する文字列。

フィールドが MarketCountry または MarketLanguage に設定されていない限り、この文字列の長さは 4 つ以上にする必要があります。		 string

注釈

サービス操作ごとに、Predicate オブジェクトのサポートされる Field 要素と Operator 要素について、以下で詳しく説明します。

SearchAccounts 述語

SearchAccounts サービス操作では、Predicate オブジェクトの Field 要素と Operator 要素がサポートされています。

フィールド オペレーター 説明
AccountId 等しい

In		 このフィールドを使用して、 AdvertiserAccount の Id 要素を検索します。
AccountLifeCycleStatus 等しい このフィールドを使用して、 AdvertiserAccount の AccountLifeCycleStatus 要素を検索します。

使用可能な値には、"Active"、"Draft"、"Inactive"、"Pause"、"Pending"、"Suspended" などがあります。
- "アクティブ" 状態でアカウントを要求すると、 AccountLifeCycleStatus が [アクティブ] に設定されているアカウントが返されます。 この操作では、 AccountLifeCycleStatus が Pause に設定されたアカウントも返されます。 PauseReason の値は 2 です (課金サービスはアカウントを一時停止しました)。
- "一時停止" 状態でアカウントを要求すると、 AccountLifeCycleStatus が Pause に設定されたアカウントが返されます。 PauseReason の値は 1 (ユーザーがアカウントを一時停止しました) または 4 (ユーザーと課金サービスがアカウントを一時停止しました) です。
AccountName Contains

等しい		 このフィールドを使用して、 AdvertiserAccount の Name 要素を検索します。
AccountNumber Contains

等しい

In		 このフィールドを使用して、 AdvertiserAccount の Number 要素を検索します。
Customerid 等しい このフィールドを使用して、Customer の Id 要素を検索 します。
UserId 等しい このフィールドを使用して、User の UserId 要素を検索 します。

SearchClientLinks サービス操作では、Predicate オブジェクトの Field 要素と Operator 要素がサポートされています。

フィールド オペレーター 説明
ClientAccountId 等しい

In		 クライアント広告主アカウント識別子で広告主アカウント ClientLink オブジェクトを検索します。
ClientCustomerId 等しい

In		 クライアント顧客識別子で Customer ClientLink オブジェクトを検索します。
DirectManagingCustomerId 等しい 代理店の管理する顧客識別子によって、顧客アカウントと広告主アカウント ClientLink オブジェクトの両方を検索します。 他の顧客もクライアント顧客にリンクしている場合、結果にはそれらのクライアント リンクは含まれません。
ManageingCustomerId 等しい 代理店の管理する顧客識別子によって、広告主アカウント ClientLink オブジェクトを検索します。 他の顧客もクライアント広告主アカウントにリンクしている場合、結果にはそれらのクライアント リンクが含まれます。 この述語値は、DirectManagingCustomerId 述語を優先して非推奨になっています。

SearchClientLinks の次の述語規則に注意してください。

  • DirectManagingCustomerId と ManageingCustomerId の両方を含めることはできません。
  • ClientAccountId と ClientCustomerId の両方を含めることはできません。
  • 同じサービス呼び出しに ClientAccountId 述語と ManageingCustomerId 述語の両方を含める場合、ManageingCustomerId は無視されます。
  • 同じサービス呼び出しに ClientCustomerId と DirectManagingCustomerId の両方の述語を含める場合、結果には両方の述語条件を満たす顧客クライアント リンクのみが含まれます。
  • 同じサービス呼び出しに ClientAccountId と DirectManagingCustomerId の両方の述語を含める場合、結果には両方の述語条件を満たす広告主アカウント クライアント リンクのみが含まれます。

SearchCustomers 述語

SearchCustomers サービス操作では、Predicate オブジェクトの Field 要素と Operator 要素がサポートされています。

フィールド オペレーター 説明
AccountId 等しい このフィールドを使用して、 AdvertiserAccount の Id 要素を検索します。
AccountName Contains

等しい		 このフィールドを使用して、 AdvertiserAccount の Name 要素を検索します。
AccountNumber Contains

等しい		 このフィールドを使用して、 AdvertiserAccount の Number 要素を検索します。
ApplicationScope 等しい 内部使用のみ。
CreatedDate GreaterThanEquals

LessThanEquals		 このフィールドを使用して、顧客が作成またはサインアップされた日付を検索します。

日付は協定世界時 (UTC) に格納されます。 検索には、指定した文字列の月、日、年のみが使用されます。 日付の時間、分、秒を指定した場合、それらは無視されます。

日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。
Customerid 等しい

In		 このフィールドを使用して、Customer の Id 要素を検索 します。
CustomerName Contains

等しい		 このフィールドを使用して、Customer の Name 要素を検索 します。
MarketCountry 等しい このフィールドを使用して、Customer の MarketCountry 要素を検索 します。

MarketCountry と MarketLanguage 述語フィールドは必要ありません。ただし、どちらかが指定されている場合は、両方が必要です。
MarketLanguage 等しい このフィールドを使用して、Customer の MarketLanguage 要素を検索 します。

MarketCountry と MarketLanguage 述語フィールドは必要ありません。ただし、どちらかが指定されている場合は、両方が必要です。
UserName 等しい このフィールドを使用して、User の UserName 要素を検索 します。

SearchUserInvitations 述語

SearchUserInvitations サービス操作では、Predicate オブジェクトの Field 要素と Operator 要素がサポートされています。

フィールド オペレーター 説明
Customerid 等しい このフィールドを使用して、 UserInvitation の CustomerId 要素を検索します。

要件

サービス: CustomerManagementService.svc v13
名前 空間： https://bingads.microsoft.com/Customer/v13/Entities

Used By

SearchAccounts
SearchClientLinks
SearchCustomers
SearchUserInvitations