AddClientLinks-Dienstvorgang – Kundenverwaltung

Artikel
12/21/2023

Initiiert den Clientlinkprozess zum Verwalten der Konten eines anderen Kunden. Sendet eine Linkanforderung von einem Kunden an einen anderen Kunden oder ein anderes Konto.

Hinweis

Nur ein Benutzer mit Super Admin- oder Standard-Anmeldeinformationen kann Clientlinks zu Werbekundenkonten hinzufügen, aktualisieren und danach suchen. Nur ein Benutzer mit Super admin-Anmeldeinformationen kann Clientlinks zu Kunden hinzufügen, aktualisieren und danach suchen. Weitere Informationen finden Sie im technischen Leitfaden zu Benutzerrollen .

Es gibt keine festgelegte Beschränkung für die Anzahl von Kundenkonten, die mit einer Agentur verknüpft werden können. Für das Kundenkonto muss ein gültiges Zahlungsmittel für die Nachzahlung eingerichtet sein. Prepaid-Konten werden für die Verwaltung durch Agenturen nicht unterstützt.

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 .

Anfordern von Elementen

Das AddClientLinksRequest-Objekt definiert die Body - und Headerelemente der Dienstvorgangsanforderung. Die Elemente müssen in der gleichen Reihenfolge wie im Anforderungs-SOAP dargestellt sein.

Hinweis

Sofern unten nicht anders angegeben, sind alle Anforderungselemente erforderlich.

Anforderungstextelemente

Element	Beschreibung	Datentyp
ClientLinks	Die Liste der hinzuzufügenden Clientlinks. Sie sollten Ihre Anforderung auf 10 Clientlinks pro Anruf beschränken.	ClientLink-Array

Anforderungsheaderelemente

Element	Beschreibung	Datentyp
AuthenticationToken	Das OAuth-Zugriffstoken, das die Anmeldeinformationen eines Benutzers darstellt, der über Berechtigungen für Microsoft Advertising-Konten verfügt. Weitere Informationen finden Sie unter Authentifizierung mit OAuth.	Zeichenfolge
DeveloperToken	Das Entwicklertoken, das für den Zugriff auf die Bing Ads-API verwendet wird. Weitere Informationen finden Sie unter Abrufen eines Entwicklertokens.	Zeichenfolge
Kennwort	Dieses Element ist für die interne Verwendung reserviert und wird aus einer zukünftigen Version der API entfernt. Sie müssen das AuthenticationToken-Element verwenden, um Benutzeranmeldeinformationen festzulegen.	Zeichenfolge
UserName	Dieses Element ist für die interne Verwendung reserviert und wird aus einer zukünftigen Version der API entfernt. Sie müssen das AuthenticationToken-Element verwenden, um Benutzeranmeldeinformationen festzulegen.	Zeichenfolge

Antwortelemente

Das AddClientLinksResponse-Objekt definiert den Text und die Headerelemente der Dienstvorgangsantwort. Die Elemente werden in der gleichen Reihenfolge zurückgegeben, in der die Antwort-SOAP gezeigt wird.

Antworttextelemente

Element	Beschreibung	Datentyp
OperationErrors	Eine Liste mit mindestens einem Grund, warum der Dienstvorgang fehlgeschlagen ist und keine Clientlinks hinzugefügt wurden.	OperationError-Array
PartialErrors	Ein Array von OperationError-Listen , die Details für alle Clientlinks enthalten, die nicht erfolgreich hinzugefügt wurden. Die Ergebnisse werden in der gleichen Reihenfolge zurückgegeben, die den angeforderten Clientlinks entspricht. Die Anzahl der ersten Dimensionslistenelemente entspricht der anzahl der angeforderten Clientlinks. Bei erfolgreich hinzugefügten Clientlinks ist das OperationError-Element am entsprechenden Index NULL.	OperationError-Array

Antwortheaderelemente

Element	Beschreibung	Datentyp
TrackingId	Der Bezeichner des Protokolleintrags, der die Details des API-Aufrufs enthält.	Zeichenfolge

SOAP anfordern

Diese Vorlage wurde von einem Tool generiert, um die Reihenfolge der Text- und Headerelemente für die SOAP-Anforderung anzuzeigen. Informationen zu unterstützten Typen, die Sie mit diesem Dienstvorgang verwenden können, finden Sie oben in der Referenz zu Anforderungstextelementen .

