Mappature di campi

Utilizza i mapping dei campi per eseguire l'upgrade di ogni passaggio dei flussi di lavoro di collegamento dei partner dall'API Google Ads all'API Data Manager:

Mappature dei campi degli oggetti

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

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 ProductAccount, e imposta account_type e account_id su identifica l'account collegato.
product_link_id partner_link_id
resource_name name

Nell'API Google Ads, il customer_id di resource_name di un ProductLink indica a quale account appartiene un collegamento esistente. 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 collegamento esistente. Quando crei un PartnerLink, indichi il proprietario del link impostando name sul nome della risorsa del proprietario.

Per maggiori dettagli, vedi 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, un nome 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 i mapping 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 suo CreatePartnerLinkRequest equivalente 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. Vedi mappature campi oggetto

Elimina richiesta

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

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

Mapping delle richieste di recupero dei link

L'approccio per recuperare i link dei partner varia tra l'API Google Ads e l'API Data Manager.

API Google Ads

Invia un SearchGoogleAdsRequest contenente un query. La clausola facoltativa WHERE 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 SearchPartnerLinkRequest. Il campo di richiesta facoltativo filter 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 suo SearchPartnerLinksRequest equivalente nell'API Data Manager.

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 alla clausola SELECT.
search_settings Nessun equivalente.
validate_only Nessun equivalente.

Consulta Recupera link partner per maggiori informazioni, incluso come costruire filter di una richiesta SearchPartnerLinksRequest e impostare le intestazioni della richiesta per diversi scenari.

Indietro
Procedura per l'upgrade