述詞數據物件 - 客戶管理
定義使用其中一個搜尋作業所要求之實體清單的述詞，例如 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。
| 元素 | 描述 | 資料類型 |
|---|---|---|
| 欄位 | 您要搜尋之物件的項目名稱。 For possible values, see the Remarks below. |
string |
| 運算子 | 定義欄位與值之間的關聯性。 | PredicateOperator |
| 值 | 要在指定欄位中搜尋的字串。 除非欄位設定為 MarketCountry 或 MarketLanguage，否則此字串的長度必須是四或更大。 |
string |
註解
以下詳細說明每個服務作業之 Predicate 物件支援的 Field 元素和運算子元素。
SearchAccounts 述詞
針對 SearchAccounts 服務作業，以下是 Predicate 對象支援的 Field 元素和 Operator 元素。
| 欄位 | 運算子 | 描述 |
|---|---|---|
| AccountId | 等於 於 |
使用此欄位來搜尋 MarketplaceAccount 的 Id 元素。 |
| AccountLifeCycleStatus | 等於 | 使用此欄位來搜尋 MarketplaceAccount 的 AccountLifeCycleStatus 元素。 可能的值包括 「Active」、“Draft”、“Inactive”、“Pause”、“Pending” 和 “Suspended”。 - 當您依「作用中」狀態要求帳戶時，此作業會傳回 AccountLifeCycleStatus 設為 Active 的帳戶。 此作業也會傳回 AccountLifeCycleStatus 設定為 Pause 的帳戶，其中 PauseReason 值為 2， (計費服務將帳戶暫停) 。 - 當您以「暫停」狀態要求帳戶時，作業會傳回 AccountLifeCycleStatus 設為 Pause 的帳戶，其中 PauseReason 值為 1 (使用者暫停帳戶) 或使用者暫停帳戶 (4，而計費服務會暫停帳戶) 。 |
| AccountName | 包含 等於 |
使用此欄位來搜尋 MarketplaceAccount 的 Name 元素。 |
| AccountNumber | 包含 等於 於 |
使用此欄位來搜尋 [MarketplaceAccount] 的 Number 元素。 |
| CustomerId | 等於 | 使用此欄位來搜尋 Customer 的 Id 元素。 |
| UserId | 等於 | 使用此欄位來搜尋 User 的 UserId 元素。 |
SearchClientLinks 述詞
若為 SearchClientLinks 服務作業，以下是 Predicate 對象支援的 Field 元素和 Operator 元素。
| 欄位 | 運算子 | 描述 |
|---|---|---|
| ClientAccountId | 等於 於 |
依用戶端用戶端帳戶標識碼搜尋廣告客戶帳戶 ClientLink 物件。 |
| ClientCustomerId | 等於 於 |
依客戶識別碼搜尋客戶 ClientLink 物件。 |
| DirectManagingCustomerId | 等於 | 依代理商管理客戶標識符，搜尋客戶和廣告客戶帳戶 ClientLink 物件。 如果其他客戶也連結至客戶客戶，結果將不會包含這些客戶端連結。 |
| ManagingCustomerId | 等於 | 依代理商管理客戶標識碼搜尋廣告客戶帳戶 ClientLink 物件。 如果其他客戶也連結到用戶端廣告客戶帳戶，結果將會包含這些客戶端連結。 這個述詞值已被取代為 DirectManagingCustomerId 述詞。 |
請注意 SearchClientLinks 的下列述詞規則。
- 您不能同時包含 DirectManagingCustomerId 和 ManagingCustomerId。
- 您不能同時包含 ClientAccountId 和 ClientCustomerId。
- 如果您在相同的服務呼叫中同時包含 ClientAccountId 和 ManagingCustomerId 述詞，則會忽略 ManagingCustomerId。
- 如果您在同一個服務呼叫中同時包含 ClientCustomerId 和 DirectManagingCustomerId 述詞，結果只會包含符合這兩個述詞條件的客戶端連結。
- 如果您在同一個服務呼叫中同時包含 ClientAccountId 和 DirectManagingCustomerId 述詞，結果只會包含符合這兩個述詞條件的廣告客戶端連結。
SearchCustomers 述詞
若為 SearchCustomers 服務作業，以下是 Predicate 對象支援的 Field 元素和 Operator 元素。
| 欄位 | 運算子 | 描述 |
|---|---|---|
| AccountId | 等於 | 使用此欄位來搜尋 MarketplaceAccount 的 Id 元素。 |
| AccountName | 包含 等於 |
使用此欄位來搜尋 MarketplaceAccount 的 Name 元素。 |
| AccountNumber | 包含 等於 |
使用此欄位來搜尋 [MarketplaceAccount] 的 Number 元素。 |
| ApplicationScope | 等於 | 僅限內部使用。 |
| CreatedDate | GreaterThanEquals LessThanEquals |
使用此欄位來搜尋客戶建立或註冊的日期。 日期會儲存在國際標準時間 (UTC) 。 只有指定字串的月、日和年用於搜尋。 如果您指定日期的小時、分鐘和秒，則會忽略它們。 如需日期和時間格式的相關信息，請參閱 基本 XML 數據類型中的 dateTime 專案。 |
| CustomerId | 等於 於 |
使用此欄位來搜尋 Customer 的 Id 元素。 |
| CustomerName | 包含 等於 |
使用此欄位來搜尋 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
Namespace： https://bingads.microsoft.com/Customer/v13/Entities
消費者
SearchAccounts
SearchClientLinks
SearchCustomers
SearchUserInvitations