Freigeben über

ClientLink-Datenobjekt – Kundenverwaltung

  • Artikel

Definiert ein Clientlinkobjekt. Die Annahme einer Clientlink-Einladung ermöglicht es einer Agentur, die entsprechenden Kundenkundenkonten zu verwalten. Um eine Einladung zum Verwalten eines Client-Advertiser-Kontos zu senden, rufen Sie den AddClientLinks-Vorgang auf, und geben Sie einen Clientlink pro zu verwaltenden Konto an.

Eine Clientverbindung verfügt nicht über einen öffentlichen Systembezeichner. Sie können unterschiedliche Clientlinks anhand von ClientEntityId und ManagingCustomerId identifizieren.

Tipp

Weitere Informationen zum Lebenszyklus von Clientlinks finden Sie im technischen Leitfaden zur Kontohierarchie . Weitere Informationen zum Werden einer Agentur finden Sie unter Ressourcen für Agenturpartner. Weitere Informationen aus der Perspektive eines Kunden finden Sie unter Verwalten Ihres Microsoft Advertising-Kontos durch eine Agentur.

Hinweis

Agenturkunden im Pilotprojekt Erstellen von Konten im Auftrag von Client (GetCustomerPilotFeatures gibt 793 zurück) können auch Clientlinks auf Anzeigenkontoebene über den SignupCustomer-Dienstvorgang einrichten. Weitere Informationen finden Sie unter SignupCustomer .

Syntax

<xs:complexType name="ClientLink" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClientEntityId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ClientEntityNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClientEntityName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ManagingCustomerId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ManagingCustomerNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ManagingCustomerName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Note" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterEmail" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterPhone" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="IsBillToClient" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:ClientLinkStatus" />
    <xs:element minOccurs="0" name="SuppressNotification" type="xs:boolean" />
    <xs:element minOccurs="0" name="LastModifiedDateTime" type="xs:dateTime" />
    <xs:element minOccurs="0" name="LastModifiedByUserId" type="xs:long" />
    <xs:element minOccurs="0" name="Timestamp" nillable="true" type="xs:base64Binary" />
    <xs:element xmlns:q10="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q10:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="CustomerLinkPermission" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Elemente

Das ClientLink-Objekt verfügt über die folgenden Elemente: ClientEntityId, ClientEntityName, ClientEntityNumber, CustomerLinkPermission, ForwardCompatibilityMap, InviterEmail, InviterName, InviterPhone, IsBillToClient, LastModifiedByUserId, LastModifiedDateTime, ManagingCustomerId, ManagingCustomerName, ManagingCustomerNumber, Name, Note, StartDate, Status, SuppressNotification, Timestamp, Type.

Element Beschreibung Datentyp
ClientEntityId Der Bezeichner des zu verwaltenden Kundenkontos oder Kundenkunden

Das Type-Element bestimmt, ob der Link zu einem Kundenkundenkonto oder einem Kunden besteht.

Hinzufügen: Erforderlich. Entweder clientEntityId oder ClientEntityNumber ist erforderlich, aber wenn Sie beide angeben, tritt beim Vorgang ein Fehler auf.
Aktualisieren: Schreibgeschützt und Erforderlich.		 lang
ClientEntityName Der Name des zu verwaltenden Kundenkontos oder Kundenkunden

Das Type-Element bestimmt, ob der Link zu einem Kundenkundenkonto oder einem Kunden besteht.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 Zeichenfolge
ClientEntityNumber Die Nummer des zu verwaltenden Kundenkundenkontos oder Kundenkontos

Das Type-Element bestimmt, ob der Link zu einem Kundenkundenkonto oder einem Kunden besteht.

Hinzufügen: Erforderlich. Entweder clientEntityId oder ClientEntityNumber ist erforderlich, aber wenn Sie beide angeben, tritt beim Vorgang ein Fehler auf.
Aktualisieren: Schreibgeschützt und Erforderlich.		 Zeichenfolge
CustomerLinkPermission Bestimmt, ob der Zugriff des Benutzers auf die Konten durch die Kundenhierarchie eingeschränkt wird, d. h. die Clientverknüpfung auf Kundenebene.

