Feldzuordnungen

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

• „Object field mappings“ (Objektfeldzuordnungen) enthält Feldzuordnungen für die Ressource die ein Partnerlink-Objekt darstellt.
• „Link management request mappings“ (Zuordnungen für Anfragen zur Linkverwaltung) enthält Feldzuordnungen für Anfragen zum Erstellen und Löschen eines Partnerlinks.
• „Link retrieval request mappings“ (Zuordnungen für Anfragen zum Abrufen von Links) enthält Feldzuordnungen für das Abrufen von Partnerlinks.

Objektfeldzuordnungen

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

Wichtig: Ein ProductLink und ein PartnerLink sind unterschiedliche Darstellungen derselben zugrunde liegenden Linkentität. Wenn Sie bereits einen ProductLink in der Google Ads API haben , können Sie ihn als PartnerLink in der Data Manager API abrufen und verwalten. Versuchen Sie nicht, einen weiteren 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 die einzelnen Arten verknüpfter Konten. Legen Sie für alle Kontotypen das partner_account Feld auf ein ProductAccount, fest und geben Sie mit account_type und account_id das verknüpfte Konto an.
product_link_id	partner_link_id
resource_name	name	In der Google Ads API gibt die customer_id des resource_name eines ProductLink an, wem ein vorhandener Link gehört. 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, wem ein vorhandener Link gehört. Wenn Sie einen PartnerLink, geben Sie den Inhaber des Links an, indem Sie den 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 Ressourcennamenformat als die Google Ads API.

Google Ads API

In der Google Ads API verwendet ein ProductLink-Ressourcenname das folgende Format:

customers/{customer_id}/productLinks/{product_link_id}

Data Manager API

In der Data Manager API verwendet ein PartnerLink-Ressourcenname das folgende Format:

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

Zuordnungen für Anfragen zur Linkverwaltung

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

Anfrage erstellen

Hier sind die Feldzuordnungen, um eine CreateProductLinkRequest in der Google Ads API in die entsprechende 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 Inhaberkontos des Werbetreibenden fest.
product_link	partner_link	Legen Sie die PartnerLink-Ressource fest. Siehe Objekt Feldzuordnungen

Anforderung löschen

Hier sind die Feldzuordnungen, um eine RemoveProductLinkRequest in der Google Ads API in die entsprechende DeletePartnerLinkRequest in der Data Manager API zu konvertieren.

RemoveProductLinkRequest (Google Ads API)	DeletePartnerLinkRequest (Data Manager API)	Hinweise
customer_id	Kein Äquivalent.	Das Feld name umfasst das Inhaber- und das Partnerkonto, Dieses zusätzliche Feld ist daher nicht erforderlich.
resource_name	name	Legen Sie den Ressourcennamen des PartnerLink fest, den Sie entfernen möchten.
validate_only	Kein Äquivalent.

Zuordnungen für Anfragen zum Abrufen von Links

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

Google Ads API

Senden Sie eine SearchGoogleAdsRequest mit einer query. Mit der optionalen WHERE-Klausel der Abfrage wird festgelegt, welche Ressourcen zurückgegeben werden sollen. Mit der SELECT-Klausel der Abfrage wird festgelegt, welche Felder in den zurückgegebenen Teilressourcen ausgefüllt werden sollen.

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

Data Manager API

Senden Sie eine SearchPartnerLinkRequest. Mit dem optionalen Anfragenfeld filter wird festgelegt, welche Ressourcen zurückgegeben werden sollen. Die Antwort enthält vollständige Ressourcen, bei denen alle Felder ausgefüllt sind.

Hier sind die Feldzuordnungen, um eine SearchGoogleAdsRequest in der Google Ads API in die entsprechende 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, in dem gesucht werden soll.
page_size	page_size
page_token	page_token
query	filter	Legen Sie mit filter fest, welche Ressourcen zurückgegeben werden sollen. Die Data Manager API gibt vollständige Ressourcen zurück. Daher gibt es kein Äquivalent zur SELECT Klausel.
search_settings	Kein Äquivalent.
validate_only	Kein Äquivalent.

Weitere Informationen, einschließlich zum Erstellen des filter einer SearchPartnerLinksRequest-Anfrage und zum Festlegen von Anfrageheadern für verschiedene Szenarien, finden Sie unter Partner links abrufen.