Partager via

Objet de données ClientLink - Gestion des clients

  • Article

Définit un objet de lien client. L’acceptation d’une invitation de lien client permet à une agence de gérer les comptes annonceurs clients correspondants. Pour envoyer une invitation à gérer un compte d’annonceur client, appelez l’opération AddClientLinks et spécifiez un lien client par compte à gérer.

Un lien client n’a pas d’identificateur système public. Vous pouvez identifier des liens client distincts par ClientEntityId et ManagingCustomerId.

Conseil

Pour plus d’informations sur le cycle de vie des liaisons clientes, consultez le guide technique de la hiérarchie des comptes. Pour plus d’informations sur la façon de devenir une agence, consultez ressources pour les partenaires de l’agence. Pour plus d’informations du point de vue d’un client, consultez Guide pratique pour qu’une agence gère votre compte Microsoft Advertising.

Notes

Les clients de l’agence dans le pilote Créer des comptes pour le compte du client (GetCustomerPilotFeatures retourne 793) peuvent également établir des liens client au niveau du compte via l’opération de service SignupCustomer . Pour plus d’informations , consultez SignupCustomer .

Syntaxe

<xs:complexType name="ClientLink" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClientEntityId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ClientEntityNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClientEntityName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ManagingCustomerId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ManagingCustomerNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ManagingCustomerName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Note" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterEmail" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterPhone" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="IsBillToClient" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:ClientLinkStatus" />
    <xs:element minOccurs="0" name="SuppressNotification" type="xs:boolean" />
    <xs:element minOccurs="0" name="LastModifiedDateTime" type="xs:dateTime" />
    <xs:element minOccurs="0" name="LastModifiedByUserId" type="xs:long" />
    <xs:element minOccurs="0" name="Timestamp" nillable="true" type="xs:base64Binary" />
    <xs:element xmlns:q10="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q10:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="CustomerLinkPermission" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Éléments

L’objet ClientLink contient les éléments suivants : ClientEntityId, ClientEntityName, ClientEntityNumber, CustomerLinkPermission, ForwardCompatibilityMap, InviterEmail, InviteUrName, InvitePhone, IsBillToClient, LastModifiedByUserId, LastModifiedDateTime, ManagingCustomerId, ManagingCustomerName, ManagingCustomerNumber, Name, Note, StartDate, Status, SuppressNotification, Timestamp, Type.

Élément Description Type de données
ClientEntityId Identificateur du compte d’annonceur client ou du client client à gérer

L’élément Type détermine si le lien est vers un compte d’annonceur client ou un client client.

Ajouter: Obligatoire. ClientEntityId ou ClientEntityNumber est requis, mais la spécification des deux entraîne l’échec de l’opération.
Mettre à jour: En lecture seule et Obligatoire.		 long
ClientEntityName Nom du compte d’annonceur client ou du client client à gérer

L’élément Type détermine si le lien est vers un compte d’annonceur client ou un client client.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 chaîne
ClientEntityNumber Numéro du compte d’annonceur client ou du client client à gérer

L’élément Type détermine si le lien est vers un compte d’annonceur client ou un client client.

Ajouter: Obligatoire. ClientEntityId ou ClientEntityNumber est requis, mais la spécification des deux entraîne l’échec de l’opération.
Mettre à jour: En lecture seule et Obligatoire.		 chaîne
CustomerLinkPermission Détermine si l’accès de l’utilisateur aux comptes est limité par la hiérarchie des clients, c’est-à-dire la liaison cliente au niveau du client.

Cet élément s’applique uniquement si Type est défini sur CustomerLink. Dans ce cas, les valeurs possibles sont Administrative et Standard. Sinon, ce champ doit être nul ou vide.

Si ce champ est défini sur « Administrative », l’utilisateur a accès à ClientEntityId via un lien Client Administratif.

Si ce champ est défini sur « Standard », l’utilisateur a accès à ClientEntityId via un lien client Standard.

ClientEntityId fait partie d’une hiérarchie de liaison client dans laquelle l’utilisateur peut accéder à d’autres clients en dessous.

Pour plus d’informations, consultez le guide technique rôles d’utilisateur .

Ajouter: Optionnel
Mettre à jour: En lecture seule		 chaîne
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 l’objet ClientLink .		 Tableau KeyValuePairOfstringstring
InviteurEmail E-mail de l’utilisateur qui a créé la demande de lien client.

Cette valeur n’a pas besoin d’être identique à celle de l’e-mail déjà stocké dans Microsoft Advertising pour l’utilisateur authentifié actuel et n’est pas utilisée pour modifier l’e-mail déjà stocké dans Microsoft Advertising.

S’il n’est pas spécifié, le service définit cette valeur sur l’e-mail déjà stocké dans Microsoft Advertising pour l’utilisateur authentifié actuel.

Ajouter: Optionnel
Mettre à jour: En lecture seule		 chaîne
InviteurName Nom du client parent de l’utilisateur qui a créé la demande de lien client.

