Mappature di campi

Utilizza le mappature dei campi per eseguire l'upgrade di ogni passaggio dei flussi di lavoro dei link partner dall'API Google Ads all'API Data Manager:

• Le mappature dei campi degli oggetti contengono le mappature dei campi per la risorsa che rappresenta un oggetto link partner.
• Le mappature delle richieste di gestione dei link contengono le mappature dei campi per le richieste di creazione ed eliminazione di un link partner.
• Le mappature delle richieste di recupero dei link contengono le mappature dei campi per il recupero dei link partner.

Mappature dei campi degli oggetti

Utilizza le mappature nelle tabelle per mappare un ProductLink nell' API Google Ads al relativo PartnerLink equivalente nell'API Data Manager.

Punto chiave: Un ProductLink e un PartnerLink sono rappresentazioni diverse della stessa entità di link sottostante. Se hai già un ProductLink nell'API Google Ads , puoi recuperarlo e gestirlo come PartnerLink nell'API Data Manager. Non tentare di creare un altro PartnerLink per la stessa coppia di account.

ProductLink (API Google Ads)	PartnerLink (API Data Manager)	Note
advertising_partner data_partner google_ads merchant_center	partner_account	L'API Data Manager non ha campi separati per ogni tipo di account collegato. Per tutti i tipi di account, imposta il campo partner_account su un ProductAccount, e imposta account_type e account_id per identificare l'account collegato.
product_link_id	partner_link_id
resource_name	name	Nell'API Google Ads, il customer_id del resource_name di un ProductLink indica a quale account appartiene un link esistente link. Quando crei un ProductLink, indichi il proprietario del link impostando il customer_id di un CreateProductLinkRequest. Nell'API Data Manager, la combinazione di accountType e accountId di owning_account indica a quale account appartiene un link esistente. Quando crei un PartnerLink, indichi il proprietario del link impostando il name sul nome della risorsa del proprietario. Per maggiori dettagli, consulta Nomi delle risorse e Crea richiesta.
type	owning_account.account_type

Nomi delle risorse

L'API Data Manager utilizza un formato di nome della risorsa diverso dall'API Google Ads.

API Google Ads

Nell'API Google Ads, il nome di una risorsa ProductLink utilizza il formato:

customers/{customer_id}/productLinks/{product_link_id}

API Data Manager

Nell'API Data Manager, il nome di una risorsa PartnerLink utilizza il formato:

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

Mappature delle richieste di gestione dei link

Utilizza le mappature delle richieste in questa sezione per convertire le richieste di creazione, eliminazione e recupero dei link partner.

Crea richiesta

Di seguito sono riportate le mappature dei campi per convertire un CreateProductLinkRequest nell'API Google Ads nel relativo equivalente CreatePartnerLinkRequest nell' API Data Manager.

CreateProductLinkRequest (API Google Ads)	CreatePartnerLinkRequest (API Data Manager)	Note
customer_id	parent	Imposta il nome della risorsa dell'account inserzionista proprietario.
product_link	partner_link	Imposta la risorsa PartnerLink. Consulta Mappature dei campi degli oggetti.

Elimina richiesta

Di seguito sono riportate le mappature dei campi per convertire un RemoveProductLinkRequest nell'API Google Ads nel relativo equivalente DeletePartnerLinkRequest nell' API Data Manager.

RemoveProductLinkRequest (API Google Ads)	DeletePartnerLinkRequest (API Data Manager)	Note
customer_id	Nessun equivalente.	Il campo name incapsula gli account proprietario e partner, quindi questo campo aggiuntivo non è necessario.
resource_name	name	Imposta il nome della risorsa del PartnerLink che vuoi rimuovere.
validate_only	Nessun equivalente.

Mappature delle richieste di recupero dei link

L'approccio per il recupero dei link partner è diverso tra l'API Google Ads e l'API Data Manager.

API Google Ads

Invia un SearchGoogleAdsRequest contenente un query. La clausola WHERE facoltativa della query definisce le risorse da restituire. La clausola SELECT della query definisce i campi da compilare nelle risorse parziali restituite.

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

API Data Manager

Invia un SearchPartnerLinksRequest. Il campo di richiesta filter facoltativo definisce le risorse da restituire. La risposta contiene risorse complete, con tutti i campi compilati.

Di seguito sono riportate le mappature dei campi per convertire un SearchGoogleAdsRequest nell'API Google Ads nel relativo equivalente SearchPartnerLinksRequest in the Data Manager API.

SearchGoogleAdsRequest (API Google Ads)	SearchPartnerLinksRequest (API Data Manager)	Note
customer_id	parent	Imposta il nome della risorsa dell'account da cercare.
page_size	page_size
page_token	page_token
query	filter	Imposta filter per definire le risorse da restituire. L' API Data Manager restituisce risorse complete, quindi non esiste un equivalente della clausola SELECT.
search_settings	Nessun equivalente.
validate_only	Nessun equivalente.

Per ulteriori informazioni, incluso come creare il filter di una SearchPartnerLinksRequest richiesta e impostare le intestazioni delle richieste per diversi scenari, consulta Recuperare i link partner.