Playground OAuth

Outra opção para gerar credenciais do OAuth2 é usar o OAuth2 Playground. O playground do OAuth2, em conjunto com o Console de APIs do Google, permite criar tokens OAuth2 manualmente.

Pré-requisitos

Antes de criar credenciais, você precisa criar um projeto, configurar a tela de consentimento do usuário e ativar a API AdMob.

Receber um ID e uma chave secreta do cliente

Criar uma credencial

Importante: para usar o OAuth2 Playground, é necessário gerar um ID do cliente para um aplicativo da Web. Esse é o único tipo de aplicativo que funciona com o playground OAuth2.

1. Abra a página Credenciais do console de APIs do Google.

2. Na lista suspensa do projeto, selecione um projeto existente ou crie um novo.

   Importante: crie um projeto com um nome de identificação exclusivo para cada token compartilhado, para que você possa compartilhá-los ou revogá-los com facilidade.

3. Na página "Credenciais", selecione Criar credenciais e, em seguida, selecione ID do cliente do OAuth.

4. Em Tipo de aplicativo, escolha Aplicativo da Web.

5. Em URIs de redirecionamento autorizados, adicione uma linha com: https://developers.google.com/oauthplayground

   Importante: se você já tiver uma credencial, poderá reutilizá-la definindo os URIs de redirecionamento autorizados conforme mostrado acima.

6. Clique em Criar.

7. Na página "ID do cliente", anote o ID do cliente e a chave secreta do cliente. Você precisará deles na próxima etapa.

Configurar uma tela de consentimento OAuth

É necessário configurar uma tela de consentimento do OAuth antes de usar um ID do cliente OAuth 2.0.

1. Abra a página de consentimento do Console de APIs do Google.

2. No menu suspenso de projetos, selecione o mesmo projeto usado para gerar a credencial.

3. Configure a tela de consentimento OAuth para usar o ID do cliente OAuth 2.0. Há várias maneiras de fazer isso:

   1. Defina o tipo de usuário como Externo e o status de publicação como Publicado.
   2. 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 dar acesso a eles para usar seu ID de cliente OAuth 2.0.

Consulte mais informações sobre como configurar a tela de consentimento OAuth.

Gerar tokens

Importante: o usuário do Google em que você fez login no navegador determina qual conta da AdMob você poderá acessar com as credenciais do OAuth2 geradas. Portanto, é recomendável seguir estas etapas em uma janela anônima ou quando você não estiver conectado à sua Conta do Google, já que o usuário com as credenciais que você quer usar provavelmente não é o mesmo que você estava conectado quando recebeu o ID e o segredo do cliente.

1. Acesse o OAuth2 Playground. O uso desse link preenche alguns valores de chave para você.

2. Clique no ícone de engrenagem no canto superior direito e marque a caixa Use suas próprias credenciais do OAuth (se ainda não estiver marcada).

3. Confira se:

   • o fluxo do OAuth está definido como Servidor;
   • O tipo de acesso está definido como Off-line. Isso garante que você receba um token de atualização e um token de acesso, em vez de apenas um token de acesso.

4. Insira o ID do cliente OAuth2 e o secret de cliente OAuth2 que você recebeu acima.

   

5. Na seção Step 1 - Select & authorize APIs (Etapa 1: selecionar e autorizar APIs), insira o seguinte URL na caixa de texto na parte de baixo, se ele ainda não estiver lá, e clique em Authorize APIs (Autorizar APIs):

   https://www.googleapis.com/auth/admob.readonly

6. Se necessário, faça login na conta a que você quer conceder acesso e autorização. Caso contrário, confirme se o usuário atual do Google no canto superior direito é a conta da AdMob para quem você quer receber as credenciais.

   Importante: se você recebeu o ID e a chave secreta do cliente há poucos minutos e recebeu um erro como Error: redirect_uri_mismatch, é possível que as mudanças feitas ainda não tenham sido propagadas. Clique no botão "Voltar" do navegador, aguarde alguns minutos e tente clicar em Autorizar APIs novamente.

7. Uma solicitação aparece indicando que o app quer acessar seus dados da AdMob. Clique em Aceitar para continuar.

8. Na guia Etapa 2: trocar o código de autorização por tokens, um código de autorização vai aparecer. Clique em Trocar código de autorização por tokens.

   

9. Se tudo correr bem, o token de atualização e o token de acesso serão preenchidos. Talvez seja necessário expandir novamente a Etapa 2: trocar o código de autorização por tokens.

   

10. Copie o token de atualização para o arquivo de configuração da sua biblioteca de cliente, junto com o ID do cliente e a chave secreta do cliente.

11. Configure uma biblioteca de cliente para OAuth na API AdMob.

Remover o OAuth2 Playground do seu código do cliente

Agora que você tem um token de atualização, não é mais necessário que o playground do OAuth2 seja um URI de redirecionamento autorizado. Para remover da lista de URIs de redirecionamento autorizados:

1. Acesse a página Credenciais do Console de APIs do Google.

2. Na lista suspensa de projetos, selecione seu projeto.

3. Na página "Credenciais", clique no nome do código do cliente para editá-lo.

4. Remova https://developers.google.com/oauthplayground dos URIs de redirecionamento autorizados. É necessário deixar pelo menos um URI de redirecionamento no lugar.

5. Clique em Salvar.

Revogar tokens compartilhados

É possível revogar tokens compartilhados de duas maneiras:

1. Acesse a página de permissões da Conta do Google e revogue o acesso do projeto relevante.

2. Também é possível revogar tokens de aplicativos da Web usando a API Google Identity.