Objeto de datos UserInvitation: Administración de clientes

Define una invitación para que un usuario se registre en Microsoft Advertising. La invitación limita el acceso y los permisos de la cuenta.

Importante

Cuando se envía la invitación, puede optar por limitar el acceso del usuario a un subconjunto de cuentas de anunciantes que están directamente bajo su cliente. Si se configura una jerarquía de agencia (ahora o en el futuro) en el cliente donde se invita al usuario y si no limita el acceso a cuentas específicas, el usuario tendrá acceso a todas las cuentas de la jerarquía.

Es posible enviar varias invitaciones pendientes a la misma dirección de correo electrónico, que aún no han expirado. También es posible que esas invitaciones hayan especificado diferentes roles de usuario, por ejemplo, si envió una invitación con un rol de usuario incorrecto y, a continuación, envió una segunda invitación con el rol de usuario correcto. El destinatario puede aceptar cualquiera de las invitaciones y puede registrarse con credenciales distintas de la dirección de correo electrónico de invitación. Los usuarios de Microsoft Advertising pueden aceptar invitaciones a varios clientes con las mismas credenciales. Para obtener más información, consulte la Guía técnica de credenciales de varios usuarios .

Puede buscar invitaciones pendientes por identificador de invitación y averiguar si la invitación se ha aceptado o no o ha expirado. La operación SearchUserInvitations devuelve todas las invitaciones pendientes, independientemente de si han expirado o no. Las invitaciones aceptadas no se incluyen en la respuesta SearchUserInvitations .

Una vez aceptada la invitación, puede llamar a GetUsersInfo y GetUser para acceder a los detalles del usuario de Microsoft Advertising. Sin embargo, dado que un destinatario puede aceptar la invitación y registrarse con credenciales que difieren de la dirección de correo electrónico de invitación, no puede determinar con certeza la asignación de un objeto UserInvitation a un objeto User o UserInfo . Con el identificador de usuario devuelto por GetUsersInfo o GetUser, puede llamar a DeleteUser para quitar el usuario según sea necesario. Bing Ads API no admite ninguna operación para eliminar invitaciones de usuario pendientes. Después de invitar a un usuario, la única manera de cancelar la invitación es a través de la aplicación web microsoft Advertising. Puede encontrar invitaciones pendientes y aceptadas en la sección Usuarios de Cuentas & Facturación.

Sintaxis

<xs:complexType name="UserInvitation" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Id" type="xs:long" />
    <xs:element minOccurs="0" name="FirstName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="LastName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Email" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CustomerId" type="xs:long" />
    <xs:element minOccurs="0" name="RoleId" type="xs:int" />
    <xs:element xmlns:q5="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="AccountIds" nillable="true" type="q5:ArrayOflong" />
    <xs:element minOccurs="0" name="ExpirationDate" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Lcid" type="tns:LCID" />
  </xs:sequence>
</xs:complexType>

Elementos

El objeto UserInvitation tiene los siguientes elementos: AccountIds, CustomerId, Email, ExpirationDate, FirstName, Id, LastName, Lcid, RoleId.

Elemento Descripción Tipo de datos
AccountIds Matriz de identificadores de las cuentas que el usuario puede administrar. Para especificar que el usuario puede administrar todas las cuentas actuales y futuras del cliente al que pertenece el usuario, establezca en NULL.

Los usuarios con roles de nivel de cuenta, como El administrador de campañas de anunciantes, pueden estar restringidos a cuentas específicas. Los usuarios con roles de nivel de cliente como Super Administración pueden acceder a todas las cuentas del cliente del usuario y su acceso no se puede restringir a cuentas específicas.

Al intentar restringir los roles de usuario de nivel de cliente, por ejemplo, al intentar restringir un super Administración a cuentas específicas, la operación no producirá un error y se concederá acceso al usuario para todas las cuentas del cliente especificado.

Enviar: Opcional
Registro: Opcional
matriz larga
CustomerId Identificador del cliente al que se invita a administrar este usuario. El elemento AccountIds determina qué cuentas de cliente puede administrar el usuario.

Enviar: Obligatorio
Registro: Solo lectura
largo
Correo electrónico Dirección de correo electrónico correspondiente a la cuenta microsoft del usuario. La dirección puede contener un máximo de 100 caracteres.

Enviar: Obligatorio
Registro: Obligatorio
string
ExpirationDate Fecha y hora en que expirará la invitación del usuario. El valor se encuentra en la hora UTC (hora universal coordinada).

La duración de una invitación de usuario está sujeta a cambios y actualmente se establece en 30 días. No se puede establecer ni actualizar este valor.

Enviar: Solo lectura
Registro: Solo lectura
dateTime
FirstName El nombre de pila del usuario.

El nombre está limitado a 40 caracteres.

Enviar: Obligatorio
Registro: Obligatorio
string
Identificación Identificador único generado por el sistema para la invitación del usuario.

Enviar: Solo lectura
Registro: Solo lectura
largo
LastName El apellido del usuario.

El apellido está limitado a 40 caracteres.

Enviar: Obligatorio
Registro: Obligatorio
string
Lcid Configuración regional que se va a usar al enviar correspondencia al usuario por correo electrónico o correo postal.

El valor predeterminado es EnglishUS.

Enviar: Obligatorio
Registro: Obligatorio
LCID
RoleId Rol que el usuario tiene para cada cliente o lista de cuentas.

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 .
Enviar: Obligatorio
Registro: Obligatorio. El identificador de rol debe establecerse en 41 o 203.
int

Requisitos

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

Usado por

SearchUserInvitations
SendUserInvitation
SignupCustomer