Freigeben über

AddClientLinks-Dienstvorgang – Kundenverwaltung

  • Artikel

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 Inserentenkonten 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:e465="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e465:ClientLink>
          <e465:Type i:nil="false">ValueHere</e465:Type>
          <e465:ClientEntityId i:nil="false">ValueHere</e465:ClientEntityId>
          <e465:ClientEntityNumber i:nil="false">ValueHere</e465:ClientEntityNumber>
          <e465:ClientEntityName i:nil="false">ValueHere</e465:ClientEntityName>
          <e465:ManagingCustomerId i:nil="false">ValueHere</e465:ManagingCustomerId>
          <e465:ManagingCustomerNumber i:nil="false">ValueHere</e465:ManagingCustomerNumber>
          <e465:ManagingCustomerName i:nil="false">ValueHere</e465:ManagingCustomerName>
          <e465:Note i:nil="false">ValueHere</e465:Note>
          <e465:Name i:nil="false">ValueHere</e465:Name>
          <e465:InviterEmail i:nil="false">ValueHere</e465:InviterEmail>
          <e465:InviterName i:nil="false">ValueHere</e465:InviterName>
          <e465:InviterPhone i:nil="false">ValueHere</e465:InviterPhone>
          <e465:IsBillToClient i:nil="false">ValueHere</e465:IsBillToClient>
          <e465:StartDate i:nil="false">ValueHere</e465:StartDate>
          <e465:Status i:nil="false">ValueHere</e465:Status>
          <e465:SuppressNotification>ValueHere</e465:SuppressNotification>
          <e465:LastModifiedDateTime>ValueHere</e465:LastModifiedDateTime>
          <e465:LastModifiedByUserId>ValueHere</e465:LastModifiedByUserId>
          <e465:Timestamp i:nil="false">ValueHere</e465:Timestamp>
          <e465:ForwardCompatibilityMap xmlns:e466="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
            <e466:KeyValuePairOfstringstring>
              <e466:key i:nil="false">ValueHere</e466:key>
              <e466:value i:nil="false">ValueHere</e466:value>
            </e466:KeyValuePairOfstringstring>
          </e465:ForwardCompatibilityMap>
          <e465:CustomerLinkPermission i:nil="false">ValueHere</e465:CustomerLinkPermission>
        </e465: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:e467="https://bingads.microsoft.com/Customer/v13/Exception" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <e467:OperationError>
          <e467:Code>ValueHere</e467:Code>
          <e467:Details d4p1:nil="false">ValueHere</e467:Details>
          <e467:Message d4p1:nil="false">ValueHere</e467:Message>
        </e467:OperationError>
      </OperationErrors>
      <PartialErrors xmlns:e468="https://bingads.microsoft.com/Customer/v13/Exception" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <e468:ArrayOfOperationError>
          <e468:OperationError>
            <e468:Code>ValueHere</e468:Code>
            <e468:Details d4p1:nil="false">ValueHere</e468:Details>
            <e468:Message d4p1:nil="false">ValueHere</e468:Message>
          </e468:OperationError>
        </e468: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

Anforderungs-URL

https://clientcenter.api.bingads.microsoft.com/CustomerManagement/v13/ClientLinks

Anfordern von Elementen

Das AddClientLinksRequest-Objekt definiert die Body- und Headerelemente der Dienstvorgangsanforderung.

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
Authorization Das OAuth-Zugriffstoken, das die Anmeldeinformationen eines Benutzers darstellt, der über Berechtigungen für Microsoft Advertising-Konten verfügt. Stellen Sie sicher, dass dem Token das Präfix "Bearer" vorangestellt ist. Dies ist für die ordnungsgemäße Authentifizierung erforderlich.

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 wie im Antwort-JSON-Code gezeigt.

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

JSON anfordern

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

{
  "ClientLinks": [
    {
      "ClientEntityId": "LongValueHere",
      "ClientEntityName": "ValueHere",
      "ClientEntityNumber": "ValueHere",
      "CustomerLinkPermission": "ValueHere",
      "ForwardCompatibilityMap": [
        {
          "key": "ValueHere",
          "value": "ValueHere"
        }
      ],
      "InviterEmail": "ValueHere",
      "InviterName": "ValueHere",
      "InviterPhone": "ValueHere",
      "IsBillToClient": "ValueHere",
      "LastModifiedByUserId": "LongValueHere",
      "LastModifiedDateTime": "ValueHere",
      "ManagingCustomerId": "LongValueHere",
      "ManagingCustomerName": "ValueHere",
      "ManagingCustomerNumber": "ValueHere",
      "Name": "ValueHere",
      "Note": "ValueHere",
      "StartDate": "ValueHere",
      "Status": "ValueHere",
      "SuppressNotification": "ValueHere",
      "Timestamp": "ValueHere",
      "Type": "ValueHere"
    }
  ]
}

Antwort-JSON

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

{
  "OperationErrors": [
    {
      "Code": IntValueHere,
      "Details": "ValueHere",
      "Message": "ValueHere"
    }
  ],
  "PartialErrors": [
    {
      "Code": IntValueHere,
      "Details": "ValueHere",
      "Message": "ValueHere"
    }
  ]
}

Codesyntax

Um die REST-API über SDKs aufzurufen, müssen Sie das SDK auf eine bestimmte Version aktualisieren und die Systemparameter konfigurieren. 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)