Partager via

Objet de données client - Gestion des clients

  • Article

Définit un objet client qui contient un ou plusieurs comptes Microsoft Advertising.

Syntaxe

<xs:complexType name="Customer" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="CustomerFinancialStatus" nillable="true" type="tns:CustomerFinancialStatus" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Industry" nillable="true" type="tns:Industry" />
    <xs:element minOccurs="0" name="LastModifiedByUserId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="LastModifiedTime" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="MarketCountry" nillable="true" type="xs:string" />
    <xs:element xmlns:q4="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q4:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="MarketLanguage" nillable="true" type="tns:LanguageType" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ServiceLevel" nillable="true" type="tns:ServiceLevel" />
    <xs:element minOccurs="0" name="CustomerLifeCycleStatus" nillable="true" type="tns:CustomerLifeCycleStatus" />
    <xs:element minOccurs="0" name="TimeStamp" nillable="true" type="xs:base64Binary" />
    <xs:element minOccurs="0" name="Number" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CustomerAddress" nillable="true" type="tns:Address" />
  </xs:sequence>
</xs:complexType>

Éléments

L’objet Customer contient les éléments suivants : CustomerAddress, CustomerFinancialStatus, CustomerLifeCycleStatus, ForwardCompatibilityMap, Id, Industry, LastModifiedByUserId, LastModifiedTime, MarketCountry, MarketLanguage, Name, Number, ServiceLevel, TimeStamp.

Élément Description Type de données
CustomerAddress Adresse professionnelle du client.

Cette propriété n’est pas utilisée par Microsoft Advertising et vous devez définir l’adresse professionnelle du compte à la place.

Ajouter: Optionnel
Mettre à jour: Optionnel		 Adresse
CustomerFinancialStatus Status financière du client. Par exemple, le status indique si le client est en règle ou si un ou plusieurs des comptes sont impayés.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 CustomerFinancialStatus
CustomerLifeCycleStatus Status du client. Lorsque vous créez le client, le status est défini sur Actif. Vous ne pouvez pas modifier le status.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 CustomerLifeCycleStatus
ForwardCompatibilityMap Liste des chaînes de clé et de valeur pour la compatibilité avant afin d’éviter les changements cassants lorsque de nouveaux éléments sont ajoutés dans la version actuelle de l’API.

Les modifications de compatibilité avant seront notées ici dans les versions ultérieures. Il n’existe actuellement aucune modification de compatibilité avant pour cet objet.		 Tableau KeyValuePairOfstringstring
ID Identificateur du client généré par le système.

Utilisez cet identificateur avec les demandes d’opération qui nécessitent un élément d’en-tête SOAP CustomerId .

Ajouter: En lecture seule
Mettre à jour: Obligatoire		 Long
Secteur d’activité Le principal segment d’activité du client, par exemple l’automobile, l’alimentation ou le divertissement.

Ajouter: Obligatoire
Mettre à jour: Obligatoire		 Secteur d’activité
LastModifiedByUserId Identificateur du dernier utilisateur à mettre à jour les informations du client.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 Long
LastModifiedTime Date et heure de la dernière mise à jour des informations client. La valeur est exprimée au format UTC (temps universel coordonné).

La valeur de date et d’heure reflète la date et l’heure sur le serveur, et non le client. 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.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 dateTime
MarketCountry Pays principal dans lequel le client opère. Pour obtenir la liste des valeurs de code du pays du marché client, consultez Langue du produit.

Ajouter: Obligatoire
Mettre à jour: En lecture seule		 chaîne
MarketLanguage Langue principale utilisée par le client. La langue du marché de votre client détermine la langue de l’interface Microsoft Advertising. Pour obtenir la liste des valeurs de code de langue du marché client, consultez Langue du produit.

Ajouter: Obligatoire
Mettre à jour: En lecture seule		 LanguageType
Nom Nom du client.

Le nom peut contenir un maximum de 90 caractères.

Ajouter: Obligatoire
Mettre à jour: Obligatoire		 chaîne
Nombre Numéro de client généré par le système utilisé dans l’application web Microsoft Advertising.

Le numéro de client a la forme xxxxxxxxxxxx, où xxxxxxxxxx est une série de dix caractères alphanumériques.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 chaîne
ServiceLevel À usage interne uniquement. Si cet élément est défini lors de l’appel de SignupCustomer , une erreur est retournée. Si cet élément est défini lors de l’appel de UpdateCustomer , l’élément est ignoré.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 ServiceLevel
Timestamp Valeur d’horodatage que le système utilise en interne pour rapprocher les mises à jour lorsque vous appelez les opérations UpdateCustomer et DeleteCustomer .

Ajouter: En lecture seule
Mettre à jour: Obligatoire		 base64Binary

Configuration requise

Service : CustomerManagementService.svc v13
Noms: https://bingads.microsoft.com/Customer/v13/Entities

Utilisé par

GetCustomer
SearchCustomers
SignupCustomer
UpdateCustomer