Kundendatenobjekt – Kundenverwaltung
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: Optional Aktualisieren: Optional |
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 |
Lange |
| 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 |
Lange |
| 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 |
| Timestamp | 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