Die Google Ads API unterstützt die Verknüpfung von Google Ads-Konten mit anderen Produktkonten. In diesem Leitfaden erfahren Sie, wie Sie Ihre Konten mithilfe der API verknüpfen.
Möglichkeiten zum Verknüpfen von Konten
Wenn Sie ein Google Ads-Konto mit einem anderen Produktkonto verknüpfen, kann die Verknüpfung auf zwei verschiedene Arten erfolgen.
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:
- 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.
- Der Produktkontoadministrator 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 eine aktive Verknüpfung direkt zu erstellen. |
Ablauf der direkten Verknüpfung
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 |
|---|---|
| Aktive Verknüpfung erstellen | Verwenden Sie
ProductLinkService.createProductLink, um einen ProductLink zu erstellen. |
| Aktive Verknüpfung 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 am 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 und verwenden Sie ProductLinkService:
GoogleAdsIdentifierMerchantCenterIdentifierAdvertisingPartnerIdentifier
Verwenden Sie für ThirdPartyAppAnalyticsLinkIdentifier weiterhin AccountLinkService.