Dieses Element ist nur anwendbar, wenn Type auf CustomerLink festgelegt ist. In diesem Fall sind die möglichen Werte Administrative und Standard. Andernfalls sollte dieses Feld null oder leer sein.

Wenn dieses Feld auf "Administrator" festgelegt ist, hat der Benutzer über einen Administratorkundenlink Zugriff auf die ClientEntityId.

Wenn dieses Feld auf "Standard" festgelegt ist, hat der Benutzer über einen Standard Kundenlink Zugriff auf die ClientEntityId.

ClientEntityId ist Teil einer Kundenlinkhierarchie, in der der Benutzer auf andere Kunden darunter zugreifen kann.

Weitere Informationen finden Sie im technischen Leitfaden zu Benutzerrollen .

Hinzufügen: Wahlfrei
Aktualisieren: Schreibgeschützt		 Zeichenfolge
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 das ClientLink-Objekt .		 KeyValuePairOfstring-Array
InviterEmail Die E-Mail-Adresse des Benutzers, der die Clientlinkanforderung erstellt hat.

Dieser Wert muss nicht mit der E-Mail übereinstimmen, die für den aktuellen authentifizierten Benutzer bereits in Microsoft Advertising gespeichert ist, und wird auch nicht zum Ändern verwendet.

Wenn keine Angabe erfolgt, legt der Dienst diesen Wert auf die E-Mail fest, die für den aktuellen authentifizierten Benutzer bereits in Microsoft Advertising gespeichert ist.

Hinzufügen: Wahlfrei
Aktualisieren: Schreibgeschützt		 Zeichenfolge
InviterName Der Name des übergeordneten Kunden des Benutzers, der die Clientlinkanforderung erstellt hat.

Dieser Wert muss nicht mit dem bereits in Microsoft Advertising gespeicherten Kundennamen identisch sein und wird auch nicht zum Ändern verwendet.

Wenn nicht angegeben, legt der Dienst diesen Wert auf den übergeordneten Kundennamen fest, der bereits in Microsoft Advertising für den aktuellen authentifizierten Benutzer gespeichert ist.

Hinzufügen: Wahlfrei
Aktualisieren: Schreibgeschützt		 Zeichenfolge
InviterPhone Die Telefonnummer des Benutzers, der die Clientlinkanforderung erstellt hat.

Dieser Wert muss nicht mit der Telefonnummer identisch sein, die für den aktuellen authentifizierten Benutzer bereits in Microsoft Advertising gespeichert ist, und wird auch nicht zum Ändern verwendet.

Wenn keine Angabe erfolgt, legt der Dienst diesen Wert auf die Telefonnummer fest, die für den aktuellen authentifizierten Benutzer bereits in Microsoft Advertising gespeichert ist.

Hinzufügen: Wahlfrei
Aktualisieren: Schreibgeschützt		 Zeichenfolge
IsBillToClient Bestimmt, ob der Besitzer des Kundenkundenkontos oder der verwaltende Kunde für Abrechnungszahlungen verantwortlich ist.

Dieses Element gilt nur für Clientlinks für Werbekundenkonten und nicht für Kundenlinks. Das Kundenkundenkonto muss für die Abrechnung nach der Bezahlung eingerichtet werden. Prepaid-Konten werden für die Verwaltung durch Agenturen nicht unterstützt. Bei Festlegung auf true ist der Client für die Abrechnung verantwortlich. Wenn auf false festgelegt ist, ist der verwaltende Kunde für die Abrechnung verantwortlich.

Hinzufügen: Erforderlich für Werbekundenkontolinks; Gilt nicht für Kundenlinks.
Aktualisieren: Schreibgeschützt		 boolean
LastModifiedByUserId Der Bezeichner des letzten Benutzers, der die Informationen des Clientlinks aktualisiert hat.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 lang
LastModifiedDateTime Das Datum und die Uhrzeit der letzten Aktualisierung des Clientlinks. 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
ManagingCustomerId Der Bezeichner des Kunden, der das Kundenkundenkonto verwaltet oder die Verwaltung anfordert.

