Como vincular contas de produto

Com a API Google Ads, é possível vincular contas do Google Ads a outras contas de produtos. Este guia explica como usar a versão v16 da API para vincular suas contas.

Maneiras de vincular contas

Há duas maneiras diferentes de vincular uma conta do Google Ads a outra conta de produto.

Fluxo de convites

O fluxo de convites é usado quando você tem acesso de administrador à conta do Google Ads, mas não à conta do produto. Esse fluxo funciona em dois cenários:

1. Você quer vincular as duas contas e criar um convite para um administrador da conta do produto. O administrador da conta do produto aceita o convite para concluir o processo de vinculação da conta.
2. O administrador da conta do produto quer vincular as duas contas, mas não tem acesso à conta do Google Ads. O administrador da conta do produto cria um convite, e você aceita o convite e conclui o processo de vinculação.

Os seguintes métodos são usados nesse cenário:

Cenário	Ação	Comentários
Cenário 1	Criar um convite	Use o método ProductLinkInvitationService.CreateProductLinkInvitation para criar um convite. O status de ProductLinkInvitation não deve ser definido. O servidor da API Google Ads vai definir como REQUESTED após a conclusão da chamada de API.
	Inspecionar o status de um convite	Use GoogleAdsService.Search ou GoogleAdsService.SearchStream para consultar o recurso product_link_invitation e inspecionar o status dele.
Cenário 2	Recuperar um convite	Use GoogleAdsService.Search ou GoogleAdsService.SearchStream para consultar o recurso product_link_invitation. Filtre por status = PENDING_APPROVAL para aceitar ou rejeitar um convite pendente.
	Aceitar ou rejeitar um convite	Use o método ProductLinkInvitationService.UpdateProductLinkInvitation para atualizar o status da ProductLinkInvitation para ACCEPTED ou REJECTED.
	Revogar um convite	Use o método ProductLinkInvitationService.RemoveProductLinkInvitation para revogar um ProductLinkInvitation atual.

Os seguintes erros comuns podem ser gerados nesse fluxo de trabalho:

Código do erro	Explicação
ProductLinkInvitationError.PERMISSION_DENIED	O cliente não tem permissão para realizar essa ação.
ProductLinkError.NO_INVITATION_REQUIRED	Não foi possível criar um convite porque o usuário já tem acesso de administrador à conta convidada. O usuário precisa utilizar o ProductLinkService para criar diretamente um link ativo.

Fluxo de vinculação direta

O fluxo de vinculação direta é usado quando você tem acesso de administrador à conta do Google Ads e à conta do produto. Nesse caso, você vincula diretamente a conta do Google Ads à conta do produto em vez de enviar um convite.

Os seguintes métodos são usados nesse cenário:

Ação	Comentários
Criar um vínculo ativo	Use ProductLinkService.createProductLink para criar um ProductLink.
Desativar um link ativo	Use ProductLinkService.removeProductLink para remover um ProductLink ativo.
Recuperar links ativos	Use GoogleAdsService.Search ou GoogleAdsService.SearchStream para consultar o recurso product_link.

Os seguintes erros comuns podem ser gerados nesse fluxo de trabalho:

Código do erro	Explicação
ProductLinkError.CREATION_NOT_PERMITTED	Você tentou vincular uma conta usando o fluxo de link direto, mas isso não foi aceito devido à falta de permissões. Em vez disso, o usuário precisa usar ProductLinkInvitationService para fazer o fluxo de convite.
ProductLinkError.INVITATION_EXISTS	Não é possível criar um link porque já existe um convite pendente.

Mudanças no AccountLinkService e no MerchantCenterLinkService

Se você já usou o MerchantCenterLinkService ou o AccountLinkService para vincular uma conta do Google Ads a outra conta de produto, migre seu aplicativo existente para um dos fluxos de trabalho listados anteriormente. A tabela a seguir mostra o status da migração:

Tipo de link	Compatível em novos serviços?	Suporte disponível a partir de	Comentários
DataPartnerIdentifier	Sim	v15	Migrar do MerchantCenterLinkService
GoogleAdsIdentifier	Sim	v16	Migrar do AccountLinkService
MerchantCenterIdentifier	Sim	v16	Migrar do AccountLinkService
AdvertisingPartnerIdentifier	Sim	v16	Migrar do AccountLinkService
ThirdPartyAppAnalyticsLinkIdentifier	Não	–	Continuar usando o AccountLinkService