Como vincular contas de produto

A API Google Ads oferece suporte à vinculação de contas do Google Ads a outras contas de produtos. Neste guia, explicamos como usar a API para vincular suas contas.

Como vincular contas

Ao vincular uma conta do Google Ads a outra conta de produto, há duas maneiras diferentes de fazer isso.

Fluxo de convites

O fluxo de convite é usado quando você tem acesso de administrador à conta do Google Ads, mas não à conta de 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 de produto aceita o convite para concluir o processo de vinculação da conta.
2. O administrador da conta de produto quer vincular as duas contas, mas não tem acesso à conta do Google Ads. O administrador da conta de produto cria um convite, que você aceita e conclui o processo de vinculação.

Os seguintes métodos são usados neste 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 do ProductLinkInvitation não pode ser definido. O servidor da API Google Ads vai definir esse valor como REQUESTED após a conclusão bem-sucedida da chamada da API.
	Verificar 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 recusar um convite pendente.
	Aceitar ou recusar um convite	Use o método ProductLinkInvitationService.UpdateProductLinkInvitation para atualizar o status do ProductLinkInvitation para ACCEPTED ou REJECTED.
	Revogar um convite	Use o método ProductLinkInvitationService.RemoveProductLinkInvitation para revogar um ProductLinkInvitation.

Os seguintes erros comuns podem ser gerados neste 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 usar o ProductLinkService para criar um link ativo diretamente.

Fluxo de vinculação direta

O fluxo de vinculação direta é usado quando você tem acesso de administrador à conta do Google Ads e à conta de 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 neste cenário:

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

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

Código do erro	Explicação
ProductLinkError.CREATION_NOT_PERMITTED	Uma vinculação de conta foi tentada usando o fluxo de vinculação direta, mas não é possível fazer isso devido à falta de permissões. O usuário precisa usar ProductLinkInvitationService para fazer o fluxo de convite.
ProductLinkError.INVITATION_EXISTS	Não é possível criar um link porque já há um convite pendente.

Mudanças no AccountLinkService

Se você usar AccountLinkService para vincular uma conta do Google Ads a outra conta de produto, vai precisar migrar o aplicativo atual para um dos fluxos de trabalho listados anteriormente. Para os seguintes tipos de link, migre de AccountLinkService e use ProductLinkService:

• GoogleAdsIdentifier
• MerchantCenterIdentifier
• AdvertisingPartnerIdentifier

Para ThirdPartyAppAnalyticsLinkIdentifier, continue usando AccountLinkService.