Über die Google Ads API können Google Ads-Konten mit anderen Produktkonten verknüpft werden. In diesem Leitfaden 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
Verwenden Sie den Einladungsablauf, 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 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 den Verknüpfungsprozess 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. Wenn Sie eine Einladung für einen Werbepartner (AdvertisingPartnerLinkInvitationIdentifier) erstellen, ist advertising_partner_properties.allowed_domain ab Version 25 erforderlich (und in Version 24 und früher optional). |
| 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 widerrufen | 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. |
ProductLinkInvitationError.NO_INVITATION_REQUIRED |
Es konnte keine Einladung 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 die direkte Verknüpfung
Verwenden Sie den Ablauf für die direkte Verknüpfung, wenn Sie Administratorzugriff auf das Google Ads-Konto und das Produktkonto haben. Verknüpfen Sie in diesem Fall 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 | 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. |
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. |
Vorhandene Produktlinks abrufen
Sie können alle Produktlinks abrufen, die mit Ihrem Google Ads-Konto verknüpft sind, indem Sie eine GAQL-Abfrage für die Ressource product_link ausführen.
SELECT
product_link.product_link_id,
product_link.type
FROM product_link
Das Feld product_link.type gibt den Typ des verknüpften Produkts oder der verknüpften Dienstleistung an.
Je nach type werden andere Felder in der product_link-Ressource ausgefüllt, um weitere Details zum Link zu liefern. Wenn der Typ beispielsweise DATA_PARTNER ist, enthält das Feld data_partner Informationen zum verknüpften Konto des Datenpartners.
So können Sie eine Liste der externen Dienste und Produktkonten abrufen, die direkt mit Ihrem Google Ads-Konto verknüpft sind, z. B. Merchant Center, Google Ads, Werbepartner oder Datenpartner.
Ä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:
Verwenden Sie für ThirdPartyAppAnalyticsLinkIdentifier weiterhin AccountLinkService.