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 manualmente tokens OAuth2.

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ê precisa solicitar credenciais a vários usuários, é recomendável Configurar uma biblioteca de cliente para OAuth na API Google Ads.

Receber um ID e uma chave secreta do cliente

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, em seguida, selecione o 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

  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ê tiver um projeto na nuvem, poderá reutilizá-lo definindo os URIs de redirecionamento autorizados como acima.

Gerar tokens

  1. Acesse o Playground OAuth2. O link preencherá alguns valores-chave automaticamente.

  2. Clique no ícone de engrenagem no canto superior direito e marque a caixa Usar suas próprias credenciais do OAuth, caso ela não esteja 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.

    playground settings

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

    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 de administrador ou do Google Ads de quem você quer receber credenciais.

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

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

    playground authcode token

  9. Se tudo correr bem, os campos Token de atualização e Token de acesso estarão preenchidos para você. Talvez seja necessário expandir novamente Etapa 2: trocar código de autorização dos tokens:

    token de atualização do Playground

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

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

Remover o OAuth2 Playground do seu código do cliente

Agora que você tem um token de atualização, o OAuth2 Playground não precisa mais ser um URI de redirecionamento autorizado. Para removê-lo 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 ativo.

  5. Clique em Salvar.