Feldzuordnungen

Verwenden Sie die Feldzuordnungen, um jeden Schritt Ihrer Partnerverknüpfungs-Workflows von der Google Ads API auf die Data Manager API umzustellen:

• Objektfeldzuordnungen enthält Feldzuordnungen für die Ressource, die ein Partnerlinkobjekt darstellt.
• Link management request mappings enthält Feldzuordnungen für Anfragen zum Erstellen und Löschen eines Partnerlinks.
• Zuordnungen für Linkabrufanfragen enthält Feldzuordnungen zum Abrufen von Partnerlinks.

Authentifizierung

Für die Data Manager API sind Anmeldedaten mit einem anderen Bereich als für die Google Ads API erforderlich. Sie müssen neue Anmeldedaten generieren, die den Data Manager API-Bereich zum Verwalten von Partnerverknüpfungen enthalten.

Objektfeldzuordnungen

Verwenden Sie die Zuordnungen in den Tabellen, um einen ProductLink in der Google Ads API dem entsprechenden PartnerLink in der Data Manager API zuzuordnen.

Wichtig: Eine ProductLink und ein PartnerLink sind unterschiedliche Darstellungen derselben zugrunde liegenden Link-Entität. Wenn Sie bereits eine ProductLink in der Google Ads API haben , können Sie sie als PartnerLink in der Data Manager API abrufen und verwalten. Versuchen Sie nicht, ein weiteres PartnerLink für dasselbe Kontopaar zu erstellen.

ProductLink (Google Ads API)	PartnerLink (Data Manager API)	Hinweise
advertising_partner data_partner google_ads merchant_center	partner_account	Die Data Manager API hat keine separaten Felder für jeden Typ von verknüpftem Konto. Legen Sie für alle Kontotypen das Feld partner_account auf einen ProductAccount fest und legen Sie die Werte für account_type und account_id fest, um das verknüpfte Konto zu identifizieren.
product_link_id	partner_link_id
resource_name	name	In der Google Ads API gibt die customer_id der resource_name einer ProductLink an, welches Konto Inhaber einer bestehenden Verknüpfung ist. Wenn Sie einen ProductLink erstellen, geben Sie den Inhaber des Links an, indem Sie die customer_id eines CreateProductLinkRequest festlegen. In der Data Manager API gibt die Kombination aus accountType und accountId des owning_account an, welches Konto Inhaber einer vorhandenen Verknüpfung ist. Wenn Sie einen PartnerLink erstellen, geben Sie den Inhaber des Links an, indem Sie name auf den Ressourcennamen des Inhabers festlegen. Weitere Informationen finden Sie unter Ressourcennamen und Anfrage erstellen.
type	owning_account.account_type

Ressourcennamen

Die Data Manager API verwendet ein anderes Format für Ressourcennamen als die Google Ads API.

Google Ads API

In der Google Ads API hat der Ressourcenname für ProductLink folgendes Format:

customers/{customer_id}/productLinks/{product_link_id}

Data Manager API

In der Data Manager API hat der Name einer PartnerLink-Ressource das folgende Format:

accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

Zuordnungen von Anfragen zur Verknüpfungsverwaltung

Verwenden Sie die Anfragezuordnungen in diesem Abschnitt, um Anfragen zum Erstellen, Löschen und Abrufen von Partnerlinks zu konvertieren.

Anfrage erstellen

Hier sind die Feldzuordnungen, um einen CreateProductLinkRequest in der Google Ads API in den entsprechenden CreatePartnerLinkRequest in der Data Manager API zu konvertieren.

CreateProductLinkRequest (Google Ads API)	CreatePartnerLinkRequest (Data Manager API)	Hinweise
customer_id	parent	Legen Sie den Ressourcennamen des Werbetreibendenkontos fest, zu dem die Ressource gehört.
product_link	partner_link	Legen Sie die Ressource PartnerLink fest. Siehe Objektfeldzuordnungen.

Anforderung löschen

Hier sind die Feldzuordnungen, um einen RemoveProductLinkRequest in der Google Ads API in den entsprechenden DeletePartnerLinkRequest in der Data Manager API zu konvertieren.

RemoveProductLinkRequest (Google Ads API)	DeletePartnerLinkRequest (Data Manager API)	Hinweise
customer_id	Kein Äquivalent.	Das Feld name enthält die Inhaber- und Partnerkonten, sodass dieses zusätzliche Feld nicht erforderlich ist.
resource_name	name	Legen Sie den Ressourcennamen des PartnerLink fest, den Sie entfernen möchten.
validate_only	Kein Äquivalent.

Zuordnungen für Linkabrufanfragen

Die Vorgehensweise zum Abrufen von Partnerverknüpfungen unterscheidet sich zwischen der Google Ads API und der Data Manager API.

Google Ads API

Senden Sie eine SearchGoogleAdsRequest, die eine query enthält. Mit der optionalen WHERE-Klausel der Abfrage wird definiert, welche Ressourcen zurückgegeben werden sollen. In der SELECT-Klausel der Abfrage wird definiert, welche Felder in den zurückgegebenen Teilressourcen ausgefüllt werden sollen.

SELECT
  product_link.product_link_id,
  ...
FROM product_link
WHERE
  ...

Data Manager API

Sende eine SearchPartnerLinksRequest. Mit dem optionalen Anfragefeld filter wird festgelegt, welche Ressourcen zurückgegeben werden sollen. Die Antwort enthält vollständige Ressourcen, wobei alle Felder ausgefüllt sind.

Hier sind die Feldzuordnungen, um einen SearchGoogleAdsRequest in der Google Ads API in den entsprechenden SearchPartnerLinksRequest in der Data Manager API zu konvertieren.

SearchGoogleAdsRequest (Google Ads API)	SearchPartnerLinksRequest (Data Manager API)	Hinweise
customer_id	parent	Legen Sie den Ressourcennamen des Kontos fest, das durchsucht werden soll.
page_size	page_size
page_token	page_token
query	filter	Legen Sie den filter fest, um zu definieren, welche Ressourcen zurückgegeben werden sollen. Die Data Manager API gibt vollständige Ressourcen zurück, daher gibt es keine Entsprechung für die SELECT-Klausel.
search_settings	Kein Äquivalent.
validate_only	Kein Äquivalent.

Weitere Informationen finden Sie unter Partnerlinks abrufen. Dort erfahren Sie auch, wie Sie den filter einer SearchPartnerLinksRequest-Anfrage erstellen und Anfrageheader für verschiedene Szenarien festlegen.