Freigeben über

Kundendatenobjekt – Kundenverwaltung

  • Artikel

Definiert ein Kundenobjekt, das mindestens ein Microsoft Advertising-Konto enthält.

Syntax

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

Elemente

Das Customer-Objekt weist die folgenden Elemente auf: CustomerAddress, CustomerFinancialStatus, CustomerLifeCycleStatus, ForwardCompatibilityMap, Id, Industry, LastModifiedByUserId, LastModifiedTime, MarketCountry, MarketLanguage, Name, Number, ServiceLevel, TimeStamp.

Element Beschreibung Datentyp
CustomerAddress Die Geschäftsadresse des Kunden.

Diese Eigenschaft wird von Microsoft Advertising nicht verwendet, und Sie müssen stattdessen die Geschäftsadresse des Kontos festlegen.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei		 Adresse
CustomerFinancialStatus Die finanzielle status des Kunden. Die status gibt beispielsweise an, ob der Kunde gut aufgestellt ist oder ob mindestens ein Konto überfällig ist.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 CustomerFinancialStatus
CustomerLifeCycleStatus Die status des Kunden. Wenn Sie den Kunden erstellen, wird die status auf Aktiv festgelegt. Sie können die status nicht ändern.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 CustomerLifeCycleStatus
ForwardCompatibilityMap Die Liste der Schlüssel- und Wertzeichenfolgen für die Vorwärtskompatibilität, um andere Breaking Changes zu vermeiden, wenn neue Elemente in der aktuellen API-Version hinzugefügt werden.

Änderungen an der Vorwärtskompatibilität werden in zukünftigen Versionen hier notiert. Es gibt derzeit keine Änderungen an der Vorwärtskompatibilität für dieses Objekt.		 KeyValuePairOfstring-Array
Id Der vom System generierte Kundenbezeichner.

Verwenden Sie diesen Bezeichner für Vorgangsanforderungen, die ein CustomerId-SOAP-Headerelement erfordern.

Hinzufügen: Schreibgeschützt
Aktualisieren: Erforderlich		 lang
Branche Das primäre Geschäftsfeld des Kunden, z. B. Automotive, Food oder Entertainment.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich		 Branche
LastModifiedByUserId Der Bezeichner des letzten Benutzers, der die Kundeninformationen aktualisiert hat.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 lang
LastModifiedTime Das Datum und die Uhrzeit der letzten Aktualisierung der Kundeninformationen. Der Wert wird in UTC (Coordinated Universal Time) angegeben.

Der Datums- und Uhrzeitwert gibt das Datum und die Uhrzeit auf dem Server und nicht auf dem Client an. Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 dateTime
MarketCountry Das primäre Land, in dem der Kunde tätig ist. Eine Liste der Ländercodewerte des Kundenmarkts finden Sie unter Produktsprache.

Hinzufügen: Erforderlich
Aktualisieren: Schreibgeschützt		 Zeichenfolge
MarketLanguage Die primäre Sprache, die der Kunde verwendet. Die Marktsprache Ihres Kunden bestimmt die Sprache der Microsoft Advertising-Schnittstelle. Eine Liste der Codewerte der Kundenmarktsprache finden Sie unter Produktsprache.

Hinzufügen: Erforderlich
Aktualisieren: Schreibgeschützt		 LanguageType
Name Der Name des Kunden.

Der Name darf maximal 90 Zeichen enthalten.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich		 Zeichenfolge
Zahl Eine vom System generierte Kundennummer, die in der Microsoft Advertising-Webanwendung verwendet wird.

Die Kundennummer hat das Format xxxxxxxxxxxx, wobei xxxxxxxxxx eine Reihe von zehn alphanumerischen Zeichen ist.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 Zeichenfolge
ServiceLevel Ausschließlich für interne Zwecke. Wenn dieses Element beim Aufrufen von SignupCustomer festgelegt wird, wird ein Fehler zurückgegeben. Wenn dieses Element beim Aufrufen von UpdateCustomer festgelegt wird, wird das Element ignoriert.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 ServiceLevel
Zeitstempel Ein Zeitstempelwert, den das System intern zum Abgleichen von Updates verwendet, wenn Sie die Vorgänge UpdateCustomer und DeleteCustomer aufrufen.

Hinzufügen: Schreibgeschützt
Aktualisieren: Erforderlich		 base64Binary

Anforderungen

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

Verwendet von

GetCustomer
SearchCustomers
SignupCustomer
UpdateCustomer