述詞數據物件 - 客戶計費
定義使用其中一個搜尋作業傳回之插入訂單清單的述詞，例如 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，否則此字串的長度必須是四或更大。 |
string |
註解
以下詳細說明每個服務作業之 Predicate 物件支援的 Field 元素和運算子元素。
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 | 等於 於 |
使用此欄位依插入順序標識碼進行搜尋。 |
| StartDate | GreaterThanEquals LessThanEquals |
使用此欄位依插入順序開始日期進行搜尋。 日期會儲存在國際標準時間 (UTC) 。 只有指定字串的月、日和年用於搜尋。 如果您指定日期的小時、分鐘和秒，則會忽略它們。 如需日期和時間格式的相關信息，請參閱 基本 XML 數據類型中的 dateTime 專案。 |
需求
服務： CustomerBillingService.svc v13
命名空間： https://bingads.microsoft.com/Customer/v13/Entities