Compartir a través de

Objeto de datos ClientLink: Administración de clientes

  • Artículo

Define un objeto de vínculo de cliente. La aceptación de una invitación de vínculo de cliente permite a una agencia administrar las cuentas de anunciante de cliente correspondientes. Para enviar una invitación para administrar una cuenta de anunciante cliente, llame a la operación AddClientLinks y especifique un vínculo de cliente por cuenta para administrar.

Un vínculo de cliente no tiene un identificador de sistema público. Puede identificar vínculos de cliente distintos por ClientEntityId y ManagingCustomerId.

Sugerencia

Para obtener más información sobre el ciclo de vida del vínculo de cliente, consulte la guía técnica Jerarquía de cuentas . Para obtener más información sobre cómo convertirse en una agencia, consulte Recursos para asociados de la agencia. Para obtener más información desde la perspectiva de un cliente, consulte Cómo hacer que una agencia administre su cuenta de Microsoft Advertising.

Nota:

Los clientes de la agencia en el piloto Crear cuentas en nombre del cliente (GetCustomerPilotFeatures devuelve 793) también pueden establecer vínculos de cliente de nivel de cuenta de anuncio a través de la operación de servicio SignupCustomer . Consulte SignupCustomer para obtener más información.

Sintaxis

<xs:complexType name="ClientLink" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClientEntityId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ClientEntityNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClientEntityName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ManagingCustomerId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ManagingCustomerNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ManagingCustomerName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Note" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterEmail" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterPhone" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="IsBillToClient" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:ClientLinkStatus" />
    <xs:element minOccurs="0" name="SuppressNotification" type="xs:boolean" />
    <xs:element minOccurs="0" name="LastModifiedDateTime" type="xs:dateTime" />
    <xs:element minOccurs="0" name="LastModifiedByUserId" type="xs:long" />
    <xs:element minOccurs="0" name="Timestamp" nillable="true" type="xs:base64Binary" />
    <xs:element xmlns:q10="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q10:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="CustomerLinkPermission" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Elementos

El objeto ClientLink tiene los siguientes elementos: ClientEntityId, ClientEntityName, ClientEntityNumber, CustomerLinkPermission, ForwardCompatibilityMap, InviterEmail, InviterName, InviterPhone, IsBillToClient, LastModifiedByUserId, LastModifiedDateTime, ManagingCustomerId, ManagingCustomerName, ManagingCustomerNumber, Name, Note, StartDate, Status, SuppressNotification, Timestamp, Type.

Elemento Descripción Tipo de datos
ClientEntityId Identificador de la cuenta de anunciante cliente o cliente cliente que se va a administrar

El elemento Type determina si el vínculo es a una cuenta de anunciante cliente o a un cliente cliente.

Añadir: Obligatorio. Se requiere ClientEntityId o ClientEntityNumber , pero si se especifican ambos, se producirá un error en la operación.
Actualizar: Solo lectura y Obligatorio.		 Largo
ClientEntityName Nombre de la cuenta de anunciante cliente o cliente cliente que se va a administrar

El elemento Type determina si el vínculo es a una cuenta de anunciante cliente o a un cliente cliente.

Añadir: Solo lectura
Actualizar: Solo lectura		 string
ClientEntityNumber Número de la cuenta de anunciante cliente o cliente que se va a administrar

El elemento Type determina si el vínculo es a una cuenta de anunciante cliente o a un cliente cliente.

Añadir: Obligatorio. Se requiere ClientEntityId o ClientEntityNumber , pero si se especifican ambos, se producirá un error en la operación.
Actualizar: Solo lectura y Obligatorio.		 string
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.

Este elemento solo es aplicable si Type está establecido en CustomerLink. En ese caso, los valores posibles incluyen Administrative y Standard. De lo contrario, este campo debe ser nulo o vacío.

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

Si este campo se establece en "Estándar", el usuario tiene acceso a ClientEntityId a través de un vínculo de cliente Estándar.

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

Añadir: Opcional
Actualizar: Solo lectura		 string
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 el objeto ClientLink .		 Matriz KeyValuePairOfstringstring
InviterEmail Correo electrónico del usuario que creó la solicitud de vínculo de cliente.

Este valor no tiene que ser el mismo que, ni se usa para modificar, el correo electrónico ya almacenado en Microsoft Advertising para el usuario autenticado actual.

Si no se especifica, el servicio establecerá este valor en el correo electrónico ya almacenado en Microsoft Advertising para el usuario autenticado actual.

Añadir: Opcional
Actualizar: Solo lectura		 string
InviterName Nombre del cliente primario del usuario que creó la solicitud de vínculo de cliente.

Este valor no tiene que ser el mismo que, ni se usa para modificar, el nombre del cliente ya almacenado en Microsoft Advertising.

