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 mit der Sie 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 der 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 zurücknehmen	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 Direktverlinkung

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	Mit ProductLinkService.createProductLink können Sie eine ProductLink erstellen.
Aktiven Link deaktivieren	Mit ProductLinkService.removeProductLink können Sie eine aktive ProductLink 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.

Ä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.