As etapas a serem seguidas 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 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 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. Essas credenciais permitem gerar tokens OAuth para serem usados em chamadas para a API.
Embora seja possível usar um único token de desenvolvedor para vários projetos, cada projeto só pode usar 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 para seu projeto é opcional. Se você tiver o faturamento 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 no 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 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.
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 mostra uma tela de permissão ao usuário, incluindo um resumo do seu projeto, das políticas dele e dos escopos de acesso de autorização solicitados. A configuração da tela de permissão OAuth do seu app define o que é mostrado aos usuários e revisores de apps e registra seu 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 OAuth.
Considerações importantes para 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 é limitado a usuários da sua organização ("Interno") ou disponível para qualquer usuário do Google ("Externo"). A opção "Interno" só está disponível 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 definido pelo 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 de suporte oficial 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
Você pode pular esta etapa se estiver usando um projeto do Console de APIs do Google que já tenha um ID e uma chave secreta do cliente gerados. Caso contrário, crie um ID do cliente 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 do cliente. Primeiro, clique no ícone Fazer o download do cliente OAuth e, em seguida, no botão FAZER O DOWNLOAD DO JSON na tela seguinte.