Objet de données CustomerRole - Gestion des clients
Définit les droits d’accès au compte pour une personne qui agit pour le compte d’un client spécifique.
Une personne peut utiliser les mêmes informations d’identification de connexion pour accéder aux comptes de plusieurs clients, et plusieurs objets CustomerRole peuvent être retournés pour une seule personne via l’opération GetUser . Par exemple, deux objets CustomerRole sont retournés si user@contoso.com a été invité à Customer 123 et que l’utilisateur a également accès à la gestion des comptes liés sous Customer 234.
Pris individuellement, un utilisateur a le même rôle sur les CustomerId, AccountIds et LinkedAccountIds pour un CustomerRole donné ; Toutefois, si un utilisateur a plusieurs rôles de client, les autorisations effectives dépendent de l’ensemble complet de CustomerRoles retournés par GetUser. Plusieurs exemples sont fournis ci-dessous.
Conseil
Pour obtenir une vue d’ensemble des rôles des clients avec des exemples, consultez le Guide des autorisations de compte et d’autorisations utilisateur.
Syntaxe
<xs:complexType name="CustomerRole" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="RoleId" type="xs:int" />
<xs:element minOccurs="0" name="CustomerId" type="xs:long" />
<xs:element xmlns:q7="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="AccountIds" nillable="true" type="q7:ArrayOflong" />
<xs:element xmlns:q8="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="LinkedAccountIds" nillable="true" type="q8:ArrayOflong" />
<xs:element minOccurs="0" name="CustomerLinkPermission" nillable="true" type="xs:string" />
</xs:sequence>
</xs:complexType>
Éléments
L’objet CustomerRole contient les éléments suivants : AccountIds, CustomerId, CustomerLinkPermission, LinkedAccountIds, RoleId.
| Élément | Description | Type de données |
|---|---|---|
| Id de compte | Liste des comptes auxquels l’utilisateur peut accéder dans le client. Si l’utilisateur a un niveau d’accès CID, les ID de compte ne sont pas retournés. Pour l’accès au niveau du compte, les Id de compte sont retournés dans l’objet CustomerRole de l’API GetUser. |
tableau long |
| Customerid | Identificateur du client dans lequel l’utilisateur s’est inscrit ou a une relation de hiérarchie de compte . | Long |
| 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. Les valeurs possibles sont Administrative, Standard et LinkedEntityOnly. Il est également possible que ce champ soit nul ou vide. Si ce champ est nul ou vide, l’utilisateur est inscrit directement sur CustomerId. Si ce champ est défini sur « Administratif », l’utilisateur a accès au CustomerId via un lien Client administratif. Si ce champ est défini sur « Standard », l’utilisateur a accès au CustomerId via un lien client Standard. Si ce champ est défini sur « LinkedEntityOnly », l’utilisateur est inscrit directement sur CustomerId , mais ne peut pas accéder à ses comptes d’annonceur. CustomerId 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 . |
chaîne |
| LinkedAccountIds | Liste des comptes liés auxquels l’utilisateur peut accéder via customerId en tant qu’agence pour le compte d’un autre client. Si cet élément est nul, l’utilisateur n’a pas accès aux comptes d’annonceurs liés individuellement via le CustomerId. L’utilisateur peut avoir accès aux comptes d’annonceur dans d’autres clients liés. Veillez donc à prendre en compte tous les rôles client retournés par GetUser. Notez que les comptes créés en tant qu’agrégateur via SignupCustomer seront également retournés dans cet élément. Vous pouvez supprimer des comptes d’agrégation via DeleteAccount, mais vous ne pouvez pas les dissocier via UpdateClientLinks. Appelez l’opération SearchClientLinks pour déterminer quels comptes peuvent être dissociés. |
tableau long |
| RoleId | Rôle dont dispose l’utilisateur lors de l’accès aux comptes d’annonceur par le biais du CustomerId. Les valeurs possibles sont les suivantes : 16 - L’utilisateur a le rôle Gestionnaire de campagne de l’annonceur . 33 - L’utilisateur a le rôle Agrégateur . 41 - L’utilisateur a le rôle Super Administration. 100 - L’utilisateur a le rôle Visionneuse . 203 - L’utilisateur a le rôle Utilisateur standard . Pour plus d’informations, consultez le guide technique rôles d’utilisateur . |
int |
Conditions requises
Service : CustomerManagementService.svc v13
Noms: https://bingads.microsoft.com/Customer/v13/Entities