Compartir a través de

Objeto de datos de cliente: Administración de clientes

  • Artículo

Define un objeto de cliente que contiene una o varias cuentas de Microsoft Advertising.

Sintaxis

<xs:complexType name="Customer" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="CustomerFinancialStatus" nillable="true" type="tns:CustomerFinancialStatus" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Industry" nillable="true" type="tns:Industry" />
    <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="MarketCountry" nillable="true" type="xs:string" />
    <xs:element xmlns:q4="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q4:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="MarketLanguage" nillable="true" type="tns:LanguageType" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ServiceLevel" nillable="true" type="tns:ServiceLevel" />
    <xs:element minOccurs="0" name="CustomerLifeCycleStatus" nillable="true" type="tns:CustomerLifeCycleStatus" />
    <xs:element minOccurs="0" name="TimeStamp" nillable="true" type="xs:base64Binary" />
    <xs:element minOccurs="0" name="Number" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CustomerAddress" nillable="true" type="tns:Address" />
  </xs:sequence>
</xs:complexType>

Elementos

El objeto Customer tiene los siguientes elementos: CustomerAddress, CustomerFinancialStatus, CustomerLifeCycleStatus, ForwardCompatibilityMap, Id, Industry, LastModifiedByUserId, LastModifiedTime, MarketCountry, MarketLanguage, Name, Number, ServiceLevel, TimeStamp.

Elemento Descripción Tipo de datos
CustomerAddress Dirección de negocio del cliente.

Microsoft Advertising no usa esta propiedad y, en su lugar, debe establecer la dirección de negocio de la cuenta.

Añadir: Opcional
Actualizar: Opcional		 Dirección
CustomerFinancialStatus Estado financiero del cliente. Por ejemplo, el estado indica si el cliente está en buen estado o si una o varias de las cuentas han vencido.

Añadir: Solo lectura
Actualizar: Solo lectura		 CustomerFinancialStatus
CustomerLifeCycleStatus Estado del cliente. Al crear el cliente, el estado se establece en Activo. No se puede cambiar el estado.

Añadir: Solo lectura
Actualizar: Solo lectura		 CustomerLifeCycleStatus
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 cliente generado por el sistema.

Use este identificador con solicitudes de operación que requieran un elemento de encabezado SOAP CustomerId .

Añadir: Solo lectura
Actualizar: Obligatorio		 Largo
Industria El segmento de negocio principal del cliente, por ejemplo, automóviles, alimentos o entretenimiento.

Añadir: Obligatorio
Actualizar: Obligatorio		 Industria
LastModifiedByUserId Identificador del último usuario que actualiza la información del cliente.

Añadir: Solo lectura
Actualizar: Solo lectura		 Largo
LastModifiedTime Fecha y hora en que se actualizó por última vez la información del 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
MarketCountry El país principal donde opera el cliente. Para obtener una lista de los valores de código de país del mercado del cliente, consulte Idioma del producto.

Añadir: Obligatorio
Actualizar: Solo lectura		 string
MarketLanguage El idioma principal que usa el cliente. El idioma del mercado del cliente determina el idioma de la interfaz de Microsoft Advertising. Para obtener una lista de los valores de código de lenguaje de mercado del cliente, consulte Idioma del producto.

Añadir: Obligatorio
Actualizar: Solo lectura		 LanguageType
Nombre Nombre del cliente.

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

Añadir: Obligatorio
Actualizar: Obligatorio		 string
Número Número de cliente generado por el sistema que se usa en la aplicación web de Microsoft Advertising.

El número de cliente tiene el formato xxxxxxxxxx, donde xxxxxxxxxx es una serie de diez caracteres alfanuméricos.

Añadir: Solo lectura
Actualizar: Solo lectura		 string
ServiceLevel Únicamente para uso interno. Si este elemento se establece al llamar a SignupCustomer , se devolverá un error. Si este elemento se establece al llamar a UpdateCustomer , se omitirá el elemento.

Añadir: Solo lectura
Actualizar: Solo lectura		 ServiceLevel
Timestamp Valor de marca de tiempo que el sistema usa internamente para conciliar las actualizaciones al llamar a las operaciones UpdateCustomer y DeleteCustomer .

Añadir: Solo lectura
Actualizar: Obligatorio		 base64Binary

Requisitos

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

Usado por

GetCustomer
SearchCustomers
SignupCustomer
UpdateCustomer