Vincular contas de produtos

A API Google Ads permite vincular contas do Google Ads a contas de outros produtos. Este guia explica 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 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.
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, 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 deve ser definido. O servidor da API Google Ads vai 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 rejeitar 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 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 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 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 neste fluxo de trabalho:

Código do erro	Explicação
ProductLinkError.CREATION_NOT_PERMITTED	Uma vinculação de contas foi tentada usando o fluxo de link direto, mas isso não é compatível 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 em AccountLinkService

Se você usa AccountLinkService para vincular uma conta do Google Ads a outra conta de produto, migre seu 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.