Feldzuordnungen

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

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.

ProductLink (Google Ads API) PartnerLink (Data Manager API) Hinweise
  • advertising_partner
  • data_partner
  • google_ads
  • merchant_center
 partner_account Die Data Manager API enthält keine separaten Felder für die einzelnen Arten von verknüpften Konten. Legen Sie für alle Kontotypen das Feld partner_account auf ProductAccount fest und legen Sie die Felder 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, zu welchem Konto eine vorhandene Verknüpfung gehört. Wenn Sie ein ProductLink erstellen, geben Sie den Eigentümer 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, zu welchem Konto eine vorhandene Verknüpfung gehört. Wenn Sie einen PartnerLink erstellen, geben Sie den Eigentümer des Links an, indem Sie name auf den Ressourcennamen des Eigentümers festlegen.

Weitere Informationen finden Sie unter Ressourcennamen und Anfrage erstellen.

type owning_account.account_type

Ressourcennamen

Die Data Manager API verwendet ein anderes Ressourcennameformat als die Google Ads API.

Google Ads API

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

customers/{customer_id}/productLinks/{product_link_id}

Data Manager API

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

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

Zuordnung von Anfragen zur Verknüpfungsverwaltung

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

Anfrage erstellen

Hier finden Sie die Feldzuordnungen, um ein CreateProductLinkRequest in der Google Ads API in das entsprechende CreatePartnerLinkRequest in der Data Manager API zu konvertieren.

CreateProductLinkRequest (Google Ads API) CreatePartnerLinkRequest (Data Manager API) Hinweise
customer_id parent Wird auf den Ressourcennamen des zugehörigen Werbetreibendenkontos festgelegt.
product_link partner_link Auf die PartnerLink-Ressource festgelegt. Feldzuordnungen für Objekte

Anforderung löschen

Hier finden Sie die Feldzuordnungen, um ein RemoveProductLinkRequest in der Google Ads API in das 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 die Konten des Inhabers und des Partners. Dieses zusätzliche Feld ist also nicht erforderlich.
resource_name name Legen Sie den Ressourcennamen des PartnerLink fest, das Sie entfernen möchten.
validate_only Kein Äquivalent.

Zuordnung von 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 einem query. Mit der optionalen WHERE-Klausel der Abfrage wird definiert, 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 Anfragefeld filter wird definiert, welche Ressourcen zurückgegeben werden sollen. Die Antwort enthält vollständige Ressourcen, in denen alle Felder ausgefüllt sind.

Hier finden Sie die Feldzuordnungen, um ein SearchGoogleAdsRequest in der Google Ads API in das entsprechende SearchPartnerLinksRequest in der Data Manager API zu konvertieren.

SearchGoogleAdsRequest (Google Ads API) SearchPartnerLinksRequest (Data Manager API) Hinweise
customer_id parent Wird auf den Ressourcennamen des zu durchsuchenden Kontos festgelegt.
page_size page_size
page_token page_token
query filter Legen Sie filter fest, um anzugeben, welche Ressourcen zurückgegeben werden sollen. Die Data Manager API gibt vollständige Ressourcen zurück. Es gibt also kein Äquivalent zur SELECT-Klausel.
search_settings Kein Äquivalent.
validate_only Kein Äquivalent.

Weitere Informationen, einschließlich dazu, wie Sie die filter einer SearchPartnerLinksRequest-Anfrage erstellen und Anfrageheader für verschiedene Szenarien festlegen, finden Sie unter Partnerlinks abrufen.

Zurück
Upgrade ausführen