Compartir a través de

Objeto de datos CustomerRole: Administración de clientes

  • Artículo

Define los derechos de acceso a la cuenta de una persona que actúa en nombre de un cliente específico.

Una persona puede usar las mismas credenciales de inicio de sesión para acceder a cuentas de varios clientes y se pueden devolver varios objetos CustomerRole para una persona mediante la operación GetUser . Por ejemplo, se devuelven dos objetos CustomerRole si user@contoso.com se invitó al cliente 123 y el usuario también tiene acceso para administrar cuentas vinculadas en Customer 234.

Tomado de forma individual, un usuario tiene el mismo rol en customerid, accountids y linkedaccountids para un determinado CustomerRole; sin embargo, si un usuario tiene varios roles de cliente, los permisos efectivos dependen del conjunto completo de CustomerRoles devuelto por GetUser. A continuación se proporcionan varios ejemplos.

Sugerencia

Consulte la guía Account Hierchy and User Permissions (Permisos de usuario y hierchy de cuenta) para obtener información general sobre los roles de cliente con ejemplos.

<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

El objeto CustomerRole tiene los siguientes elementos: AccountIds, CustomerId, CustomerLinkPermission, LinkedAccountIds, RoleId.

Elemento Descripción Tipo de datos
AccountIds Lista de cuentas a las que el usuario puede acceder en el cliente.

Si el usuario tiene el nivel de acceso CID, no se devolverán los identificadores de cuenta . Para el acceso a nivel de cuenta, los Identificadores de cuenta se devolverán en el objeto CustomerRole de la API GetUser.		 matriz larga
CustomerId Identificador del cliente en el que el usuario se ha registrado o tiene alguna relación de jerarquía de cuentas . largo
CustomerLinkPermission Determina si el acceso del usuario a las cuentas está restringido por la jerarquía de clientes, es decir, la vinculación de clientes de nivel de cliente.

Los valores posibles incluyen Administrative, Standard y LinkedEntityOnly. También es posible que este campo pueda ser nulo o vacío.

Si este campo es nulo o está vacío, el usuario se registra directamente en customerid.

Si este campo se establece en "Administrativo", el usuario tiene acceso al CustomerId a través de un vínculo cliente administrativo.

Si este campo se establece en "Standard", el usuario tiene acceso al CustomerId a través de un vínculo de cliente Standard.

Si este campo está establecido en "LinkedEntityOnly", el usuario se registra directamente en el CustomerId , pero no puede acceder a sus cuentas de anunciante. CustomerId forma parte de una jerarquía de vínculos de cliente por la que el usuario puede acceder a otros clientes debajo de ella.

Para obtener más información, consulte la guía técnica Roles de usuario .		 string
LinkedAccountIds Lista de cuentas vinculadas a las que el usuario puede acceder a través del CustomerId como una agencia en nombre de otro cliente.

Si este elemento es nulo, el usuario no tiene acceso a cuentas de anunciante vinculadas individualmente a través del CustomerId. Es posible que el usuario tenga acceso a cuentas de anunciante en otros clientes vinculados, así que asegúrese de tener en cuenta todos los CustomerRoles devueltos por GetUser.

Tenga en cuenta que las cuentas creadas como agregador a través de SignupCustomer también se devolverán en este elemento. Puede eliminar cuentas de agregado a través de DeleteAccount, pero no puede desvincularlas a través de UpdateClientLinks. Llame a la operación SearchClientLinks para ayudar a determinar qué cuentas se pueden desvincular.		 matriz larga
RoleId El rol que tiene el usuario al acceder a las cuentas de anunciante a través del CustomerId.

Entre los valores posibles se encuentran:
16 - El usuario tiene el rol de Administrador de campañas de anunciantes .
33: el usuario tiene el rol agregador .
41 - El usuario tiene el rol Super Administración.
100: el usuario tiene el rol Visor .
203: el usuario tiene el rol de usuario Standard.

Para obtener más información, consulte la guía técnica Roles de usuario .		 int

Requisitos

Servicio: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities

Usado por

GetUser