Mappature di campi

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

• Object field mappings contiene le mappature dei campi per la risorsa che rappresenta un oggetto link partner.
• Link management request mappings contiene le mappature dei campi per le richieste di creazione ed eliminazione di un link partner.
• Link retrieval request mappings contiene le mappature dei campi per il recupero dei link dei partner.

Autenticazione

L'API Data Manager richiede credenziali con un ambito diverso rispetto all'API Google Ads. Devi generare nuove credenziali che includano l'ambito dell'API Data Manager per la gestione dei link dei partner.

Mappature dei campi degli oggetti

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

Punto chiave: un ProductLink e un PartnerLink sono rappresentazioni diverse della stessa entità 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 dispone di campi separati per ogni tipo di account collegato. Per tutti i tipi di account, imposta il campo partner_account su un ProductAccount e imposta i relativi account_type e account_id per identificare l'account collegato.
product_link_id	partner_link_id
resource_name	name	Nell'API Google Ads, il campo customer_id del proprietario dell'account resource_name di ProductLink indica quale account possiede un link esistente. Quando crei un ProductLink, indichi il proprietario del link impostando customer_id di un CreateProductLinkRequest. Nell'API Data Manager, la combinazione di accountType e accountId di owning_account indica quale account è proprietario di un link esistente. Quando crei un PartnerLink, indichi il proprietario del link impostando 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 del nome della risorsa diverso rispetto all'API Google Ads.

API Google Ads

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

customers/{customer_id}/productLinks/{product_link_id}

API Data Manager

Nell'API Data Manager, il nome di una risorsa PartnerLink utilizza il seguente 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 dei partner.

Crea richiesta

Ecco le mappature dei campi per convertire un CreateProductLinkRequest nell'API Google Ads nel suo equivalente CreatePartnerLinkRequest nell'API Data Manager.

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

Elimina richiesta

Ecco le mappature dei campi per convertire un RemoveProductLinkRequest nell'API Google Ads nel suo equivalente DeletePartnerLinkRequest nell'API Data Manager.

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

Mappature delle richieste di recupero dei link

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

API Google Ads

Invia una 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 una richiesta SearchPartnerLinksRequest. Il campo di richiesta facoltativo filter definisce le risorse da restituire. La risposta contiene risorse complete, con tutti i campi compilati.

Ecco le mappature dei campi per convertire un SearchGoogleAdsRequest nell'API Google Ads nel suo equivalente SearchPartnerLinksRequest nell'API Data Manager.

SearchGoogleAdsRequest (API Google Ads)	SearchPartnerLinksRequest (API Data Manager)	Note
customer_id	parent	Impostato sul nome della risorsa dell'account in cui eseguire la ricerca.
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 saperne di più, consulta Recupera i link dei partner, ad esempio su come creare il filter di una richiesta SearchPartnerLinksRequest e impostare le intestazioni della richiesta per scenari diversi.