Produktkonten verknüpfen

Die Google Ads API unterstützt die Verknüpfung von Google Ads-Konten mit anderen Produktkonten. In dieser Anleitung wird erläutert, wie Sie die API verwenden, um Ihre Konten zu verknüpfen.

Wenn Sie ein Google Ads-Konto mit einem anderen Produktkonto verknüpfen, gibt es zwei verschiedene Möglichkeiten.

Einladungsablauf

Der Einladungsablauf wird verwendet, wenn Sie Administratorzugriff auf das Google Ads-Konto, aber nicht auf das Produktkonto haben. Dieser Ablauf funktioniert in zwei Szenarien:

  1. Sie möchten die beiden Konten verknüpfen und eine Einladung für einen Administrator des Produktkontos erstellen. Der Administrator des Produktkontos nimmt die Einladung an, um die Kontoverknüpfung abzuschließen.
  2. Der Administrator des Produktkontos möchte die beiden Konten verknüpfen, hat aber keinen Zugriff auf das Google Ads-Konto. Der Administrator des Produktkontos erstellt eine Einladung. Sie nehmen die Einladung an und schließen die Verknüpfung ab.

In diesem Szenario werden die folgenden Methoden verwendet:

Szenario Aktion Anmerkungen
Szenario 1 Einladung erstellen Verwenden Sie die ProductLinkInvitationService.CreateProductLinkInvitation Methode , um eine Einladung zu erstellen. Der status des ProductLinkInvitation sollte nicht festgelegt werden. Der Google Ads API-Server legt ihn nach erfolgreichem Abschluss des API-Aufrufs auf REQUESTED fest.
Status einer Einladung prüfen Verwenden Sie GoogleAdsService.Search oder GoogleAdsService.SearchStream , um die Ressource product_link_invitation abzufragen und ihren Status zu prüfen.
Szenario 2 Einladung abrufen Verwenden Sie GoogleAdsService.Search oder GoogleAdsService.SearchStream , um die Ressource product_link_invitation abzufragen. Filtern Sie nach status = PENDING_APPROVAL, um eine ausstehende Einladung anzunehmen oder abzulehnen.
Einladung annehmen oder ablehnen Verwenden Sie die ProductLinkInvitationService.UpdateProductLinkInvitation Methode, um den Status des ProductLinkInvitation in ACCEPTED oder REJECTED zu ändern.
Einladung widerrufen Verwenden Sie die ProductLinkInvitationService.RemoveProductLinkInvitation Methode, um ein vorhandenes ProductLinkInvitation zu widerrufen.

Bei diesem Workflow können die folgenden häufigen Fehler auftreten:

Fehlercode Erklärung
ProductLinkInvitationError.PERMISSION_DENIED Der Kunde hat keine Berechtigung, diese Aktion auszuführen.
ProductLinkError.NO_INVITATION_REQUIRED Eine Einladung konnte nicht erstellt werden, da der Nutzer bereits Administrator Zugriff auf das eingeladene Konto hat. Der Nutzer sollte den ProductLinkService verwenden, um direkt eine aktive Verknüpfung zu erstellen.

Direkter Verknüpfungsablauf

Der direkte Verknüpfungsablauf wird verwendet, wenn Sie Administratorzugriff auf das Google Ads-Konto und das Produktkonto haben. In diesem Fall verknüpfen Sie das Google Ads-Konto direkt mit dem Produktkonto, anstatt eine Einladung zu senden.

In diesem Szenario werden die folgenden Methoden verwendet:

Aktion Anmerkungen
Aktive Verknüpfung erstellen Verwenden Sie ProductLinkService.createProductLink, um ein ProductLink zu erstellen.
Aktive Verknüpfung deaktivieren Verwenden Sie ProductLinkService.removeProductLink, um ein aktives ProductLink zu entfernen.
Aktive Verknüpfungen abrufen Verwenden Sie GoogleAdsService.Search oder GoogleAdsService.SearchStream , um die Ressource product_link abzufragen.

Bei diesem Workflow können die folgenden häufigen Fehler auftreten:

Fehlercode Erklärung
ProductLinkError.CREATION_NOT_PERMITTED Es wurde versucht, eine Kontoverknüpfung über den direkten Verknüpfungsablauf zu erstellen. Dies wird jedoch aufgrund fehlender Berechtigungen nicht unterstützt. Der Nutzer sollte stattdessen ProductLinkInvitationService verwenden, um den Einladungsablauf zu nutzen.
ProductLinkError.INVITATION_EXISTS Eine Verknüpfung kann nicht erstellt werden, da bereits eine ausstehende Einladung vorhanden ist.

Sie können alle Produktverknüpfungen abrufen, die mit Ihrem Google Ads-Konto verknüpft sind. Dazu verwenden Sie eine GAQL-Abfrage für die product_link Ressource.

    SELECT
      product_link.product_link_id,
      product_link.type
    FROM product_link

Das Feld product_link.type gibt den Typ des verknüpften Produkts oder der verknüpften Dienstleistung an. Je nach type werden andere Felder in der Ressource product_link ausgefüllt, die weitere Details zur Verknüpfung enthalten. Wenn der Typ beispielsweise THIRD_PARTY_APP_ANALYTICS ist, enthält das Feld third_party_app_analytics Informationen zum Analytics-Anbieter.

So erhalten Sie eine Liste der externen Dienste und Anwendungen, die direkt mit Ihrem Google Ads-Konto verknüpft sind, z. B. Google Play, Datenpartner oder App-Analyseplattformen von Drittanbietern.

Änderungen an AccountLinkService

Wenn Sie AccountLinkService verwenden, um ein Google Ads-Konto mit einem anderen Produktkonto zu verknüpfen, müssen Sie Ihre vorhandene Anwendung zu einem der oben aufgeführten Workflows migrieren. Migrieren Sie für die folgenden Verknüpfungstypen von AccountLinkService zu ProductLinkService:

  • GoogleAdsIdentifier
  • MerchantCenterIdentifier
  • AdvertisingPartnerIdentifier

Verwenden Sie für ThirdPartyAppAnalyticsLinkIdentifier weiterhin AccountLinkService.

Zurück
Einladungen zum Nutzerzugriff verwalten
Weiter
YouTube verknüpfen