A maneira de criar e configurar um projeto do Console de APIs do Google depende do cenário de autorização do OAuth 2.0 do seu aplicativo. Selecione um cenário de autorização para personalizar este guia.
Você precisa de um projeto do Console de APIs do Google para criar credenciais do OAuth 2.0 e ativar a API Google Ads no seu app.
Essas credenciais autenticam e autorizam seu app ou os usuários do Google Ads nos servidores do Google e permitem gerar tokens OAuth para serem usados em chamadas para a API.
Selecione ou crie um projeto do Console de APIs do Google
Para configurar um novo projeto, siga o guia para criar um projeto do Console de APIs do Google. 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 os projetos na nuvem estão sujeitos aos limites de cota padrão.
Ative 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.
Solicitar acesso à API
Em seguida, acesse a página de visão geral da API Google Ads para verificar seu nível de acesso à API atual. Se o nível de acesso atual à API for Teste, abra a seção Fazer upgrade do nível de acesso. Siga as instruções para solicitar o nível de acesso Explorer.
Depois que você concluir sua inscrição, o Google vai analisá-la automaticamente e, na maioria dos casos, fazer upgrade para o acesso de explorador.
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, incluindo um resumo do seu projeto, as políticas dele e os escopos de acesso de autorização solicitados. A configuração da tela de permissão OAuth do app define o que é mostrado aos usuários e revisores de apps e registra o app para que você possa publicá-lo mais tarde.
Configure uma tela de permissão OAuth para seu aplicativo e adicione https://www.googleapis.com/auth/adwords como um escopo 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 é limitado aos usuários da sua organização (Interno) ou se está disponível para qualquer usuário do Google (Externo). A opção Interno só estará 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 Testando (limitado a usuários de teste específicos que você adicionar) ou Em produção (disponível para o público-alvo definido pelo Tipo de usuário, o que pode exigir a verificação do app pelo Google).
Para fazer as melhores escolhas para seu aplicativo, consulte 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 é crucial para garantir que o aplicativo seja acessível aos usuários pretendidos.
Criar um ID do cliente e uma chave secreta do cliente
Criar um ID do cliente e uma chave secreta do cliente. Escolha 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 clicando no botão Fazer o download do JSON na caixa de diálogo de confirmação.