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.
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
Use o fluxo de convites quando tiver 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 de produto aceita o convite para concluir o processo de vinculação.
- O administrador da conta de produto quer vincular as duas contas, mas não tem acesso à conta do Google Ads. O administrador da conta de produto cria um convite, e você aceita e conclui o processo de vinculação.
Use os seguintes métodos neste 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 de API Google Ads
vai definir isso como REQUESTED após a conclusão bem-sucedida
da chamada de API. Ao criar um convite para um parceiro de publicidade
(AdvertisingPartnerLinkInvitationIdentifier),
advertising_partner_properties.allowed_domain
é obrigatório a partir da v25 (e opcional na v24 e versões anteriores). |
| 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 seguintes erros comuns 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. |
ProductLinkInvitationError.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
Use o fluxo de vinculação direta quando tiver acesso de administrador à conta do Google Ads e à conta de produto. Nesse caso, vincule diretamente a conta do Google Ads à conta de produto em vez de enviar um convite.
Use os seguintes métodos 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 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 DATA_PARTNER, o campo data_partner vai conter informações sobre a conta de parceiro de dados vinculada.
Isso permite que você receba uma lista de serviços externos e contas de produtos vinculadas diretamente à sua conta do Google Ads, como o Merchant Center, o Google Ads, parceiros de publicidade ou parceiros de dados.
Mudanças no AccountLinkService
Se você usa AccountLinkService para vincular uma conta do Google Ads a outra
conta de produto, é necessário migrar o aplicativo atual para um dos
fluxos de trabalho listados anteriormente. Para os seguintes tipos de link, migre do
AccountLinkService e use ProductLinkService:
Para ThirdPartyAppAnalyticsLinkIdentifier, continue usando
AccountLinkService.