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.

Maneiras de 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 do 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 da ProductLinkInvitation não deve ser definido. O servidor da API Google Ads definirá isso 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 recusar um convite pendente.
	Aceitar ou recusar 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 existente.

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 usar 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 às contas do Google Ads e do produto. Nesse caso, você vincula diretamente a conta do Google Ads à conta do produto em vez de enviar um convite.

Os métodos a seguir são usados nesse 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 nesse 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á existe 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 seu aplicativo atual para um dos fluxos de trabalho listados anteriormente. Para os seguintes tipos de links, migre AccountLinkService e use ProductLinkService:

• GoogleAdsIdentifier
• MerchantCenterIdentifier
• AdvertisingPartnerIdentifier

Para ThirdPartyAppAnalyticsLinkIdentifier, continue usando AccountLinkService.