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