Hinzufügen: Erforderlich. Entweder ManagingCustomerId oder ManagingCustomerNumber ist erforderlich, aber die Angabe von beidem führt dazu, dass der Vorgang fehlschlägt.
Aktualisieren: Schreibgeschützt und erforderlich		 lang
ManagingCustomerName Der Name des Kunden, der das Kundenkundenkonto verwaltet oder die Verwaltung anfordert.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 Zeichenfolge
ManagingCustomerNumber Die Nummer des Kunden, der das Kundenkundenkonto verwaltet oder die Verwaltung anfordert.

Hinzufügen: Erforderlich. Entweder ManagingCustomerId oder ManagingCustomerNumber ist erforderlich, aber die Angabe von beidem führt dazu, dass der Vorgang fehlschlägt.
Aktualisieren: Schreibgeschützt und erforderlich		 Zeichenfolge
Name Der Anzeigename, der verwendet werden kann, um auf diesen Clientlink zu verweisen.

Der Name darf maximal 40 Zeichen enthalten.

Wenn kein Name angegeben ist, wird ein Standardname angegeben. Der Name muss im Vergleich zu anderen Clientlinks für den Benutzer nicht eindeutig sein.

Hinzufügen: Wahlfrei
Aktualisieren: Schreibgeschützt		 Zeichenfolge
Hinweis Optionale Nachricht des Anforderers mit Kontext und Details zur Einladung zum Clientlink.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 Zeichenfolge
StartDate Das Datum, an dem die status aktualisiert wird. Bei einer akzeptierten Linkanforderung würde die status an diesem Datum in Aktiv übergehen, und bei einer Entlinkungsanforderung würde die status an diesem Datum in Inaktiv übergehen.

Wenn nicht angegeben, wird dieser Wert auf das aktuelle Datum und die aktuelle Uhrzeit festgelegt.

Hinzufügen: Wahlfrei
Aktualisieren: Schreibgeschützt		 dateTime
Status Bestimmt den Lebenszyklus status der Clientverbindung, z. B. ob die Clientverbindung akzeptiert oder abgelehnt wurde.

Beim Hinzufügen einer Clientverbindung kann dieses Element nicht angegeben werden, und der Dienst legt die effektive status auf LinkPending fest.

Hinzufügen: Schreibgeschützt
Aktualisieren: Erforderlich		 ClientLinkStatus
SuppressNotification Bestimmt, ob eine E-Mail-Benachrichtigung über die Clientlink-Einladung an den primären Benutzer des Client-Advertiser-Kontos gesendet werden soll.

Wenn auf true festgelegt ist, erhält der Client keine E-Mail. Andernfalls erhält der Client eine E-Mail-Benachrichtigung, da der Standardwert false ist.

Hinzufügen: Wahlfrei
Aktualisieren: Schreibgeschützt		 boolean
Zeitstempel Reserviert für zukünftige Verwendung. base64Binary
Typ Bestimmt, ob der Link zu einem Kundenkundenkonto oder einem Kunden besteht.

Die möglichen Werte sind AccountLink und CustomerLink. Wenn dieses Element leer oder auf AccountLink festgelegt ist, stellen clientEntityId, ClientEntityName und ClientEntityNumber ein Client-Werbekundenkonto dar. Wenn dieses Element auf CustomerLink festgelegt ist, stellen clientEntityId, ClientEntityName und ClientEntityNumber einen Clientkunden dar.

Hinzufügen: Wahlfrei. Wenn dieses Element nicht festgelegt ist, versucht der Dienst, einen Clientlink für ein Werbekundenkonto zu erstellen.
Aktualisieren: Schreibgeschützt		 Zeichenfolge

Anforderungen

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

Verwendet von

AddClientLinks
SearchClientLinks
UpdateClientLinks