Mapeamentos de campo

Use os mapeamentos de campo para fazer upgrade de cada etapa dos fluxos de trabalho de vinculação de parceiros da API Google Ads para a API Data Manager:

Autenticação

A API Data Manager requer credenciais com um escopo diferente da API Google Ads. É necessário gerar novas credenciais que incluam o escopo da API Data Manager para gerenciar vinculações de parceiro .

Mapeamentos de campo de objetos

Use os mapeamentos nas tabelas para mapear um ProductLink na API Google Ads para o equivalente PartnerLink na API Data Manager.

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 o account_type e o 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 uma vinculação. Ao criar um ProductLink, você indica o proprietário da vinculação 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 uma vinculação. Ao criar um PartnerLink, você indica o proprietário da vinculação 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ção de gerenciamento de vinculação

Use os mapeamentos de solicitação nesta seção para converter solicitações de criação, exclusão e recuperação de vinculações 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 Defina como o nome do recurso da conta de anunciante proprietária.
product_link partner_link Defina como o recurso PartnerLink. Consulte Mapeamentos de campo 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ção de recuperação de vinculação

A abordagem para recuperar vinculações de parceiro difere entre a API Google Ads e a API Data Manager.

API Google Ads

Envie um SearchGoogleAdsRequest contendo um query. A cláusula WHERE opcional da consulta define quais recursos retornar. A cláusula SELECT da consulta define quais campos preencher nos recursos parciais retornados.

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

Envie um SearchPartnerLinksRequest. O campo de solicitação filter opcional define quais recursos retornar. 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 Defina 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 retornar. A API Data Manager retorna recursos completos, então não há um equivalente à cláusula SELECT.
search_settings Não há equivalente.
validate_only Não há equivalente.

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

Anterior
Etapas para o upgrade