Mapeamentos de campo

Use os mapeamentos de campos para fazer upgrade de cada etapa dos fluxos de trabalho de vinculação de parceiros da API Google Ads para a API Gerenciador de dados:

Mapeamentos de campos de objetos

Use os mapeamentos nas tabelas para mapear um ProductLink na API Google Ads para o equivalente PartnerLink na API Gerenciador de dados.

ProductLink (API Google Ads) PartnerLink (API Data Manager) Observações
  • advertising_partner
  • data_partner
  • google_ads
  • merchant_center
 partner_account A API Data Manager não tem campos separados para cada tipo de conta vinculada. Para todos os tipos de conta, defina o campo partner_account como um ProductAccount e defina os campos account_type e account_id para identificar a conta vinculada.
product_link_id partner_link_id
resource_name name

Na API Google Ads, o customer_id do resource_name de um ProductLink indica qual conta é proprietária de um link. Ao criar um ProductLink, indique o proprietário do link definindo o customer_id de um CreateProductLinkRequest.

Na API Data Manager, a combinação de accountType e accountId do owning_account indica qual conta é proprietária de um link. Ao criar um PartnerLink, indique o proprietário do link definindo o name como o nome do recurso do proprietário.

Consulte Nomes de recursos e Criar solicitação para mais detalhes.

type owning_account.account_type

Nomes de recursos

A API Data Manager usa um formato de nome de recurso diferente da API Google Ads.

API Google Ads

Na API Google Ads, um nome de recurso ProductLink usa o formato:

customers/{customer_id}/productLinks/{product_link_id}

API Data Manager

Na API Data Manager, um nome de recurso PartnerLink usa o formato:

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

Mapeamentos de solicitações de gerenciamento de vinculações

Use os mapeamentos de solicitação nesta seção para converter solicitações de criação, exclusão e recuperação de links de parceiro.

Criar solicitação

Confira os mapeamentos de campo para converter um CreateProductLinkRequest na API Google Ads para o equivalente CreatePartnerLinkRequest na API Data Manager.

CreateProductLinkRequest (API Google Ads) CreatePartnerLinkRequest (API Data Manager) Observações
customer_id parent Definido como o nome do recurso da conta do anunciante proprietário.
product_link partner_link Definido como o recurso PartnerLink. Consulte Mapeamentos de campos de objetos.

Excluir solicitação

Confira os mapeamentos de campo para converter um RemoveProductLinkRequest na API Google Ads para o equivalente DeletePartnerLinkRequest na API Data Manager.

RemoveProductLinkRequest (API Google Ads) DeletePartnerLinkRequest (API Data Manager) Observações
customer_id Não há equivalente. O campo name encapsula as contas proprietárias e de parceiro. Portanto, esse campo adicional não é necessário.
resource_name name Defina como o nome do recurso do PartnerLink que você quer remover.
validate_only Não há equivalente.

Mapeamentos de solicitações de recuperação de links

A abordagem para recuperar links de parceiros é diferente entre a API Google Ads e a API Data Manager.

API Google Ads

Envie um SearchGoogleAdsRequest que contenha um query. A cláusula WHERE opcional da consulta define quais recursos serão retornados. A cláusula SELECT da consulta define quais campos serão preenchidos nos recursos parciais retornados.

SELECT
  product_link.product_link_id,
  ...
FROM product_link
WHERE
  ...
API Data Manager

Envie um SearchPartnerLinkRequest. O campo de solicitação filter opcional define quais recursos serão retornados. A resposta contém recursos completos, com todos os campos preenchidos.

Confira os mapeamentos de campo para converter um SearchGoogleAdsRequest na API Google Ads para o equivalente SearchPartnerLinksRequest na API Data Manager.

SearchGoogleAdsRequest (API Google Ads) SearchPartnerLinksRequest (API Data Manager) Observações
customer_id parent Definido como o nome do recurso da conta a ser pesquisada.
page_size page_size
page_token page_token
query filter Defina o filter para definir quais recursos serão retornados. A API Data Manager retorna recursos completos. Portanto, não há um equivalente à cláusula SELECT.
search_settings Não há equivalente.
validate_only Não há equivalente.

Confira Recuperar links de parceiros para mais informações, incluindo como criar o filter de uma solicitação SearchPartnerLinksRequest e definir cabeçalhos de solicitação para diferentes cenários.

Anterior
Etapas para o upgrade