Playground OAuth

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

O OAuth2 Playground destina-se a usuários que precisam acessar uma única conta de administrador ou de usuário do Google Ads. Se você precisar solicitar credenciais a vários usuários, é melhor configurar uma biblioteca de cliente para OAuth na API Google Ads.

Receber um ID e uma chave secreta do cliente

Aviso:para usar o OAuth2 Playground, você precisa gerar um ID do cliente para um aplicativo da Web. Esse é o único tipo de aplicativo que funciona com o OAuth2 Playground. Consulte Escolher um tipo de aplicativo para mais informações.

Se você não tiver um projeto na nuvem:

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

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

3. Na página "Credenciais", selecione Criar credenciais e selecione ID do cliente 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

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.

Se você já tiver um projeto na nuvem, poderá reutilizá-lo definindo os URIs de redirecionamento autorizados como acima.

Gerar tokens

Aviso: o usuário do Google com o qual você fez login no seu navegador determina quais contas do Google Ads poderão ser acessadas com as credenciais do OAuth2 a serem geradas. Portanto, recomendamos que você execute essas etapas em uma janela anônima ou quando não tiver feito login na sua Conta do Google, já que é provável que o usuário com as credenciais que você quer usar não seja o mesmo com o qual você fez login quando usou o ID e a chave secreta do cliente.

1. Acesse o Playground OAuth2. Usar esse link precisa pré-preencher algumas chaves-valor para você.

2. Clique no ícone de engrenagem no canto superior direito e marque a caixa Use your own OAuth credentials (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 código do cliente do OAuth2 e a chave secreta do cliente do OAuth2 que você adquiriu acima.

   

5. Na seção denominada Etapa 1: selecionar e autorizar APIs, clique em API Google Ads na lista e selecione o escopo dela, https://www.googleapis.com/auth/adwords. Depois clique em Authorize APIs:

   

6. Se solicitado, 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 do Google Ads ou de administrador para a qual você quer receber credenciais.

   Se você recebeu seu ID do cliente e a chave secreta há alguns minutos e recebeu um erro, como Error: redirect_uri_mismatch, as alterações feitas podem não ter sido propagadas. Clique no botão "Voltar" no navegador, aguarde alguns minutos e tente clicar em Autorizar APIs novamente.
   Se você receber um erro que não foi concedido ao desenvolvedor e o app estiver em teste no momento, será necessário acessar a página da tela de permissão OAuth no projeto do GCP e realizar uma das seguintes ações:

   • Publique o app.

   • Mantenha o app no status "Teste" e adicione a si mesmo como usuário de teste.

7. Um aviso é exibido, indicando que seu app quer gerenciar suas campanhas do Google Ads. Clique em Aceitar para continuar.

8. Na guia Etapa 2: trocar o código de autorização dos tokens, um Código de autorização será exibido. Clique em Trocar código de autorização dos tokens.

   

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

   

10. Copie o Token de atualização no arquivo de configuração da biblioteca de cliente de sua escolha, junto com o ID do cliente e a Chave secreta do cliente.

11. Configure uma biblioteca de cliente para OAuth na API Google Ads.

Remover o OAuth2 Playground do seu código do cliente

Agora que você tem um token de atualização, não precisa mais do OAuth2 Playground para ser um URI de redirecionamento autorizado. Para removê-lo da lista de URIs de redirecionamento autorizados, faça o seguinte:

1. Vá para a página de 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 ativado.

5. Clique em Salvar.