Die Google Ads API unterstützt die Verknüpfung von Google Ads-Konten mit anderen Produktkonten. In dieser Anleitung wird erläutert, wie Sie die API 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, 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 Administrator des Produktkontos 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. Sie nehmen die Einladung an und schließen die Verknüpfung ab.
Verwenden Sie in diesem Szenario die folgenden Methoden:
| Szenario | Aktion | Anmerkungen |
|---|---|---|
| Szenario 1 | Einladung erstellen | Verwenden Sie die
ProductLinkInvitationService.CreateProductLinkInvitation Methode
, um eine Einladung zu erstellen. Der status
von
ProductLinkInvitation sollte nicht festgelegt werden. Der Google Ads API-Server
legt ihn nach erfolgreichem Abschluss
des API-Aufrufs auf REQUESTED fest. Wenn Sie eine Einladung für einen Werbepartner
(AdvertisingPartnerLinkInvitationIdentifier),
advertising_partner_properties.allowed_domain
ist 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
ProductLinkInvitationService.UpdateProductLinkInvitation Methode, um
den Status von
ProductLinkInvitation auf ACCEPTED oder
REJECTED zu aktualisieren. |
|
| Einladung widerrufen | Verwenden Sie die
ProductLinkInvitationService.RemoveProductLinkInvitation Methode, 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. |
ProductLinkInvitationError.NO_INVITATION_REQUIRED |
Eine Einladung konnte nicht erstellt werden, da der Nutzer bereits Administrator Zugriff auf das eingeladene Konto hat. Der Nutzer sollte den ProductLinkService verwenden, um direkt eine aktive Verknüpfung zu erstellen. |
Direkte Verknüpfung
Verwenden Sie die direkte Verknüpfung, wenn Sie Administratorzugriff auf das Google Ads-Konto und das Produktkonto haben. In diesem Fall können Sie das Google Ads-Konto direkt mit dem Produktkonto verknüpfen, anstatt eine Einladung zu senden.
Verwenden Sie in diesem Szenario die folgenden Methoden:
| Aktion | Anmerkungen |
|---|---|
| Aktive Verknüpfung erstellen | Verwenden Sie
ProductLinkService.CreateProductLink, um eine
ProductLink zu erstellen. |
| Aktive Verknüpfung deaktivieren | Verwenden Sie
ProductLinkService.RemoveProductLink, um eine
aktive
ProductLink zu entfernen. |
| Aktive Verknüpfungen 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 die direkte Verknüpfung zu erstellen. Dies wird jedoch aufgrund fehlender Berechtigungen nicht unterstützt.
Der Nutzer sollte stattdessen
ProductLinkInvitationService
verwenden, um den Einladungsablauf zu nutzen.
|
ProductLinkError.INVITATION_EXISTS |
Eine Verknüpfung kann nicht erstellt werden, da bereits eine ausstehende Einladung vorhanden ist. |
Vorhandene Produktverknüpfungen abrufen
Sie können alle Produktverknüpfungen abrufen, die mit Ihrem Google Ads-Konto verknüpft sind. Verwenden Sie dazu
eine GAQL-Abfrage für die product_link Ressource.
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 Ressource product_link ausgefüllt, die weitere Details zur Verknüpfung enthalten. Wenn der Typ beispielsweise DATA_PARTNER ist, enthält das Feld data_partner Informationen zum verknüpften Datenpartnerkonto.
So können Sie eine Liste externer 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
Workflows migrieren, die zuvor aufgeführt wurden. Migrieren Sie für die folgenden Verknüpfungstypen von
AccountLinkService zu ProductLinkService:
Verwenden Sie für ThirdPartyAppAnalyticsLinkIdentifier weiterhin
AccountLinkService.