Vincular suas contas do Merchant Center e do Google Ads

Antes de criar uma campanha do Shopping, você precisa vincular sua conta do Google Ads à conta do Google Merchant Center da seguinte maneira:

  1. Envie uma solicitação de vinculação da sua conta do Merchant Center para a conta do Google Ads.
  2. Aprove o pedido de vinculação na sua conta do Google Ads.

Há duas maneiras de enviar uma solicitação de vinculação:

  1. Use a interface da Web do Merchant Center para enviar uma solicitação de vinculação.
  2. Use a API Content for Shopping para atualizar o adsLinks do seu Account.

Para mudar o status das vinculações do Merchant Center na sua conta do Google Ads, use a interface da Web do Google Ads para aprovar ou recusar um convite. Também é possível atualizar convites ou remover vinculações usando a API Google Ads, conforme explicado abaixo.

Listar todos os convites do Merchant Center

É possível executar um relatório da API Google Ads usando a seguinte consulta GAQL para extrair uma lista de todas as solicitações pendentes de vinculação de um ID de cliente do Google Ads a uma conta do Merchant Center.

SELECT
    product_link_invitation.merchant_center.merchant_center_id,
    product_link_invitation.type
FROM product_link_invitation
WHERE product_link_invitation.status = 'PENDING_APPROVAL'
    AND product_link_invitation.type = 'MERCHANT_CENTER'

Para recuperar todas as solicitações, remova a condição de filtragem do campo product_link_invitation.status na consulta acima.

Aceitar um convite

Para aprovar a vinculação, defina o status product_link_invitation como ACCEPTED.

  1. Crie um objeto UpdateProductLinkInvitationRequest e defina o campo customer_id como o ID de cliente do Google Ads.

  2. Defina o campo resource_name como o nome do recurso do product_link_invitation.

  3. Defina o product_link_invitation_status como ACCEPTED.

  4. Faça uma chamada de API UpdateProductLinkInvitation.

Se o fluxo de convite for tentado por um usuário que já é administrador nas duas contas, um erro NO_INVITATION_REQUIRED será gerado. Você pode verificar esse erro e retornar ao fluxo de vinculação direta nesses casos.

Recusar um convite

Rejeitar um convite é semelhante a aceitar um convite, exceto que o campo product_link_invitation_status é definido como REJECTED. Se um convite for rejeitado, ele vai permanecer no estado REJECTED e não poderá ser aceito. Se necessário, crie uma nova convite.

Vinculação direta sem convite

Se o usuário que está tentando vincular a conta do Google Ads à conta do Merchant Center for administrador das duas contas, será possível pular a etapa de convite e vincular as duas contas diretamente usando a API Google Ads.

  1. Crie um objeto CreateProductLinkRequest e defina o campo customer_id como o ID de cliente do Google Ads.

  2. Crie um novo objeto ProductLink e defina o campo merchant_center_id como o ID da conta do Merchant Center.

  3. Defina ProductLink como o campo product_link do objeto de solicitação.

  4. Faça uma chamada de API CreateProductLink.

Se a vinculação direta for tentada por um usuário que não tem permissões suficientes, um erro CREATION_NOT_PERMITTED será gerado. Você pode verificar esse erro e retornar ao fluxo de convites nesses casos.

É possível executar um relatório da API Google Ads usando a consulta GAQL a seguir para extrair uma lista de links de um ID de cliente do Google Ads.

SELECT
    product_link.merchant_center.merchant_center_id,
    product_link.product_link_id
FROM product_link
WHERE product_link.type = 'MERCHANT_CENTER'

Siga estas etapas para desvincular uma vinculação:

  1. Crie um objeto RemoveProductLinkRequest e defina o campo customer_id como o ID de cliente do Google Ads.

  2. Defina o resource_name como o nome do recurso do product_link.

  3. Faça uma chamada de API RemoveProductLink.

O Administrador de empresa é uma representação unificada de uma empresa no Google. Quando você gerencia as contas do Google Ads e do Merchant Center usando uma conta do Gerenciador de empresa, o Gerenciador cria automaticamente vinculações entre elas. É possível recuperar esses vínculos usando a API Google Ads, mas eles não podem ser mutados com a API Google Ads.