As etapas para criar e configurar um projeto do Console de APIs do Google dependem do tipo de cenário de autorização OAuth 2.0 que você está criando no seu aplicativo. Escolha o cenário de autorização que você está criando. Este guia será personalizado com base na sua escolha.
Você precisa de um projeto do Console de APIs do Google para criar credenciais do OAuth 2.0 e ativar a API Google Ads para seu app.
As credenciais são necessárias para a autenticação e autorização de usuários do Google Ads pelos servidores do Google. Com elas, você gera tokens OAuth para serem usados em chamadas à API.
Embora seja possível usar um único token de desenvolvedor para vários projetos, cada projeto pode usar apenas um token de desenvolvedor.
Selecionar ou criar um projeto do Console de APIs do Google
Siga as instruções para criar um projeto. Ativar o faturamento do projeto é opcional. Se o faturamento estiver ativado, selecione uma conta de faturamento para o novo projeto. Não há cobrança pelo uso da API Google Ads, mas há uma cota para o número total de projetos do Cloud.
Ativar a API Google Ads no seu projeto
Para ativar a API Google Ads no seu projeto, siga estas etapas:
Abra a biblioteca de APIs no Console de APIs do Google. Se necessário, 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.
Use a pesquisa para encontrar a API Google Ads se ela não estiver visível na lista.
Selecione a API Google Ads e clique no botão Ativar.
Configurar a tela de permissão OAuth
Quando você usa o OAuth 2.0 para autorização, o Google exibe uma tela de permissão para o usuário que inclui um resumo do seu projeto, das políticas dele e dos escopos de acesso de autorização solicitados. Configurar a tela de permissão OAuth do app define o que é mostrado para usuários e revisores de apps e registra o app para que você possa publicá-lo mais tarde.
Siga as instruções para configurar uma tela de permissão OAuth para seu aplicativo e adicione https://www.googleapis.com/auth/adwords como um escopo do OAuth.
Considerações importantes sobre o tipo de usuário e o status de publicação
Ao configurar a tela de permissão OAuth, preste atenção às configurações de Tipo de usuário e Status de publicação.
- Tipo de usuário:define se o app está limitado a usuários da sua organização ("Interno") ou disponível para qualquer usuário do Google ("Externo"). Observação: a opção "Interno" só aparece se o projeto fizer parte de uma organização do Google Workspace.
- Status de publicação:determina se o app está no modo "Teste" (limitado a usuários de teste específicos que você adiciona) ou "Em produção" (disponível para o público-alvo definido por "Tipo de usuário", podendo exigir a verificação de apps pelo Google).
Para fazer as melhores escolhas para seu aplicativo, revise as explicações detalhadas e as implicações dessas configurações na documentação oficial de suporte do Google Cloud:
- Opções de tipo de usuário da tela de permissão OAuth
- Opções de status de publicação da tela de permissão OAuth
Entender essas configurações é fundamental para garantir que seu aplicativo esteja acessível aos usuários pretendidos.
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 do cliente gerados. Caso contrário, crie um ID e uma chave secreta do cliente seguindo as instruções. Você pode escolher App para computador ou Aplicativo da Web como o tipo de aplicativo. Depois de criar o cliente OAuth 2.0, faça o download do arquivo JSON dele. Primeiro, clique no ícone Fazer o download do cliente OAuth e depois no botão FAZER O DOWNLOAD DO JSON na tela seguinte.