Partilhar via

Objeto de Dados do Cliente - Gestão de Clientes

  • Artigo

Define um objeto de cliente que contém uma ou mais contas do Microsoft Advertising.

Sintaxe

<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

O objeto Cliente tem os seguintes elementos: CustomerAddress, CustomerFinancialStatus, CustomerLifeCycleStatus, ForwardCompatibilityMap, Id, Industry, LastModifiedByUserId, LastModifiedTime, MarketCountry, MarketLanguage, Name, Number, ServiceLevel, TimeStamp.

Elemento Descrição Tipo de Dados
Endereço do Cliente O endereço comercial do cliente.

Esta propriedade não é utilizada pelo Microsoft Advertising e, em vez disso, tem de definir o endereço empresarial da conta.

Adicionar: Opcional
Atualização: Opcional		 Address
CustomerFinancialStatus O estado financeiro do cliente. Por exemplo, o estado indica se o cliente está em boas condições ou se uma ou mais das contas estão vencidas.

Adicionar: Só de leitura
Atualização: Só de leitura		 CustomerFinancialStatus
CustomerLifeCycleStatus O estado do cliente. Quando cria o cliente, o estado é definido como Ativo. Não pode alterar o estado.

Adicionar: Só de leitura
Atualização: Só de leitura		 CustomerLifeCycleStatus
ForwardCompatibilityMap A lista de cadeias de chave e valor para compatibilidade de reencaminhamento para evitar alterações interruptivas quando novos elementos são adicionados na versão atual da API.

As alterações de compatibilidade de reencaminhamento serão registadas aqui em versões futuras. Atualmente, não existem alterações de compatibilidade para este objeto.		 Matriz KeyValuePairOfstringstring
ID O identificador de cliente gerado pelo sistema.

Utilize este identificador com pedidos de operação que requerem um elemento de cabeçalho SOAP CustomerId .

Adicionar: Só de leitura
Atualização: Necessário		 Longo
Indústria O segmento de negócio principal do cliente, por exemplo, automóvel, alimentação ou entretenimento.

Adicionar: Necessário
Atualização: Necessário		 Indústria
LastModifiedByUserId O identificador do último utilizador a atualizar as informações do cliente.

Adicionar: Só de leitura
Atualização: Só de leitura		 Longo
LastModifiedTime A data e hora em que as informações do cliente foram atualizadas pela última vez. O valor está em Hora Universal Coordenada (UTC).

O valor de data e hora reflete a data e hora no servidor, não o cliente. Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos.

Adicionar: Só de leitura
Atualização: Só de leitura		 dateTime
MarketCountry O país primário onde o cliente opera. Para obter uma lista dos valores de código do país do mercado de clientes, veja Idioma do Produto.

Adicionar: Necessário
Atualização: Só de leitura		 cadeia
MarketLanguage O idioma principal que o cliente utiliza. O seu idioma de mercado do cliente determina o idioma da interface de Publicidade da Microsoft. Para obter uma lista dos valores de código de idioma do mercado de clientes, veja Idioma do Produto.

Adicionar: Necessário
Atualização: Só de leitura		 LanguageType
Nome O nome do cliente.

O nome pode conter um máximo de 90 carateres.

Adicionar: Necessário
Atualização: Necessário		 cadeia
Número Um número de cliente gerado pelo sistema que é utilizado na aplicação Web Microsoft Advertising.

O número de cliente tem o formulário xxxxxxxxxx, em que xxxxxxxxxx é uma série de dez carateres alfanuméricos.

Adicionar: Só de leitura
Atualização: Só de leitura		 cadeia
Nível de Serviço Apenas para utilização interna. Se este elemento estiver definido ao chamar SignupCustomer , será devolvido um erro. Se este elemento estiver definido ao chamar UpdateCustomer , o elemento será ignorado.

Adicionar: Só de leitura
Atualização: Só de leitura		 Nível de Serviço
Carimbo de data/hora Um valor de carimbo de data/hora que o sistema utiliza internamente para reconciliar as atualizações quando chama as operações UpdateCustomer e DeleteCustomer .

Adicionar: Só de leitura
Atualização: Necessário		 base64Binary

Requisitos

Serviço: CustomerManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/Customer/v13/Entities

Utilizado Por

GetCustomer
SearchCustomers
SignupCustomer
UpdateCustomer