Configurar um projeto do Console de APIs do Google

Você precisa de um projeto do Console de APIs do Google para criar credenciais do OAuth 2.0, configurar uma tela de consentimento do usuário e ativar a API Google Ads para seu aplicativo.

As credenciais são necessárias para a autenticação e autorização dos usuários do Google Ads pelos servidores do Google. Essas credenciais permitem gerar tokens OAuth que serão usados em chamadas à API.

Selecione ou crie um projeto do Console de APIs do Google

Se você já tiver um projeto do Console de APIs do Google e quiser usá-lo para criar credenciais, pule para Criar um ID do cliente e uma chave secreta do cliente.

Para criar um projeto,

  • Acesse o Console de APIs do Google
  • Clique em Criar projeto.
  • Insira um nome ou aceite a sugestão gerada
  • Confirme ou edite os campos restantes
  • Clique em Create.

Se o faturamento estiver ativado, selecione uma conta de faturamento para o novo projeto. Não há cobranças pelo uso da API Google Ads, mas há uma cota no número total de projetos do Cloud.

Se você estiver usando um projeto do Console de APIs do Google e já tiver configurado uma tela de permissão OAuth antes, pule esta etapa e modifique a tela de consentimento adicionando o escopo do OAuth 2.0 da API Google Ads.

Quando você usa o OAuth 2.0 para autorização, o Google exibe uma tela de consentimento para o usuário, incluindo um resumo do seu projeto, das políticas dele e dos escopos de autorização de acesso solicitados. A configuração da tela de permissão OAuth do seu app define o que é exibido aos usuários e revisores e registra o app para que você possa publicá-lo depois.

  1. Abra a página de consentimento e selecione seu projeto no menu suspenso na parte superior da página.
  2. Selecione o Tipo de usuário e clique em CRIAR.
  3. Preencha o formulário da tela de consentimento. É possível editar isso mais tarde, se necessário. Clique em SALVAR E CONTINUAR quando terminar.
  4. Na próxima página, clique em ADICIONAR OU REMOVER ESCOPOS.
  5. Role para baixo e digite o seguinte no campo em Adicionar escopos manualmente:

    https://www.googleapis.com/auth/adwords

  6. Clique em ADICIONAR À TABELA.
  7. Adicione outros escopos de que seu projeto possa precisar e clique em ATUALIZAR.
  8. Clique em SALVAR E CONTINUAR.
  9. Se você não planeja publicar seu projeto imediatamente, adicione o endereço de e-mail de cada conta de usuário que pode ser usada no teste e clique em SALVAR E CONTINUAR.
  10. Analise a página de resumo e clique em VOLTAR PARA O PAINEL.
  1. Abra a página de consentimento e selecione seu projeto no menu suspenso na parte superior da página.
  2. Clique em EDITAR APP.
  3. Clique em SALVAR E CONTINUAR no formulário Tela de permissão OAuth.
  4. Na próxima página, clique em ADICIONAR OU REMOVER ESCOPOS.
  5. Role para baixo e digite o seguinte no campo em Adicionar escopos manualmente:

    https://www.googleapis.com/auth/adwords

  6. Clique em ADICIONAR À TABELA.
  7. Clique em SALVAR E CONTINUAR.
  8. Clique em SALVAR E CONTINUAR no formulário Usuários de teste.
  9. Analise a página de resumo e clique em VOLTAR PARA O PAINEL.

Criar um ID e uma chave secreta do cliente

Pule esta etapa se você estiver usando um projeto do Console de APIs do Google que já tenha um ID do cliente e uma chave secreta gerados.

Depois de determinar o tipo de aplicativo, siga as instruções abaixo para gerar o ID e a chave secreta do cliente do OAuth 2.0:

  1. Abra a página Credenciais. Selecione um projeto criado anteriormente ou crie um novo.

  2. Na tela "Credenciais", clique em CRIAR CREDENCIAIS e selecione ID do cliente OAuth.

    • Se você ainda não configurou uma tela de permissão OAuth para o projeto, clique em CONFIGURAR TELA DE CONSENTIMENTO.

      • Selecione o tipo de usuário e clique em CRIAR.

      • Preencha o formulário inicial. É possível editar isso mais tarde, se necessário. Clique em Salvar quando terminar.

    • Volte até Credenciais > CRIAR CREDENCIAIS > ID do cliente OAuth para continuar.

  3. Selecione App para computador ou Aplicativo da Web como o tipo de app, dependendo do caso de uso. Este guia usa App para computador como o tipo de app.

  4. Insira um nome para o app e clique em Criar.

  5. Na página de confirmação, copie o ID do cliente e a Chave secreta do cliente para a área de transferência para configurar a biblioteca de cliente posteriormente. Além disso, faça o download das credenciais no formato JSON para um arquivo chamado credentials.json.

Ativar a API Google Ads no seu projeto

Para ativar a API Google Ads no seu projeto, siga estas etapas:

  1. Abra a biblioteca de APIs no Console de APIs do Google. Se solicitado, selecione seu projeto ou crie um novo. A Biblioteca de APIs lista todas as APIs disponíveis, agrupadas por família de produtos e popularidade.

  2. Use a pesquisa para encontrar a API Google Ads, se ela não estiver visível na lista.

  3. Selecione a API Google Ads e clique no botão Ativar.