Über die Google Ads API können Google Ads-Konten mit Konten anderer Produkte verknüpft werden. In diesem Leitfaden erfahren Sie, wie Sie Version 16 des APIs verwenden, um Ihre Konten zu 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, 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 diese an und schließen die Verknüpfung ab.
In diesem Szenario werden die folgenden Methoden verwendet:
| Szenario | Vorgang | Anmerkungen |
|---|---|---|
| Situation 1 | Einladung erstellen | Verwenden Sie die Methode
ProductLinkInvitationService.CreateProductLinkInvitation, um eine Einladung zu erstellen. Die status von
ProductLinkInvitation sollte nicht festgelegt werden. Der Google Ads API-Server legt diesen Wert nach erfolgreicher Ausführung des API-Aufrufs auf REQUESTED fest. |
| Status einer Einladung prüfen | Verwenden Sie GoogleAdsService.Search oder GoogleAdsService.SearchStream, um die product_link_invitation-Ressource 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 ein vorhandenes
ProductLinkInvitation-Objekt 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 |
Die 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:
| Vorgang | Anmerkungen |
|---|---|
| Aktive Verknüpfung erstellen | Verwenden Sie
ProductLinkService.createProductLink, um einen ProductLink zu erstellen. |
| Aktive Verknüpfung deaktivieren | Verwenden Sie
ProductLinkService.removeProductLink, um einen aktiven ProductLink zu entfernen. |
| Aktive Verknüpfungen abrufen | Verwenden Sie
GoogleAdsService.Search oder GoogleAdsService.SearchStream, um die Ressource
product_link abzufragen. |
Die folgenden häufigen Fehler können in diesem Workflow auftreten:
| Fehlercode | Erklärung |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
Es wurde versucht, eine Kontoverknüpfung über die direkte Verknüpfung durchzuführen. Dies wird jedoch aufgrund fehlender Berechtigungen nicht unterstützt. Der Nutzer sollte stattdessen ProductLinkInvitationService verwenden, um den Einladungsvorgang auszuführen.
|
ProductLinkError.INVITATION_EXISTS |
Es kann keine Verknüpfung erstellt werden, da bereits eine ausstehende Einladung vorhanden ist. |
Änderungen an „AccountLinkService“ und „MerchantCenterLinkService“
Wenn Sie in der Vergangenheit über MerchantCenterLinkService oder AccountLinkService ein Google Ads-Konto mit einem anderen Produktkonto verknüpft haben, müssen Sie Ihre vorhandene Anwendung zu einem 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 | Aus dem MerchantCenterLinkService migrieren |
GoogleAdsIdentifier |
Ja | v16 | AccountLinkService aus dem Konto migrieren |
MerchantCenterIdentifier |
Ja | v16 | AccountLinkService aus dem Konto migrieren |
AdvertisingPartnerIdentifier |
Ja | v16 | AccountLinkService aus dem Konto migrieren |
ThirdPartyAppAnalyticsLinkIdentifier |
Nein | – | AccountLinkService weiterhin verwenden |