Playground OAuth

Uma opção para gerar credenciais do OAuth2 é usar o OAuth2 Playground. O OAuth2 Playground, em conjunto com o console da API Google Ads, permite criar tokens OAuth2 manualmente.

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

Receber um ID do cliente e uma chave secreta do cliente

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

  1. Acesse o OAuth2 Playground (usar este link deve pré-preencher alguns valores de chave para você).

  2. Clique no ícone de engrenagem no canto superior direito e marque a caixa Usar 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 a chave secreta do cliente OAuth2 que você recebeu acima.

    playground settings

  5. Na seção Etapa 1: selecionar e autorizar APIs, clique em API Search Ads 360 Reporting na lista e selecione o escopo dela, https://www.googleapis.com/auth/doubleclicksearch. Em seguida, clique em Autorizar APIs:

    authorize apis

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

  7. Um aviso vai aparecer indicando que o 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 por tokens, um Código de autorização vai aparecer. Clique em Exchange authorization code for tokens.

    playground authcode token

  9. Se tudo der certo, 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 o código de autorização por tokens:

    token de atualização do Playground

  10. Copie o token de atualização para o 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 Search Ads 360 Reporting.

Remover o OAuth2 Playground do ID 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:

  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 ID do cliente para editar.

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

  5. Clique em Salvar.