Freigeben über

Benutzerdatenobjekt – Kundenverwaltung

  • Artikel

Definiert persönliche und geschäftliche Kontaktinformationen zu einem Microsoft Advertising-Benutzer.

Mehrere Benutzerobjekte können derselben Person zugewiesen werden, d. h. einem Benutzer pro Person und Kunde. Die Benutzereinstellungen Name, Lcid, JobTitle und ContactInfo für dieselbe Person werden automatisch mit allen Updates synchronisiert, die nach der Benutzerkonsolidierung auftreten. LastModifiedByUserId und LastModifiedTime sind auch für jedes zurückgegebene User-Objekt synchron, es sei denn, Sie hatten einen alten Benutzernamen zusammengeführt und haben seit der Konsolidierung keine Benutzereinstellungen aktualisiert.

Tipp

Mit Microsoft Advertising-Anmeldeinformationen mit mehreren Benutzern können Sie eine Einladung annehmen, einen separaten Kunden mit Ihren vorhandenen Microsoft Advertising-Anmeldeinformationen zu verwalten. Weitere Informationen finden Sie im technischen Leitfaden für Mehrbenutzeranmeldeinformationen .

<xs:complexType name="User" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="ContactInfo" nillable="true" type="tns:ContactInfo" />
    <xs:element minOccurs="0" name="CustomerId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="JobTitle" nillable="true" type="xs:string" />
    <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="Lcid" nillable="true" type="tns:LCID" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="tns:PersonName" />
    <xs:element minOccurs="0" name="Password" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="SecretAnswer" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="SecretQuestion" type="tns:SecretQuestion" />
    <xs:element minOccurs="0" name="UserLifeCycleStatus" nillable="true" type="tns:UserLifeCycleStatus" />
    <xs:element minOccurs="0" name="TimeStamp" nillable="true" type="xs:base64Binary" />
    <xs:element minOccurs="0" name="UserName" nillable="true" type="xs:string" />
    <xs:element xmlns:q6="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q6:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="AuthenticationToken" nillable="true" type="xs:string">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

Elemente

Das User-Objekt verfügt über die folgenden Elemente: AuthenticationToken, ContactInfo, CustomerId, ForwardCompatibilityMap, Id, JobTitle, LastModifiedByUserId, LastModifiedTime, Lcid, Name, Password, SecretAnswer, SecretQuestion, TimeStamp, UserLifeCycleStatus, UserName.

Element Beschreibung Datentyp
AuthenticationToken Das OAuth-Zugriffstoken, das die Anmeldeinformationen des Benutzers darstellt, der über Berechtigungen für Microsoft Advertising-Konten verfügt.

Weitere Informationen finden Sie unter Authentifizierung mit OAuth.

Aktualisieren: Schreibgeschützt		 Zeichenfolge
ContactInfo Die Kontaktinformationen des Benutzers.

Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 ContactInfo
CustomerId Der Bezeichner des Kunden, auf den dieser Benutzer zugreifen kann.

Aktualisieren: Schreibgeschützt		 lang
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 Die Microsoft Advertising-ID des Benutzers.

Aktualisieren: Erforderlich		 lang
JobTitle Die Position des Benutzers. Der Titel darf maximal 50 Zeichen enthalten.

Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 Zeichenfolge
LastModifiedByUserId Der Bezeichner des letzten Benutzers, der die Informationen des Benutzers aktualisiert hat.

Aktualisieren: Schreibgeschützt		 lang
LastModifiedTime Das Datum und die Uhrzeit der letzten Aktualisierung der Benutzerinformationen. 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.

Aktualisieren: Schreibgeschützt		 dateTime
Lcid Das Gebietsschema, das beim Senden von Korrespondenz an den Benutzer per E-Mail oder Post verwendet werden soll. Der Standardwert ist EnglishUS.

Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 LCID
Name Der Name des Benutzers.

Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 PersonName
Kennwort Dieses Element ist für die interne Verwendung reserviert und wird aus einer zukünftigen Version der API entfernt.

Der GetUser-Vorgang gibt das Kennwort nicht zurück.

Aktualisieren: Schreibgeschützt		 Zeichenfolge
SecretAnswer Dieses Element ist für die interne Verwendung reserviert und wird aus einer zukünftigen Version der API entfernt.

Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 Zeichenfolge
SecretQuestion Dieses Element ist für die interne Verwendung reserviert und wird aus einer zukünftigen Version der API entfernt.

Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 SecretQuestion
Zeitstempel Ein Zeitstempelwert, den das System intern zum Abgleichen von Updates verwendet, wenn Sie UpdateUser oder DeleteUser aufrufen.

Aktualisieren: Erforderlich		 base64Binary
UserLifeCycleStatus Die status des Benutzers.

Aktualisieren: Schreibgeschützt		 UserLifeCycleStatus
UserName Der Anmeldebenutzername des Benutzers.

Die E-Mail-Adresse des Microsoft-Kontos kann sich von der Email Element des ContactInfo-Objekts unterscheiden.

Aktualisieren: Schreibgeschützt		 Zeichenfolge

Anforderungen

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

Verwendet von

GetUser
SignupCustomer
UpdateUser