Die Google Ads API unterstützt die Verknüpfung von Google Ads-Konten mit anderen Produktkonten. In diesem Leitfaden wird erläutert, wie Sie die API zum Verknüpfen Ihrer Konten verwenden.
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, wie die Verknüpfung erfolgen kann.
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, die Sie annehmen, um die Verknüpfung abzuschließen.
Verwenden Sie in diesem Szenario die folgenden Methoden:
| Szenario | Aktion | Anmerkungen |
|---|---|---|
| Szenario 1 | Einladung erstellen | Verwenden Sie die Methode
ProductLinkInvitationService.CreateProductLinkInvitation, um eine Einladung zu erstellen. Der status des
ProductLinkInvitation sollte nicht festgelegt werden. Der Google Ads API-Server legt diesen Wert 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üheren Versionen 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 des
ProductLinkInvitation auf ACCEPTED oder REJECTED zu aktualisieren. |
|
| Einladung widerrufen | Verwenden Sie die Methode
ProductLinkInvitationService.RemoveProductLinkInvitation, um ein vorhandenes
ProductLinkInvitation zu widerrufen. |
Die folgenden häufigen Fehler können in diesem Workflow 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. |
Direkte Verknüpfung
Verwenden Sie die direkte Verknüpfung, wenn Sie Administratorzugriff sowohl auf das Google Ads-Konto als auch auf 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 |
|---|---|
| Aktiven Link erstellen | Verwenden Sie
ProductLinkService.CreateProductLink, um ein
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. |
Die folgenden häufigen Fehler können in diesem Workflow auftreten:
| Fehlercode | Erklärung |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
Es wurde versucht, ein Konto über den Direktlink-Vorgang zu verknüpfen. Dies wird jedoch aufgrund fehlender Berechtigungen nicht unterstützt. Der Nutzer sollte stattdessen ProductLinkInvitationService verwenden, um den Einladungsvorgang durchzuführen.
|
ProductLinkError.INVITATION_EXISTS |
Es kann keine Verknüpfung erstellt werden, da bereits eine ausstehende Einladung vorhanden ist. |
Vorhandene Produktverknüpfungen abrufen
Sie können alle Produktverknüpfungen, die mit Ihrem Google Ads-Konto verknüpft sind, mit einer GAQL-Abfrage für die Ressource product_link abrufen.
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 Dienstes an.
Je nach type werden andere Felder in der product_link-Ressource ausgefüllt, die weitere Details zum Link enthalten. Wenn der Typ beispielsweise DATA_PARTNER ist, enthält das Feld data_partner Informationen zum verknüpften Datenpartnerkonto.
So erhalten Sie eine Liste der externen Dienste und Produktkonten, 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 und verwenden Sie ProductLinkService:
Verwenden Sie für ThirdPartyAppAnalyticsLinkIdentifier weiterhin AccountLinkService.