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 Ihre Konten mithilfe der API verknüpfen.

Möglichkeiten zum Verknüpfen von Konten

Es gibt zwei Möglichkeiten, ein Google Ads-Konto mit einem anderen Produktkonto zu verknüpfen.

Einladungsablauf

Der Einladungsvorgang 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 Produktkontoadministrator 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 sendet Ihnen 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
Situation 1	Einladung erstellen	Verwenden Sie die Methode ProductLinkInvitationService.CreateProductLinkInvitation, um eine Einladung zu erstellen. Der Wert status für das ProductLinkInvitation sollte nicht festgelegt werden. Der Google Ads API-Server setzt ihn nach erfolgreichem Abschluss des API-Aufrufs auf REQUESTED.
	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.
Situation 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.
	Einladungen 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 eine vorhandene 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.

Direkte Verknüpfung

Dieser Ablauf wird verwendet, wenn Sie Administratorzugriff sowohl auf das Google Ads-Konto als auch auf 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	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 direkten Linkfluss vorzunehmen. Dies wird jedoch aufgrund fehlender Berechtigungen nicht unterstützt. Der Nutzer sollte stattdessen ProductLinkInvitationService verwenden, um den Einladungsvorgang auszufü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. Für die folgenden Linktypen sollten Sie AccountLinkService aufgeben und ProductLinkService verwenden:

• GoogleAdsIdentifier
• MerchantCenterIdentifier
• AdvertisingPartnerIdentifier

Verwenden Sie für ThirdPartyAppAnalyticsLinkIdentifier weiterhin AccountLinkService.