Si no se especifica, el servicio establecerá este valor en el nombre del cliente primario ya almacenado en Microsoft Advertising para el usuario autenticado actual.

Añadir: Opcional
Actualizar: Solo lectura		 string
InviterPhone Número de teléfono del usuario que creó la solicitud de vínculo de cliente.

Este valor no necesita ser el mismo que, ni se usa para modificar, el número de teléfono ya almacenado en Microsoft Advertising para el usuario autenticado actual.

Si no se especifica, el servicio establecerá este valor en el número de teléfono ya almacenado en Microsoft Advertising para el usuario autenticado actual.

Añadir: Opcional
Actualizar: Solo lectura		 string
IsBillToClient Determina si el propietario de la cuenta de anunciante del cliente o el cliente administrador es responsable de los pagos de facturación.

Este elemento solo es aplicable a los vínculos de cliente de la cuenta de anunciante y no se aplica a los vínculos de clientes. La cuenta de anunciante de cliente debe configurarse para la facturación posterior al pago. Las agencias no admiten cuentas de prepago para la administración. Si se establece en true, el cliente es responsable de la facturación. Si se establece en false, el cliente de administración es responsable de la facturación.

Añadir: Obligatorio para los vínculos de la cuenta de anunciante; No se aplica a los vínculos de clientes.
Actualizar: Solo lectura		 boolean
LastModifiedByUserId Identificador del último usuario que actualiza la información del vínculo de cliente.

Añadir: Solo lectura
Actualizar: Solo lectura		 Largo
LastModifiedDateTime Fecha y hora en que se actualizó por última vez el vínculo de cliente. 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.

Añadir: Solo lectura
Actualizar: Solo lectura		 dateTime
ManagingCustomerId Identificador del cliente que administra o solicita administrar la cuenta de anunciante del cliente.

Añadir: Obligatorio. Se requiere ManagingCustomerId o ManagingCustomerNumber , pero especificar ambos provocará un error en la operación.
Actualizar: Solo lectura y Obligatorio		 Largo
ManagingCustomerName Nombre del cliente que administra o solicita administrar la cuenta de anunciante del cliente.

Añadir: Solo lectura
Actualizar: Solo lectura		 string
ManagingCustomerNumber Número del cliente que administra o solicita administrar la cuenta de anunciante del cliente.

Añadir: Obligatorio. Se requiere ManagingCustomerId o ManagingCustomerNumber , pero especificar ambos provocará un error en la operación.
Actualizar: Solo lectura y Obligatorio		 string
Nombre Nombre descriptivo que se puede usar para hacer referencia a este vínculo de cliente.

El nombre puede contener un máximo de 40 caracteres.

Se proporcionará un nombre predeterminado si no se especifica ninguno. No es necesario que el nombre sea único en comparación con otros vínculos de cliente para el usuario.

Añadir: Opcional
Actualizar: Solo lectura		 string
Nota: Mensaje opcional del solicitante que proporciona contexto y detalles sobre la invitación de vínculo de cliente.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.		 string
StartDate Fecha en la que se actualizaría el estado. En el caso de una solicitud de vínculo aceptada, el estado pasaría a Activo en esta fecha y, para una solicitud de desvinculación, el estado pasaría a Inactivo en esta fecha.

Si no se especifica, este valor se establecerá en la fecha y hora actuales.

Añadir: Opcional
Actualizar: Solo lectura		 dateTime
Estado Determina el estado del ciclo de vida del vínculo de cliente, por ejemplo, si el vínculo de cliente se ha aceptado o rechazado.

Al agregar un vínculo de cliente, este elemento no se puede especificar y el servicio establece el estado efectivo en LinkPending.

Añadir: Solo lectura
Actualizar: Obligatorio		 ClientLinkStatus
SuppressNotification Determina si se envía o no una notificación por correo electrónico de la invitación de vínculo de cliente al usuario principal de la cuenta de anunciante del cliente.

Si se establece en true, el cliente no recibirá un correo electrónico y, de lo contrario, dado que el valor predeterminado es false, el cliente recibirá una notificación por correo electrónico.

Añadir: Opcional
Actualizar: Solo lectura		 boolean
Timestamp Reservado para uso futuro. base64Binary
Tipo Determina si el vínculo es a una cuenta de anunciante cliente o a un cliente cliente.

Los valores posibles son AccountLink y CustomerLink. Si este elemento está vacío o está establecido en AccountLink, ClientEntityId, ClientEntityName y ClientEntityNumber representan una cuenta de anunciante de cliente. Si este elemento se establece en CustomerLink, ClientEntityId, ClientEntityName y ClientEntityNumber representan un cliente.

Añadir: Opcional. Si no se establece este elemento, el servicio intenta crear un vínculo de cliente de cuenta de anunciante.
Actualizar: Solo lectura		 string

Requisitos

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

Usado por

AddClientLinks
SearchClientLinks
UpdateClientLinks