Die Google Ads API unterstützt die Verknüpfung von Google Ads-Konten mit anderen Produktkonten. In diesem Leitfaden wird erläutert, wie Sie mit Version 16 der API Ihre Konten verknüpfen.
Methoden zum Verknüpfen von Konten
Wenn Sie ein Google Ads-Konto mit einem anderen Produktkonto verknüpfen, gibt es zwei Möglichkeiten.
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 Administrator des Produktkontos 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 Produktkontoadministrator 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 |
|---|---|---|
| Situation 1 | Einladung erstellen | Verwenden Sie die Methode
ProductLinkInvitationService.CreateProductLinkInvitation, um eine Einladung zu erstellen. Für den status des
ProductLinkInvitation-Objekts darf nicht festgelegt werden. Nach erfolgreichem Abschluss des API-Aufrufs setzt der Google Ads API-Server ihn 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. |
| Einladung annehmen oder ablehnen | Verwenden Sie die Methode
ProductLinkInvitationService.UpdateProductLinkInvitation, um den Status von
ProductLinkInvitation auf ACCEPTED oder REJECTED zu aktualisieren. |
|
| Einladungen zurücknehmen | Verwenden Sie die Methode
ProductLinkInvitationService.RemoveProductLinkInvitation, um einen vorhandenen
ProductLinkInvitation zu widerrufen. |
Folgende Fehler können in diesem Workflow 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 eine aktive Verknüpfung direkt mit ProductLinkService erstellen. |
Direkte 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 versenden.
In diesem Szenario werden die folgenden Methoden verwendet:
| Aktion | Anmerkungen |
|---|---|
| Aktiven Link erstellen | Verwende
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. |
Bei diesem Workflow können folgende Fehler auftreten:
| Fehlercode | Erklärung |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
Es wurde versucht, eine Kontoverknüpfung über die direkte Verknüpfung zu versuchen. Dieser Vorgang wird jedoch aufgrund fehlender Berechtigungen nicht unterstützt. Der Nutzer sollte für die Einladung stattdessen ProductLinkInvitationService verwenden.
|
ProductLinkError.INVITATION_EXISTS |
Es kann kein Link erstellt werden, da bereits eine ausstehende Einladung vorhanden ist. |
Änderungen an AccountLinkService und MerchantCenterLinkService
Wenn Sie in der Vergangenheit MerchantCenterLinkService oder AccountLinkService verwendet haben, um ein Google Ads-Konto mit einem anderen Produktkonto zu verknüpfen, müssen Sie Ihre vorhandene Anwendung in einen der oben aufgeführten Workflows migrieren. Die folgende Tabelle zeigt den Migrationsstatus:
| Linktyp | In neuen Diensten unterstützt? | Support verfügbar ab | Anmerkungen |
|---|---|---|---|
DataPartnerIdentifier |
Ja | v15 | MerchantCenterLinkService migrieren |
GoogleAdsIdentifier |
Ja | v16 | AccountLinkService deaktivieren |
MerchantCenterIdentifier |
Ja | v16 | AccountLinkService deaktivieren |
AdvertisingPartnerIdentifier |
Ja | v16 | AccountLinkService deaktivieren |
ThirdPartyAppAnalyticsLinkIdentifier |
Nein | – | AccountLinkService weiterhin verwenden |