Playground OAuth

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

O OAuth2 Playground é para usuários que só precisam acessar as contas de uma conta de administrador ou de um usuário do Google Ads único. Se você precisar solicitar credenciais de vários usuários, é melhor configurar uma biblioteca de cliente para o OAuth na API Google Ads.

Receber um ID e uma chave secreta do cliente

Aviso: para usar o OAuth2 Playground, gere um ID do cliente para um aplicativo da Web. Esse é o único tipo de aplicativo que funciona com o OAuth2 Playground. Consulte Selecionar um tipo de app para mais informações.

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

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.

3. Na página "Credenciais", selecione Criar credenciais e depois 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 conforme descrito na etapa 5.

Gerar tokens

Aviso: o usuário do Google com que você fez login no navegador determina quais contas do Google Ads podem ser acessadas com as credenciais do OAuth2 geradas. Portanto, talvez seja melhor fazer essas etapas em uma janela anônima ou quando você não estiver conectado à sua Conta do Google, já que é provável que o usuário cujas credenciais você quer usar não seja o mesmo usuário conectado quando você recebeu o ID e o segredo do cliente.

1. Acesse o OAuth2 Playground. Usar este link vai preencher alguns valores-chave para você.

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

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 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 Autorizar 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 do Google atual no canto superior direito é a conta do Google Ads ou de administrador para quem você quer receber credenciais.

   Se você recebeu o ID do cliente e a chave secreta há poucos minutos e recebeu um erro como Error: redirect_uri_mismatch, as mudanças que você fez podem não ter sido propagadas. Clique no botão "Voltar" do navegador, aguarde alguns minutos e clique em Autorizar APIs novamente.
   Se você receber um erro informando que não recebeu acesso do desenvolvedor e que o app está sendo testado, acesse a página da tela de consentimento do OAuth no seu projeto do GCP e faça uma das seguintes ações:

   • Publique o app.

   • Mantenha o app no status "Em teste" e adicione sua conta como usuário de teste.

7. Uma solicitação aparece indicando que o app quer gerenciar suas campanhas do Google Ads. Clique em Aceitar para continuar.

8. Na guia Etapa 2: trocar 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, os campos Token de atualização e Token de acesso serão preenchidos automaticamente. Talvez seja necessário abrir novamente a Etapa 2: trocar código de autorização por tokens:

   

10. Copie o token de atualização no arquivo de configuração da biblioteca de cliente escolhida, 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 é mais necessário que o OAuth2 Playground seja um URI de redirecionamento autorizado. Para remover da lista de URIs de redirecionamento autorizados:

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 no lugar.

5. Clique em Salvar.