<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
    <Action mustUnderstand="1">AddClientLinks</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <AddClientLinksRequest xmlns="https://bingads.microsoft.com/Customer/v13">
      <ClientLinks xmlns:e221="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e221:ClientLink>
          <e221:Type i:nil="false">ValueHere</e221:Type>
          <e221:ClientEntityId i:nil="false">ValueHere</e221:ClientEntityId>
          <e221:ClientEntityNumber i:nil="false">ValueHere</e221:ClientEntityNumber>
          <e221:ClientEntityName i:nil="false">ValueHere</e221:ClientEntityName>
          <e221:ManagingCustomerId i:nil="false">ValueHere</e221:ManagingCustomerId>
          <e221:ManagingCustomerNumber i:nil="false">ValueHere</e221:ManagingCustomerNumber>
          <e221:ManagingCustomerName i:nil="false">ValueHere</e221:ManagingCustomerName>
          <e221:Note i:nil="false">ValueHere</e221:Note>
          <e221:Name i:nil="false">ValueHere</e221:Name>
          <e221:InviterEmail i:nil="false">ValueHere</e221:InviterEmail>
          <e221:InviterName i:nil="false">ValueHere</e221:InviterName>
          <e221:InviterPhone i:nil="false">ValueHere</e221:InviterPhone>
          <e221:IsBillToClient i:nil="false">ValueHere</e221:IsBillToClient>
          <e221:StartDate i:nil="false">ValueHere</e221:StartDate>
          <e221:Status i:nil="false">ValueHere</e221:Status>
          <e221:SuppressNotification>ValueHere</e221:SuppressNotification>
          <e221:LastModifiedDateTime>ValueHere</e221:LastModifiedDateTime>
          <e221:LastModifiedByUserId>ValueHere</e221:LastModifiedByUserId>
          <e221:Timestamp i:nil="false">ValueHere</e221:Timestamp>
          <e221:ForwardCompatibilityMap xmlns:e222="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
            <e222:KeyValuePairOfstringstring>
              <e222:key i:nil="false">ValueHere</e222:key>
              <e222:value i:nil="false">ValueHere</e222:value>
            </e222:KeyValuePairOfstringstring>
          </e221:ForwardCompatibilityMap>
          <e221:CustomerLinkPermission i:nil="false">ValueHere</e221:CustomerLinkPermission>
        </e221:ClientLink>
      </ClientLinks>
    </AddClientLinksRequest>
  </s:Body>
</s:Envelope>

Antwort-SOAP

Diese Vorlage wurde von einem Tool generiert, um die Reihenfolge der Text- und Headerelemente für die SOAP-Antwort anzuzeigen.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <AddClientLinksResponse xmlns="https://bingads.microsoft.com/Customer/v13">
      <OperationErrors xmlns:e223="https://bingads.microsoft.com/Customer/v13/Exception" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <e223:OperationError>
          <e223:Code>ValueHere</e223:Code>
          <e223:Details d4p1:nil="false">ValueHere</e223:Details>
          <e223:Message d4p1:nil="false">ValueHere</e223:Message>
        </e223:OperationError>
      </OperationErrors>
      <PartialErrors xmlns:e224="https://bingads.microsoft.com/Customer/v13/Exception" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <e224:ArrayOfOperationError>
          <e224:OperationError>
            <e224:Code>ValueHere</e224:Code>
            <e224:Details d4p1:nil="false">ValueHere</e224:Details>
            <e224:Message d4p1:nil="false">ValueHere</e224:Message>
          </e224:OperationError>
        </e224:ArrayOfOperationError>
      </PartialErrors>
    </AddClientLinksResponse>
  </s:Body>
</s:Envelope>

Codesyntax

Die Beispielsyntax kann mit Bing Ads SDKs verwendet werden. Weitere Beispiele finden Sie unter Codebeispiele für die Bing Ads-API .

public async Task<AddClientLinksResponse> AddClientLinksAsync(
	IList<ClientLink> clientLinks)
{
	var request = new AddClientLinksRequest
	{
		ClientLinks = clientLinks
	};

	return (await CustomerManagementService.CallAsync((s, r) => s.AddClientLinksAsync(r), request));
}

static AddClientLinksResponse addClientLinks(
	ArrayOfClientLink clientLinks) throws RemoteException, Exception
{
	AddClientLinksRequest request = new AddClientLinksRequest();

	request.setClientLinks(clientLinks);

	return CustomerManagementService.getService().addClientLinks(request);
}

static function AddClientLinks(
	$clientLinks)
{

	$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];

	$request = new AddClientLinksRequest();

	$request->ClientLinks = $clientLinks;

	return $GLOBALS['CustomerManagementProxy']->GetService()->AddClientLinks($request);
}

response=customermanagement_service.AddClientLinks(
	ClientLinks=ClientLinks)

Anforderungen

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

Freigeben über

AddClientLinks-Dienstvorgang – Kundenverwaltung

Anfordern von Elementen

Anforderungstextelemente

Anforderungsheaderelemente

Antwortelemente

Antworttextelemente

Antwortheaderelemente

SOAP anfordern

Antwort-SOAP

Codesyntax

Anforderungen

Feedback

Zusätzliche Ressourcen