述語データ オブジェクト - 顧客の課金
SearchCoupons や SearchInsertionOrders など、検索操作のいずれかを使用して返される広告掲載オーダーの一覧の述語を定義します。
構文
<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 の各要素があります。
| 要素 | 説明 | データ型 |
|---|---|---|
| フィールド | 検索するオブジェクトの要素の名前。 使用可能な値については、 SearchInsertionOrders 操作に関するページを 参照してください。 |
string |
| オペレーター | フィールドと値の間のリレーションシップを定義します。 | PredicateOperator |
| 価値 | 指定したフィールドで検索する文字列。 フィールドが MarketCountry または MarketLanguage に設定されていない限り、この文字列の長さは 4 つ以上にする必要があります。 |
string |
解説
サービス操作ごとに、Predicate オブジェクトのサポートされる Field 要素と Operator 要素について、以下で詳しく説明します。
SearchCoupons 述語
SearchCoupons サービス操作では、Predicate オブジェクトの Field 要素と Operator 要素がサポートされています。
| フィールド | オペレーター | 説明 |
|---|---|---|
| CustomerId | 等しい | このフィールドを使用して、クーポン クラスの所有者の顧客で検索します。 この述語フィールドは必須です。 |
| CouponClassName | 等しい | このフィールドを使用して、クーポン クラス名で検索します。 |
| IsRedeemed | 等しい | このフィールドを使用して、クーポンの IsRedeemed 要素で検索します。 |
| StartDate | GreaterThanEquals | このフィールドを使用して、開始日クーポン検索します。 日付は協定世界時 (UTC) に格納されます。 検索には、指定した文字列の月、日、年のみが使用されます。 日付の時間、分、秒を指定した場合、それらは無視されます。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。 |
SearchInsertionOrders 述語
SearchInsertionOrders サービス操作では、Predicate オブジェクトの Field 要素と Operator 要素がサポートされています。
| フィールド | オペレーター | 説明 |
|---|---|---|
| AccountId | 等しい | このフィールドを使用して、挿入注文のアカウント識別子で検索します。 この述語フィールドは必須です。 |
| EndDate | GreaterThanEquals LessThanEquals |
このフィールドを使用して、挿入順序の終了日で検索します。 日付は協定世界時 (UTC) に格納されます。 検索には、指定した文字列の月、日、年のみが使用されます。 日付の時間、分、秒を指定した場合、それらは無視されます。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。 |
| InsertionOrderId | 等しい In |
このフィールドを使用して、挿入順序 ID で検索します。 |
| StartDate | GreaterThanEquals LessThanEquals |
このフィールドを使用して、挿入順序の開始日で検索します。 日付は協定世界時 (UTC) に格納されます。 検索には、指定した文字列の月、日、年のみが使用されます。 日付の時間、分、秒を指定した場合、それらは無視されます。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。 |
要件
サービス: CustomerBillingService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities