A maneira de criar e configurar um projeto do console de APIs do Google depende do cenário de autorização 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 para seu app.
Essas credenciais autenticam e autorizam seu app ou usuários do Google Ads nos servidores do Google e permitem gerar tokens OAuth para serem usados em chamadas à API.
Selecionar ou criar um projeto do Console de APIs do Google
Para configurar um novo projeto, siga o guia para criar um projeto no 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 do Cloud estão sujeitos aos limites padrão de cota.
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.
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 à API atual for Teste, expanda 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 a inscrição, o Google vai analisar e fazer upgrade para o acesso ao Explorer automaticamente na maioria dos casos.
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. Configurar a tela de permissão OAuth do app define o que é mostrado aos usuários e revisores de apps, além de registrar 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 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). 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-alvo definido por Tipo de usuário, o que pode 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 do OAuth
- Opções de status de publicação da tela de permissão do OAuth
Entender essas configurações é crucial para garantir que seu aplicativo esteja acessível aos usuários pretendidos.
Criar um ID e uma chave secreta do cliente
Criar um ID do cliente e uma senha de cliente. Você pode escolher Aplicativo para computador ou Aplicativo da Web como o tipo de aplicativo. Depois de criar o cliente OAuth 2.0, baixe o arquivo JSON dele clicando no botão Fazer o download do JSON na caixa de diálogo de confirmação.