Playground OAuth

Uma opção para gerar credenciais do OAuth2 é usar o OAuth2 Playground. Com o OAuth2 Playground e o console da API Google Ads, você pode 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, provavelmente é melhor configurar uma biblioteca de cliente para o OAuth no Search Ads 360.

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, em seguida, 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 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, conforme acima.

Gerar tokens

Aviso: o usuário do Search Ads 360 com o qual você fez login no seu navegador determina quais contas poderão ser acessadas com as credenciais do OAuth2 que você gerar. Portanto, convém seguir essas etapas em uma janela anônima ou sem fazer login na conta do Search Ads 360, já que é provável que o usuário cujas credenciais você quer usar não seja o mesmo com que você fez login quando recebeu o ID e a chave secreta do cliente.

1. Acesse o OAuth2 Playground. Esse link já preenche alguns valores-chave para você.

2. Clique no ícone de engrenagem no canto superior direito e marque a caixa de seleção Usar suas próprias credenciais do OAuth, caso ainda não esteja marcada.

3. Confira se:

   • o fluxo do OAuth está definido como Servidor;
   • 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 Search Ads 360 Reporting na lista e selecione o escopo https://www.googleapis.com/auth/doubleclicksearch. Depois clique em Authorize APIs:

   

6. Se solicitado, faça login na conta para que você quer conceder acesso e autorização. Caso contrário, confirme se o usuário atual no canto superior direito é a conta de cliente ou administrador para quem você quer receber credenciais.

   Se você recebeu o ID e a chave secreta do cliente alguns minutos atrás e recebeu um erro como Erro: redirect_uri_mismatch, é possível que as alterações feitas não tenham sido propagadas. Clique no botão "Voltar" do navegador, aguarde alguns minutos e tente clicar novamente em Autorizar APIs.
   Se você receber um erro informando que não recebeu acesso do desenvolvedor e o app estiver sendo testado no momento, será necessário acessar a página da tela de permissão OAuth no projeto do GCP e seguir um destes procedimentos:

   • Publique o app.

   • Mantenha o app no status "Teste" e adicione seu nome.

7. Vai aparecer um aviso indicando que seu app quer gerenciar suas campanhas do Search Ads 360. 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 deve aparecer. Clique em Trocar código de autorização para tokens.

   

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

   

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

11. Configure uma biblioteca de cliente para OAuth na API Search Ads 360 Reporting.

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, 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. Você precisa manter pelo menos um URI de redirecionamento.

5. Clique em Salvar.