Todas as chamadas da API Google AdMob precisam ser autorizadas pelo OAuth2 para que o app possa interagir com serviços da Web em nome do usuário. O OAuth2 permite que seu app cliente da API AdMob acesse a conta da AdMob de um usuário sem precisar processar ou armazenar o nome de usuário ou a senha. Para ter uma visão geral da autorização, consulte Autorização.
Siga as etapas abaixo para gerar as credenciais do OAuth2 e fazer sua primeira solicitação.
Pré-requisitos
Uma Conta do Google
Familiaridade com os conceitos básicos do REST e a autorização de solicitações com o OAuth 2.0.
Determinar seu tipo de autenticação
Consulte a tabela abaixo para saber qual tipo de autenticação é mais apropriado para seu app:
| Escolher o tipo de autenticação OAuth2 | Se... |
|---|---|
| App para computador |
|
| App da Web |
|
Criar um projeto
Para começar a usar a API AdMob, primeiro é necessário criar ou selecionar um projeto no console de APIs do Google e ativar a API usando a ferramenta de configuração, que orienta você pelo processo e ativa a API AdMob automaticamente.
Como ativar a API para um projeto atual
As etapas a seguir se aplicam aos usuários com um projeto existente que preferem ativar manualmente a API AdMob.
Criar credenciais OAuth2
As instruções a seguir indicam o processo de criação de um ID do cliente OAuth 2.0 para usar com o fluxo de apps instalados.
Clique em CRIAR CREDENCIAIS > ID do cliente OAuth.
Se você não tiver configurado uma tela de consentimento do OAuth para o projeto, receberá instruções para fazer isso. Clique em CONFIGURAR TELA DE CONSENTIMENTO. Há várias maneiras de configurar a tela de consentimento para usar o ID do cliente OAuth 2.0.
- Defina o tipo de usuário como Externo e o status de publicação como Publicado.
Ou defina o tipo de usuário como Externo e o status de publicação como Teste. Em seguida, adicione Usuários de teste selecionando Adicionar usuários para conceder acesso ao ID do cliente OAuth 2.0.
Veja mais informações em como configurar a tela de permissão OAuth.
Selecione App para computador ou Aplicativo da Web como o tipo, dê um nome e clique em Criar.
Quando terminar, você vai receber um ID do cliente OAuth 2.0 e uma chave secreta do cliente. É possível fazer o download dessa chave no formato JSON e salvá-la para uso posterior.
Fazer uma solicitação
A API AdMob foi criada com base em HTTP e JSON. Portanto, qualquer cliente HTTP padrão pode enviar solicitações a ela e analisar as respostas. No entanto, as bibliotecas de cliente da API do Google oferecem melhor integração de linguagens, mais segurança e suporte para fazer solicitações autorizadas. As bibliotecas de cliente estão disponíveis em várias linguagens de programação. Ao usá-las, não é preciso configurar as solicitações HTTP nem analisar as respostas manualmente.
Depois de criar as credenciais do OAuth 2.0, você já pode começar a usar a API AdMob. Para solicitar acesso usando o OAuth 2.0, seu app também precisa de informações de escopo:
| Escopo | Significado |
|---|---|
https://www.googleapis.com/auth/admob.readonly |
Acessar todos os dados da AdMob. Isso pode incluir informações da conta, configurações de inventário e mediação, relatórios e outros dados. Dados confidenciais, como pagamentos ou detalhes da campanha, não serão incluídos. |
https://www.googleapis.com/auth/admob.report |
Acessar relatórios de desempenho de anúncios e ganhos. Confira o ID do editor, fuso horário e código de moeda padrão. |
Faça sua primeira solicitação para gerar um relatório usando exemplos em Java, PHP, Python ou curl.
Revogar tokens compartilhados
É possível revogar tokens compartilhados de duas maneiras:
Acesse a página de permissões da sua Conta do Google e revogue o acesso do projeto relevante.
Como alternativa, é possível revogar os tokens de aplicativos da Web usando a API Google Identity.