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
Use o fluxo de convite quando você tiver 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 do produto aceita o convite para concluir o processo de conexã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, que você aceita e conclui o processo de conexão.
Use os seguintes métodos 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 bem-sucedida da
chamada de API. Ao criar um convite para um parceiro de publicidade (AdvertisingPartnerLinkInvitationIdentifier), o advertising_partner_properties.allowed_domain será obrigatório a partir da v25 (e opcional na v24 e versões anteriores). |
| 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 atual. |
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. |
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 diretamente um link ativo. |
Fluxo de vinculação direta
Use o fluxo de vinculação direta quando tiver acesso de administrador à conta do Google Ads e à conta do produto. Nesse caso, vincule diretamente a conta do Google Ads à conta do 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 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
É possível 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
DATA_PARTNER, o campo data_partner vai conter informações sobre a
conta vinculada do parceiro de dados.
Assim, você pode receber uma lista de serviços externos e contas de produtos vinculadas diretamente à sua conta do Google Ads, como Merchant Center, Google Ads, parceiros de publicidade ou de dados.
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:
Para ThirdPartyAppAnalyticsLinkIdentifier, continue usando
AccountLinkService.