A API Google Ads permite vincular contas do Google Ads a outras contas de 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 convites é usado quando você tem acesso de administrador à conta do Google Ads, mas não à conta de produto. Esse fluxo funciona em dois cenários:
- Você quer vincular as duas contas e criar um convite para um administrador da conta de produto. O administrador da conta do produto aceita o convite para concluir o processo de conexão de contas.
- O administrador da conta de 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ê aceita o convite e conclui o processo de conexã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
ProductLinkInvitationService.CreateProductLinkInvitation método
para criar um convite. O status
do
ProductLinkInvitation não deve ser definido. O servidor da API Google Ads
vai definir esse valor como REQUESTED após a conclusão
da chamada de API. |
| Inspecionar o status de um convite | Use GoogleAdsService.Search
or GoogleAdsService.SearchStream
to query the product_link_invitation
resource and inspect its status. |
|
| Cenário 2 | Recuperar um convite | Use GoogleAdsService.Search
or GoogleAdsService.SearchStream
to query the product_link_invitation
resource. Filtre por
status = PENDING_APPROVAL para aceitar ou rejeitar
um convite pendente. |
| Aceitar ou rejeitar um convite | Use o
ProductLinkInvitationService.UpdateProductLinkInvitation método para
atualizar o status do
ProductLinkInvitation para ACCEPTED ou
REJECTED. |
|
| Revogar um convite | Use o método
ProductLinkInvitationService.RemoveProductLinkInvitation para
revogar um
ProductLinkInvitation. |
Os erros comuns a seguir podem ocorrer 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 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 de 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 um
ProductLink ativo. |
| Recuperar links ativos | Use
GoogleAdsService.Search ou
GoogleAdsService.SearchStream
para consultar o recurso
product_link. |
Os erros comuns a seguir podem ocorrer 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 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
É possível recuperar todos os links de produtos associados à sua conta do Google Ads usando
uma consulta 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álise.
Isso permite que você receba uma lista de serviços e aplicativos externos vinculados diretamente à sua conta do Google Ads, como o Google Play, parceiros de dados ou plataformas de análise de apps de terceiros.
Mudanças no AccountLinkService
Se você usar AccountLinkService para vincular uma conta do Google Ads a outra conta de produto, será necessário migrar o aplicativo atual para um dos fluxos de trabalho listados anteriormente. Para os tipos de link a seguir, migre do AccountLinkService e use ProductLinkService:
GoogleAdsIdentifierMerchantCenterIdentifierAdvertisingPartnerIdentifier
Para ThirdPartyAppAnalyticsLinkIdentifier, continue usando AccountLinkService.