Objet de données de prédicat - Gestion des clients
Définit un prédicat pour la liste des entités demandées à l’aide de l’une des opérations de recherche, par exemple SearchAccounts, SearchClientLinks, SearchCustomers ou SearchUserInvitations.
Syntaxe
<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>
Éléments
L’objet Predicate a les éléments suivants : Field, Operator, Value.
| Élément | Description | Type de données |
|---|---|---|
| Champ | Nom de l’élément pour l’objet que vous recherchez. Pour connaître les valeurs possibles, consultez les remarques ci-dessous. |
chaîne |
| Opérateur | Définit la relation entre le champ et la valeur. | PredicateOperator |
| Valeur | Chaîne à rechercher dans le champ spécifié. La longueur de cette chaîne doit être supérieure ou égale à quatre, sauf si le champ est défini sur MarketCountry ou MarketLanguage. |
chaîne |
Remarques
Les éléments Field et Operator pris en charge d’un objet Predicate pour chaque opération de service sont fournis en détail ci-dessous.
Prédicats SearchAccounts
Pour l’opération de service SearchAccounts , les éléments Field et Operator pris en charge d’un objet Predicate sont les suivants.
| Champ | Opérateur | Description |
|---|---|---|
| AccountId | Égal à Dans le paramètre |
Utilisez ce champ pour rechercher l’élément Id de l’objet AdvertiserAccount. |
| AccountLifeCycleStatus | Égal à | Utilisez ce champ pour rechercher l’élément AccountLifeCycleStatus de l’objet AdvertiserAccount. Les valeurs possibles sont « Active », « Draft », « Inactive », « Pause », « Pending » et « Suspended ». - Lorsque vous demandez des comptes par « Active » status, l’opération retourne les comptes avec AccountLifeCycleStatus défini sur Actif. L’opération retourne également les comptes avec AccountLifeCycleStatus défini sur Pause, où la valeur PauseReason est 2 (le service de facturation a suspendu le compte). - Lorsque vous demandez des comptes en « Pause » status, l’opération retourne les comptes avec AccountLifeCycleStatus défini sur Pause, où la valeur PauseReason est 1 (l’utilisateur a suspendu le compte) ou 4 (l’utilisateur et le service de facturation ont suspendu le compte). |
| AccountName | Contains Égal à |
Utilisez ce champ pour rechercher l’élément Name de l’objet AdvertiserAccount. |
| Numéro de compte | Contains Égal à Dans le paramètre |
Utilisez ce champ pour rechercher l’élément Number de l’objet AdvertiserAccount. |
| Customerid | Égal à | Utilisez ce champ pour rechercher l’élément Id du client. |
| UserId | Égal à | Utilisez ce champ pour rechercher l’élément UserId de l’utilisateur. |
Prédicats SearchClientLinks
Pour l’opération de service SearchClientLinks , les éléments Field et Operator pris en charge d’un objet Predicate sont les suivants.
| Champ | Opérateur | Description |
|---|---|---|
| ClientAccountId | Égal à Dans le paramètre |
Recherchez les objets ClientLink du compte d’annonceur par l’identificateur de compte de l’annonceur client. |
| ClientCustomerId | Égal à Dans le paramètre |
Recherchez les objets ClientLink client par l’identificateur du client. |
| DirectManagingCustomerId | Égal à | Recherchez les objets ClientLink du compte client et de l’annonceur par l’identificateur client de gestion de l’agence. Si d’autres clients lient également au client client, les résultats n’incluent pas ces liens client. |
| ManagingCustomerId | Égal à | Recherchez les objets ClientLink du compte d’annonceur par l’identificateur client de gestion de l’agence. Si d’autres clients sont également liés au compte d’annonceur client, les résultats incluent ces liens client. Cette valeur de prédicat est déconseillée en faveur du prédicat DirectManagingCustomerId. |
Notez les règles de prédicat suivantes pour SearchClientLinks.
- Vous ne pouvez pas inclure à la fois DirectManagingCustomerId et ManagingCustomerId.
- Vous ne pouvez pas inclure à la fois ClientAccountId et ClientCustomerId.
- Si vous incluez les prédicats ClientAccountId et ManagingCustomerId dans le même appel de service, managingCustomerId est ignoré.
- Si vous incluez à la fois les prédicats ClientCustomerId et DirectManagingCustomerId dans le même appel de service, les résultats incluent uniquement les liens client client qui répondent aux deux conditions de prédicat.
- Si vous incluez à la fois les prédicats ClientAccountId et DirectManagingCustomerId dans le même appel de service, les résultats incluent uniquement les liens client de compte d’annonceur qui répondent aux deux conditions de prédicat.
Prédicats SearchCustomers
Pour l’opération de service SearchCustomers , les éléments Field et Operator pris en charge d’un objet Predicate sont les suivants.
| Champ | Opérateur | Description |
|---|---|---|
| AccountId | Égal à | Utilisez ce champ pour rechercher l’élément Id de l’objet AdvertiserAccount. |
| AccountName | Contains Égal à |
Utilisez ce champ pour rechercher l’élément Name de l’objet AdvertiserAccount. |
| Numéro de compte | Contains Égal à |
Utilisez ce champ pour rechercher l’élément Number de l’objet AdvertiserAccount. |
| ApplicationScope | Égal à | À usage interne uniquement. |
| CreatedDate | GreaterThanEquals LessThanEquals |
Utilisez ce champ pour rechercher la date à laquelle le client a été créé ou inscrit. La date est stockée en temps universel coordonné (UTC). Seuls le mois, le jour et l’année de la chaîne spécifiée sont utilisés pour la recherche. Si vous spécifiez l’heure, les minutes et les secondes d’une date, ils seront ignorés. Pour plus d’informations sur le format de la date et de l’heure, consultez l’entrée dateTime dans Types de données XML primitifs. |
| Customerid | Égal à Dans le paramètre |
Utilisez ce champ pour rechercher l’élément Id du client. |
| CustomerName | Contains Égal à |
Utilisez ce champ pour rechercher l’élément Name du client. |
| MarketCountry | Égal à | Utilisez ce champ pour rechercher l’élément MarketCountry du client. Les champs de prédicat MarketCountry et MarketLanguage ne sont pas obligatoires. toutefois, si l’une des deux est spécifiée, les deux sont obligatoires. |
| MarketLanguage | Égal à | Utilisez ce champ pour rechercher l’élément MarketLanguage du client. Les champs de prédicat MarketCountry et MarketLanguage ne sont pas obligatoires. toutefois, si l’une des deux est spécifiée, les deux sont obligatoires. |
| UserName | Égal à | Utilisez ce champ pour rechercher l’élément UserName de l’utilisateur. |
Prédicats SearchUserInvitations
Pour l’opération de service SearchUserInvitations , les éléments Field et Operator pris en charge d’un objet Predicate sont les suivants.
| Champ | Opérateur | Description |
|---|---|---|
| Customerid | Égal à | Utilisez ce champ pour rechercher l’élément CustomerId de userInvitation. |
Configuration requise
Service : CustomerManagementService.svc v13
Noms: https://bingads.microsoft.com/Customer/v13/Entities
Utilisé par
SearchAccounts
SearchClientLinks
SearchCustomers
SearchUserInvitations