🎯Objetivo

Documento visa orientar clientes no processo de autorização de acesso aos dados através das APIs do Google Ads (Google Ads API v13)

📈Google Ads API v13

O processo de autorização pode acontecer através do Google Cloud da DataforAll ou do cliente:

:D4All: 1. Passo a passo (Google Cloud DataforAll)

É a forma mais recomendada. Consiste em uma autorização feita diretamente na plataforma D4All do cliente.

Setup Plataforma DataforAll

Requisito: acesso à plataforma → https://<suaplataforma>.dataforall.tech/login

Autenticar via OAuth na plataforma

A plataforma da DataforAll auxilia na autorização do acesso aos dados do cliente. Através da autorização do cliente o Google nos concede tokens de acesso e atualização para acessarmos os dados

1. No menu lateral esquerdo, role até grupo Connectors, clique em Google e então em OAuth
2. 

Clique em Adicionar integração e selecione Google Ads no Escopo. Clique em Salvar.

3. Será feito o redirecionamento para a página de autenticação do Google. Autentique-se com a conta que possui o acesso necessário em Google Ads.

✅Com isso, poderemos acessar os dados do Google Ads com as permissões do usuário autorizado.

No final desse processo precisaremos das seguintes informações:

• ID da conta de gerente
• IDs das contas a serem acessadas (contas de anúncio)

☁️2. Passo a passo (Google Cloud Cliente)

Nesse cenário, o cliente deseja utilizar um projeto próprio do Google Cloud. É uma forma que requer maior esforço do cliente, pois serão necessárias configurações a mais nos aplicativos. Uma vantagem é que por ser um e-mail é possível controlar melhor o perfil de acesso da conta.

Requisitos obrigatórios:

• Usuário com perfil de administrador no Google Cloud Console (GCC)
• Projeto no GCC
  • Se não possuir, criar seguindo a documentação
• API do Google Ads ativada no projeto do GCC
  • Se não estiver, ativar seguindo a documentação
• Conta de gerente no Google Ads
  • Se não possuir, criar aqui
• Token de desenvolvedor com nível de acesso básico vinculado à conta de gerente
  • Se não possuir, solicitar seguindo a documentação

O token de desenvolvedor deve possuir nível de acesso básico para acessar contas em produção. A solicitação ao acesso básico pode demorar dias ou semanas.

Existem duas formas de autorizar o acesso aos dados via API:

1. Setup via Conta de Serviço

A conta de serviço irá personificar um e-mail com permissões para acessar as contas do Google Ads

Requisitos:

• Conta de serviço no GCC
  • Se não possuir, criar seguindo a documentação
• Um domínio e uma conta de super administrador no Google Workspace

Passo único — Delegando autoridade em todo domínio para a conta de serviço no Google Workspace

1. No Admin Console do seu domínio do Google Workspace, acesse o Menu principal > Segurança > Acesso e controle de dados > Controles de API.
2. No painel Delegação em todo o domínio, selecione Gerenciar a delegação em todo o domínio.
3. Clique em Adicionar novo;
4. No campo ID do cliente, insira o ID do cliente da conta de serviço. Você encontra o ID do cliente (ID exclusivo) da sua conta de serviço na página das Contas de Serviço.
   
   
5. No campo Escopos do OAuth (delimitado por vírgulas), insira o seguinte escopo: https://www.googleapis.com/auth/adwords
6. Clique em Autorizar.

No final desse processo precisaremos das seguintes informações:

• Token de desenvolvedor
• ID da conta de gerente
• Arquivo *.json com as chaves da conta de serviço
• E-mail da conta a ser personificada (a que possui as permissões para acessar as contas do Google Ads)

2. Setup via ID do Cliente OAuth

As credenciais da ID do Cliente OAuth identificam um aplicativo no Google Cloud. A autorização para o acesso aos dados através da API é para esse “aplicativo”.

Requisitos:

• Credenciais ID do Cliente OAuth configuradas como App para Computador
  • Se não possuir, seguir documentação
• Computador com Python3 instalado
  • Se não possuir, seguir guia (Windows)

Passo único — Gerar token de atualização

O token de atualização ou Refresh Token é um identificador gerado pelo Google quando um usuário autoriza que um app acesse alguns de seus dados (Google Ads, nesse caso).

1. Baixe o seguinte arquivo python
2. Abra o terminal do Windows e cole o comando: pip install --upgrade google-auth google-auth-oauthlib google-auth-httplib2
3. Identifique onde está localizado o *.json com as credenciais ID do Cliente OAuth e copie seu caminho, por ex.: C:\Users\Example\Documents\credentials\client_secret.json
   
   
   
4. Ainda no terminal digite o comando: python generate_user_credentials.py --client_secrets_path=INSIRA_AQUI_O_CAMINHO_DAS_CREDENCIAIS
5. Clique no link gerado ou copie e cole no navegador
6. Será solicitado o login do Google (use a conta que possui as permissões de acesso) e em sequência a autorização para acessar os dados do Google Ads. Clique em Continuar.
7. No terminal será gerado o Refresh Token. Copie e guarde em algum local.

No final desse processo precisaremos das seguintes informações:

• Token de desenvolvedor
• ID da conta de gerente
• Arquivo *.json com as credenciais ID do Cliente OAuth
• Refresh Token

🗃️Documentação:

https://developers.google.com/google-ads/api/docs/client-libs/python/oauth-web

https://developers.google.com/google-ads/api/docs/oauth/service-accounts

Siga a Data For All nas Redes Sociais: