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.
Formas 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 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:
- 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.
- 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ê o aceita e conclui o processo de vinculação.
Os métodos a seguir 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 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 rejeitar
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 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 usar o ProductLinkService para criar diretamente um link ativo. |
Fluxo do link direto
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 métodos a seguir são usados nesse cenário:
| Ação | Comentários |
|---|---|
| Criar uma vinculação ativa | 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 |
Houve uma tentativa de vincular uma conta usando o fluxo de link direto, mas isso
não é possí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 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, será necessário migrar seu aplicativo atual para um dos fluxos de trabalho listados anteriormente. A tabela a seguir mostra o status da migração:
| Tipo de link | Compatível com 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 |