Compartilhar via

Objeto de Dados CustomerRole - Gestão de Clientes

  • Artigo

Define os direitos de acesso da conta para uma pessoa que age em nome de um cliente específico.

Uma pessoa pode utilizar as mesmas credenciais de início de sessão para aceder a contas em vários clientes e podem ser devolvidos vários objetos CustomerRole para uma pessoa através da operação GetUser . Por exemplo, dois objetos CustomerRole são devolvidos se user@contoso.com tiverem sido convidados para o Cliente 123 e o utilizador também tiver acesso para gerir contas associadas em Cliente 234.

Individualmente, um utilizador tem a mesma função nos CustomerId, AccountIds e LinkedAccountIds para um determinado CustomerRole; no entanto, se um utilizador tiver várias funções de cliente, as permissões efetivas dependem do conjunto completo de CustomerRoles devolvido pelo GetUser. São fornecidos vários exemplos abaixo.

Sugestão

Veja o Guia de Permissões de Utilizador e Hierchy da Conta para obter uma descrição geral das funções dos clientes com exemplos.

Sintaxe

<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>

Elementos

O objeto CustomerRole tem os seguintes elementos: AccountIds, CustomerId, CustomerLinkPermission, LinkedAccountIds, RoleId.

Elemento Descrição Tipo de Dados
AccountIds A lista de contas às quais o utilizador pode aceder no cliente.

Se o utilizador tiver o nível de acesso CID, os AccountIDs não serão devolvidos . Para acesso ao nível da conta, os AccountIDs serão devolvidos no objeto CustomerRole da API GetUser.		 matriz longa
CustomerId O identificador do cliente onde o utilizador se inscreveu ou tem alguma relação de hierarquia de conta . long
CustomerLinkPermission Determina se o acesso do utilizador às contas é restringido pela hierarquia do cliente, ou seja, pela ligação do cliente ao nível do cliente.

Os valores possíveis incluem Administrativo, Standard e LinkedEntityOnly. Também é possível que este campo possa ser nulo ou estar vazio.

Se este campo for nulo ou estiver vazio, o utilizador é inscrito diretamente no CustomerId.

Se este campo estiver definido como "Administrativo", o utilizador tem acesso ao CustomerId através de uma ligação Cliente administrativo.

Se este campo estiver definido como "Standard", o utilizador tem acesso ao CustomerId através de uma ligação de cliente Standard.

Se este campo estiver definido como "LinkedEntityOnly", o utilizador é inscrito diretamente no CustomerId , mas não pode aceder às respetivas contas de anunciante. O CustomerId faz parte de uma hierarquia de ligação de cliente através da qual o utilizador pode aceder a outros clientes abaixo da mesma.

Para obter mais informações, veja o Guia técnico das Funções de Utilizador .		 cadeia
LinkedAccountIds A lista de contas associadas às quais o utilizador pode aceder através do CustomerId como uma agência em nome de outro cliente.

Se este elemento for nulo, o utilizador não tem acesso a contas de anunciantes associadas individualmente através do CustomerId. O utilizador poderá ter acesso a contas de anunciantes noutros clientes associados, por isso certifique-se de que tem em conta todos os CustomerRolesdevolvidos pelo GetUser.

Tenha em atenção que as contas criadas como agregador através de SignupCustomer também serão devolvidas neste elemento. Pode eliminar contas agregadas através de DeleteAccount, mas não pode desassociá-las através de UpdateClientLinks. Chame a operação SearchClientLinks para ajudar a determinar que contas podem ser desassociadas.		 matriz longa
RoleId A função que o utilizador tem ao aceder às contas do anunciante através do CustomerId.

Os valores possíveis incluem o seguinte:
16 - O utilizador tem a função Gestor de Campanha do Anunciante .
33 - O utilizador tem a função Agregador .
41 - O utilizador tem a função Super Administração.
100 - O utilizador tem a função Visualizador .
203 - O utilizador tem a função Utilizador Padrão .

Para obter mais informações, veja o Guia técnico das Funções de Utilizador .		 int

Requisitos

Serviço: CustomerManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/Customer/v13/Entities

Utilizado Por

GetUser