Compartir a través de

Objeto de datos de usuario: administración de clientes

  • Artículo

Define información de contacto personal y empresarial sobre un usuario de Microsoft Advertising.

Se pueden asignar varios objetos de usuario a la misma persona, es decir, un usuario por persona por cliente. La configuración de usuario Name, Lcid, JobTitle y ContactInfo para la misma persona se sincronizará automáticamente con las actualizaciones que se produzcan después de la consolidación del usuario. LastModifiedByUserId y LastModifiedTime también están sincronizados en cada objeto User devuelto, a menos que haya combinado un nombre de usuario antiguo y no haya actualizado ninguna configuración de usuario desde la consolidación.

Sugerencia

Con las credenciales de varios usuarios de Microsoft Advertising puede aceptar una invitación para administrar un cliente independiente con sus credenciales de Microsoft Advertising existentes. Para obtener más información, consulte la Guía técnica de credenciales de varios usuarios .

Sintaxis

<xs:complexType name="User" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="ContactInfo" nillable="true" type="tns:ContactInfo" />
    <xs:element minOccurs="0" name="CustomerId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="JobTitle" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="LastModifiedByUserId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="LastModifiedTime" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Lcid" nillable="true" type="tns:LCID" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="tns:PersonName" />
    <xs:element minOccurs="0" name="Password" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="SecretAnswer" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="SecretQuestion" type="tns:SecretQuestion" />
    <xs:element minOccurs="0" name="UserLifeCycleStatus" nillable="true" type="tns:UserLifeCycleStatus" />
    <xs:element minOccurs="0" name="TimeStamp" nillable="true" type="xs:base64Binary" />
    <xs:element minOccurs="0" name="UserName" nillable="true" type="xs:string" />
    <xs:element xmlns:q6="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q6:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="AuthenticationToken" nillable="true" type="xs:string">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

Elementos

El objeto User tiene los siguientes elementos: AuthenticationToken, ContactInfo, CustomerId, ForwardCompatibilityMap, Id, JobTitle, LastModifiedByUserId, LastModifiedTime, Lcid, Name, Password, SecretAnswer, SecretQuestion, TimeStamp, UserLifeCycleStatus, UserName.

Elemento Descripción Tipo de datos
AuthenticationToken Token de acceso de OAuth que representa las credenciales del usuario que tiene permisos para cuentas de Microsoft Advertising.

Para obtener más información, consulte Autenticación con OAuth.

Actualizar: Solo lectura		 string
Contactinfo Información de contacto del usuario.

Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.		 Contactinfo
Customerid Identificador del cliente al que tiene acceso este usuario.

Actualizar: Solo lectura		 Largo
ForwardCompatibilityMap Lista de cadenas de clave y valor para la compatibilidad con reenvíos para evitar cambios importantes en caso contrario cuando se agregan nuevos elementos en la versión actual de la API.

Los cambios de compatibilidad de reenvío se anotarán aquí en futuras versiones. Actualmente no hay cambios de compatibilidad de reenvío para este objeto.		 Matriz KeyValuePairOfstringstring
Id Identificador de Microsoft Advertising del usuario.

Actualizar: Obligatorio		 Largo
JobTitle Puesto del usuario. El título puede contener un máximo de 50 caracteres.

Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.		 string
LastModifiedByUserId Identificador del último usuario que actualiza la información del usuario.

Actualizar: Solo lectura		 Largo
LastModifiedTime Fecha y hora en que se actualizó por última vez la información del usuario. El valor se encuentra en la hora UTC (hora universal coordinada).

El valor de fecha y hora refleja la fecha y hora en el servidor, no en el cliente. Para obtener información sobre el formato de la fecha y hora, vea la entrada dateTime en Tipos de datos XML primitivos.

Actualizar: Solo lectura		 dateTime
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.

Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.		 LCID
Nombre Nombre del usuario.

Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.		 PersonName
Contraseña Este elemento está reservado para uso interno y se quitará de una versión futura de la API.

La operación GetUser no devuelve la contraseña.

Actualizar: Solo lectura		 string
SecretAnswer Este elemento está reservado para uso interno y se quitará de una versión futura de la API.

Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.		 string
SecretQuestion Este elemento está reservado para uso interno y se quitará de una versión futura de la API.

Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.		 SecretQuestion
Timestamp Valor de marca de tiempo que el sistema usa internamente para conciliar las actualizaciones al llamar a UpdateUser o DeleteUser.

Actualizar: Obligatorio		 base64Binary
UserLifeCycleStatus Estado del usuario.

Actualizar: Solo lectura		 UserLifeCycleStatus
Nombre de usuario Nombre de usuario de inicio de sesión del usuario.

La dirección de correo electrónico de la cuenta microsoft puede diferir del elemento Email del objeto ContactInfo.

Actualizar: Solo lectura		 string

Requisitos

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

Usado por

GetUser
SignupCustomer
UpdateUser