Training
Module
Search and filter knowledge articles by using Dynamics 365 Customer Service - Training
Learn how to search and filter knowledge articles by using Dynamics 365 Customer Service.
This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Defines a predicate for the list of entities requested using one of the search operations, for example SearchAccounts, SearchClientLinks, SearchCustomers, or 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>
The Predicate object has the following elements: Field, Operator, Value.
Element | Description | Data Type |
---|---|---|
Field | The name of the element for the object you are searching. For possible values, see the Remarks below. |
string |
Operator | Defines the relationship between the field and the value. | PredicateOperator |
Value | The string to search in the specified field. The length of this string must be four or greater, unless the field is set to MarketCountry or MarketLanguage. |
string |
The supported Field element and Operator elements of a Predicate object for each service operation are provided in detail below.
For the SearchAccounts service operation, the following are supported Field element and Operator elements of a Predicate object.
Field | Operator | Description |
---|---|---|
AccountId | Equals In |
Use this field to search the Id element of the AdvertiserAccount. |
AccountLifeCycleStatus | Equals | Use this field to search the AccountLifeCycleStatus element of the AdvertiserAccount. Possible values include "Active", "Draft", "Inactive", "Pause", "Pending", and "Suspended". - When you request accounts by "Active" status, the operation returns accounts with AccountLifeCycleStatus set to Active. The operation also returns accounts with AccountLifeCycleStatus set to Pause, where the PauseReason value is 2 (the billing service paused the account). - When you request accounts by "Pause" status, the operation returns accounts with AccountLifeCycleStatus set to Pause, where the PauseReason value is 1 (the user paused the account) or 4 (the user and billing service paused the account). |
AccountName | Contains Equals |
Use this field to search the Name element of the AdvertiserAccount. |
AccountNumber | Contains Equals In |
Use this field to search the Number element of the AdvertiserAccount. |
CustomerId | Equals | Use this field to search the Id element of the Customer. |
UserId | Equals | Use this field to search the UserId element of the User. |
For the SearchClientLinks service operation, the following are supported Field element and Operator elements of a Predicate object.
Field | Operator | Description |
---|---|---|
ClientAccountId | Equals In |
Search for advertiser account ClientLink objects by the client advertiser account identifier. |
ClientCustomerId | Equals In |
Search for customer ClientLink objects by the client customer identifier. |
DirectManagingCustomerId | Equals | Search for both customer and advertiser account ClientLink objects by the agency's managing customer identifier. If other customers also link to the client customer, the results will not include those client links. |
ManagingCustomerId | Equals | Search for advertiser account ClientLink objects by the agency's managing customer identifier. If other customers also link to the client advertiser account, the results will include those client links. This predicate value is deprecated in favor of the DirectManagingCustomerId predicate. |
Please note the following predicate rules for SearchClientLinks.
For the SearchCustomers service operation, the following are supported Field element and Operator elements of a Predicate object.
Field | Operator | Description |
---|---|---|
AccountId | Equals | Use this field to search the Id element of the AdvertiserAccount. |
AccountName | Contains Equals |
Use this field to search the Name element of the AdvertiserAccount. |
AccountNumber | Contains Equals |
Use this field to search the Number element of the AdvertiserAccount. |
ApplicationScope | Equals | For internal use only. |
CreatedDate | GreaterThanEquals LessThanEquals |
Use this field to search the date when the customer was created or signed up. The date is stored in Coordinated Universal Time (UTC). Only the month, day, and year of the specified string are used for search. If you specify the hour, minutes, and seconds of a date they will be ignored. For information about the format of the date and time, see the dateTime entry in Primitive XML Data Types. |
CustomerId | Equals In |
Use this field to search the Id element of the Customer. |
CustomerName | Contains Equals |
Use this field to search the Name element of the Customer. |
MarketCountry | Equals | Use this field to search the MarketCountry element of the Customer. The MarketCountry and MarketLanguage predicate fields are not required; however, if either is specified then both are required. |
MarketLanguage | Equals | Use this field to search the MarketLanguage element of the Customer. The MarketCountry and MarketLanguage predicate fields are not required; however, if either is specified then both are required. |
UserName | Equals | Use this field to search the UserName element of the User. |
For the SearchUserInvitations service operation, the following are supported Field element and Operator elements of a Predicate object.
Field | Operator | Description |
---|---|---|
CustomerId | Equals | Use this field to search the CustomerId element of the UserInvitation. |
Service: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities
SearchAccounts
SearchClientLinks
SearchCustomers
SearchUserInvitations
Training
Module
Search and filter knowledge articles by using Dynamics 365 Customer Service - Training
Learn how to search and filter knowledge articles by using Dynamics 365 Customer Service.