Cette valeur n’a pas besoin d’être identique au nom du client déjà stocké dans Microsoft Advertising et n’est pas utilisé pour modifier.

S’il n’est pas spécifié, le service définit cette valeur sur le nom du client parent déjà stocké dans Microsoft Advertising pour l’utilisateur authentifié actuel.

Ajouter: Optionnel
Mettre à jour: En lecture seule		 chaîne
InviteurPhone Numéro de téléphone de l’utilisateur qui a créé la demande de lien client.

Cette valeur n’a pas besoin d’être identique à celle du numéro de téléphone déjà stocké dans Microsoft Advertising pour l’utilisateur actuellement authentifié et n’est pas utilisée pour modifier le numéro de téléphone déjà stocké dans Microsoft Advertising.

S’il n’est pas spécifié, le service définit cette valeur sur le numéro de téléphone déjà stocké dans Microsoft Advertising pour l’utilisateur authentifié actuel.

Ajouter: Optionnel
Mettre à jour: En lecture seule		 chaîne
IsBillToClient Détermine si le propriétaire du compte d’annonceur client ou le client gérant est responsable des paiements de facturation.

Cet élément s’applique uniquement aux liens client de compte d’annonceur et ne s’applique pas aux liens client. Le compte de l’annonceur client doit être configuré pour la facturation après paiement. Les comptes prépayés ne sont pas pris en charge pour la gestion par les agences. Si la valeur est true, le client est responsable de la facturation. Si la valeur est false, le client gérant est responsable de la facturation.

Ajouter: Requis pour les liens de compte d’annonceur ; Non applicable aux liens client.
Mettre à jour: En lecture seule		 boolean
LastModifiedByUserId Identificateur du dernier utilisateur à mettre à jour les informations du lien client.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 long
LastModifiedDateTime Date et heure de la dernière mise à jour du lien 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
ManagingCustomerId Identificateur du client qui gère ou demande la gestion du compte d’annonceur client.

Ajouter: Obligatoire. ManagingCustomerId ou ManagingCustomerNumber est requis, mais la spécification des deux entraîne l’échec de l’opération.
Mettre à jour: Lecture seule et Obligatoire		 long
ManagingCustomerName Nom du client qui gère ou demande la gestion du compte d’annonceur client.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 chaîne
ManagingCustomerNumber Numéro du client qui gère ou demande la gestion du compte d’annonceur client.

Ajouter: Obligatoire. ManagingCustomerId ou ManagingCustomerNumber est requis, mais la spécification des deux entraîne l’échec de l’opération.
Mettre à jour: Lecture seule et Obligatoire		 chaîne
Nom Nom convivial qui peut être utilisé pour référencer ce lien client.

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

Un nom par défaut est fourni si aucun n’est spécifié. Le nom n’a pas besoin d’être unique par rapport à d’autres liens client pour l’utilisateur.

Ajouter: Optionnel
Mettre à jour: En lecture seule		 chaîne
Notes Message facultatif du demandeur fournissant le contexte et les détails de l’invitation de lien client.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 chaîne
StartDate Date à laquelle l’état est mis à jour. Pour une demande de lien acceptée, l’état passe à Actif à cette date, et pour une demande de dissociation, l’état passe à Inactif à cette date.

Si elle n’est pas spécifiée, cette valeur est définie sur la date et l’heure actuelles.

Ajouter: Optionnel
Mettre à jour: En lecture seule		 dateTime
Statut Détermine l’état du cycle de vie du lien client, par exemple si le lien client a été accepté ou refusé.

Lors de l’ajout d’un lien client, cet élément ne peut pas être spécifié et le service définit l’état effectif sur LinkPending.

Ajouter: En lecture seule
Mettre à jour: Obligatoire		 ClientLinkStatus
SuppressNotification Détermine s’il faut envoyer ou non une notification par e-mail de l’invitation de lien client à l’utilisateur principal du compte annonceur client.

Si la valeur est true, le client ne reçoit pas d’e-mail et, dans le cas contraire, étant donné que la valeur par défaut est false, le client reçoit une notification par e-mail.

Ajouter: Optionnel
Mettre à jour: En lecture seule		 boolean
Timestamp Réservé à une utilisation future. base64Binary
Type Détermine si le lien est vers un compte d’annonceur client ou un client client.

Les valeurs possibles sont AccountLink et CustomerLink. Si cet élément est vide ou défini sur AccountLink, ClientEntityId, ClientEntityName et ClientEntityNumber représentent un compte annonceur client. Si cet élément est défini sur CustomerLink, ClientEntityId, ClientEntityName et ClientEntityNumber représentent un client client.

Ajouter: Optionnel. Si cet élément n’est pas défini, le service tente de créer un lien client de compte d’annonceur.
Mettre à jour: En lecture seule		 chaîne

Configuration requise

Service : CustomerManagementService.svc v13
Espace de noms: https://bingads.microsoft.com/Customer/v13/Entities

Utilisé par

AddClientLinks
SearchClientLinks
UpdateClientLinks