Condividi tramite

Oggetto dati del cliente - Gestione dei clienti

  • Articolo

Definisce un oggetto cliente che contiene uno o più account Microsoft Advertising.

Sintassi

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

Elementi

L'oggetto Customer include gli elementi seguenti: CustomerAddress, CustomerFinancialStatus, CustomerLifeCycleStatus, ForwardCompatibilityMap, Id, Industry, LastModifiedByUserId, LastModifiedTime, MarketCountry, MarketLanguage, Name, Number, ServiceLevel, TimeStamp.

Elemento Descrizione Tipo di dati
CustomerAddress Indirizzo aziendale del cliente.

Questa proprietà non viene utilizzata da Microsoft Advertising ed è invece necessario impostare l'indirizzo aziendale dell'account.

Aggiungere: Opzionale
Aggiornare: Opzionale		 Indirizzo
CustomerFinancialStatus Stato finanziario del cliente. Ad esempio, lo stato indica se il cliente è in regola o se uno o più account sono scaduto.

Aggiungere: Sola lettura
Aggiornare: Sola lettura		 CustomerFinancialStatus
CustomerLifeCycleStatus Stato del cliente. Quando si crea il cliente, lo stato è impostato su Attivo. Non è possibile modificare lo stato.

Aggiungere: Sola lettura
Aggiornare: Sola lettura		 CustomerLifeCycleStatus
ForwardCompatibilityMap Elenco di stringhe di chiave e valore per la compatibilità con l'inoltro per evitare modifiche che altrimenti causano un'interruzione quando vengono aggiunti nuovi elementi nella versione corrente dell'API.

Le modifiche di compatibilità forward verranno annotate qui nelle versioni future. Attualmente non sono presenti modifiche di compatibilità per questo oggetto.		 Matrice KeyValuePairOfstringstring
Id Identificatore del cliente generato dal sistema.

Usare questo identificatore con le richieste di operazione che richiedono un elemento di intestazione SOAP CustomerId .

Aggiungere: Sola lettura
Aggiornare: Obbligatorio		 long
Settore Il segmento di business principale del cliente, ad esempio automobilistico, alimentare o di intrattenimento.

Aggiungere: Obbligatorio
Aggiornare: Obbligatorio		 Settore
LastModifiedByUserId Identificatore dell'ultimo utente per aggiornare le informazioni del cliente.

Aggiungere: Sola lettura
Aggiornare: Sola lettura		 long
LastModifiedTime Data e ora dell'ultimo aggiornamento delle informazioni sul cliente. Il valore è espresso nell'ora UTC (Coordinated Universal Time).

Il valore di data e ora riflette la data e l'ora nel server, non nel client. Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.

Aggiungere: Sola lettura
Aggiornare: Sola lettura		 dateTime
MarketCountry Paese primario in cui opera il cliente. Per un elenco dei valori del codice paese del mercato dei clienti, vedere Lingua del prodotto.

Aggiungere: Obbligatorio
Aggiornare: Sola lettura		 corda
MarketLanguage Lingua primaria usata dal cliente. La lingua del mercato dei clienti determina la lingua dell'interfaccia microsoft advertising. Per un elenco dei valori del codice del linguaggio del mercato dei clienti, vedere Lingua del prodotto.

Aggiungere: Obbligatorio
Aggiornare: Sola lettura		 LanguageType
Nome Nome del cliente.

Il nome può contenere un massimo di 90 caratteri.

Aggiungere: Obbligatorio
Aggiornare: Obbligatorio		 corda
Numero Numero di cliente generato dal sistema usato nell'applicazione Web Microsoft Advertising.

Il numero del cliente ha il formato xxxxxxxxxxxx, dove xxxxxxxxxx è una serie di dieci caratteri alfanumerici.

Aggiungere: Sola lettura
Aggiornare: Sola lettura		 corda
ServiceLevel Solo per uso interno. Se questo elemento è impostato quando si chiama SignupCustomer , verrà restituito un errore. Se questo elemento viene impostato quando si chiama UpdateCustomer , l'elemento verrà ignorato.

Aggiungere: Sola lettura
Aggiornare: Sola lettura		 ServiceLevel
Timestamp Valore di timestamp usato internamente dal sistema per riconciliare gli aggiornamenti quando si chiamano le operazioni UpdateCustomer ed DeleteCustomer .

Aggiungere: Sola lettura
Aggiornare: Obbligatorio		 base64Binary

Requisiti

Servizio: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities

Usato da

GetCustomer
SearchCustomers
SignupCustomer
UpdateCustomer