Produktkonten verknüpfen

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

Konten 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, die Sie annehmen und die Verknüpfung abschließen.

In diesem Szenario werden die folgenden Methoden verwendet:

Szenario	Aktion	Anmerkungen
Szenario 1	Einladung erstellen	Verwenden Sie die Methode ProductLinkInvitationService.CreateProductLinkInvitation, um eine Einladung zu erstellen. Die status des ProductLinkInvitation darf nicht festgelegt werden. Der Google Ads API-Server legt sie 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 Methode ProductLinkInvitationService.UpdateProductLinkInvitation, um den Status von ProductLinkInvitation auf ACCEPTED oder REJECTED zu aktualisieren.
	Einladung widerrufen	Verwenden Sie die Methode ProductLinkInvitationService.RemoveProductLinkInvitation, um ein vorhandenes ProductLinkInvitation zu widerrufen.

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

Fehlercode	Erklärung
ProductLinkInvitationError.PERMISSION_DENIED	Der Kunde ist nicht berechtigt, diese Aktion auszuführen.
ProductLinkError.NO_INVITATION_REQUIRED	Eine Einladung konnte nicht erstellt werden, da der Nutzer bereits Administratorzugriff auf das eingeladene Konto hat. Der Nutzer sollte den ProductLinkService verwenden, um direkt einen aktiven Link zu erstellen.

Ablauf für Deep-Linking

Der Ablauf für die direkte Verknüpfung 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
Aktiven Link erstellen	Verwenden Sie ProductLinkService.createProductLink, um eine ProductLink zu erstellen.
Aktiven Link deaktivieren	Verwenden Sie ProductLinkService.removeProductLink, um eine aktive ProductLink zu entfernen.
Aktive Links abrufen	Verwenden Sie GoogleAdsService.Search oder GoogleAdsService.SearchStream, um die Ressource product_link abzufragen.

In 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 Direktlink-Ablauf herzustellen. Dies wird jedoch aufgrund fehlender Berechtigungen nicht unterstützt. Der Nutzer sollte stattdessen ProductLinkInvitationService verwenden, um den Einladungsprozess durchzuführen.
ProductLinkError.INVITATION_EXISTS	Ein Link kann nicht erstellt werden, da bereits eine ausstehende Einladung vorhanden ist.

Vorhandene Produktlinks abrufen

Sie können alle Produktlinks, die mit Ihrem Google Ads-Konto verknüpft sind, mit einer GAQL-Abfrage für die Ressource product_link abrufen.

    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 Dienstes an. Je nach type werden andere Felder in der product_link-Ressource ausgefüllt, um weitere Details zum Link zu liefern. Wenn der Typ beispielsweise THIRD_PARTY_APP_ANALYTICS ist, enthält das Feld third_party_app_analytics Informationen zum Analyseanbieter.

So können Sie eine Liste externer Dienste und Anwendungen abrufen, die direkt mit Ihrem Google Ads-Konto verknüpft sind, z. B. Google Play, Datenpartner oder Drittanbieterplattformen für App-Analysen.

Ä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 Linktypen von AccountLinkService zu ProductLinkService:

• GoogleAdsIdentifier
• MerchantCenterIdentifier
• AdvertisingPartnerIdentifier

Verwenden Sie für ThirdPartyAppAnalyticsLinkIdentifier weiterhin AccountLinkService.