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 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 à conta do Google Ads e à conta de produto. Nesse caso, você vincula diretamente a conta do Google Ads à conta de 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.

Recuperar links de produtos atuais

Você pode recuperar todos os links de produtos associados à sua conta do Google Ads usando uma consulta da GAQL no recurso product_link.

    SELECT
      product_link.product_link_id,
      product_link.type
    FROM product_link

O campo product_link.type indica o tipo de produto ou serviço vinculado. Dependendo do type, outros campos no recurso product_link serão preenchidos, fornecendo mais detalhes sobre o link. Por exemplo, se o tipo for THIRD_PARTY_APP_ANALYTICS, o campo third_party_app_analytics vai conter informações sobre o provedor de análises.

Assim, você pode obter uma lista de serviços e aplicativos externos vinculados diretamente à sua conta do Google Ads, como Google Play, parceiros de dados ou plataformas de análise de apps de terceiros.

Alterações 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.