Fluxos de aplicativos da Web e área de trabalho OAuth

Este guia explica como configurar o OAuth2 para acesso à API usando seu suas próprias credenciais e a configuração "Desktop" fluxo ou a Web fluxo. Você só precisa concluir essas etapas uma vez, a menos que você revogue, exclua ou precise alterar os escopos Credenciais do OAuth2.

Criar credenciais do OAuth2

  1. Siga as etapas para configurar um projeto do Console de APIs do Google para a API Google Ads.

  2. Faça o download do arquivo JSON do cliente clicando primeiro em Fazer download do OAuth cliente e no botão FAZER O DOWNLOAD do JSON na tela a seguir.

    Salve o arquivo no diretório principal para ter o arquivo local ~/client_secret_XXX.apps.googleusercontent.com.json (onde XXX estará valores específicos do seu projeto). Usaremos esse arquivo na próxima etapa para execute o exemplo de código.

Configure a biblioteca de cliente.

  1. Em um terminal, execute o comando GenerateUserCredentials exemplo. Use sinalizações de linha de comando para passar o arquivo JSON em que você fez o download na etapa anterior.

    Para executar a partir da linha de comando usando o Gradle

    ./gradlew --console=plain --quiet runExample \
  --example="authentication.GenerateUserCredentials \
  --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"

  2. O exemplo vai solicitar que você acesse um URL em que é necessário permitir que o credenciais do OAuth2 para acessar a conta do Google Ads em seu nome.

    Paste this URL in your browser:
https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...

    Acesse o URL em uma sessão particular de navegador ou em uma janela anônima. Faça login com a mesma Conta do Google que você usa para acessar o Google Ads. Clique em Continuar na tela de consentimento do OAuth2.

    Tela de consentimento

  3. Você será direcionado a uma página com uma mensagem indicando que a autorização bem-sucedido.

    O código de autorização foi recuperado.

    Confira a saída do console de GenerateUserCredentials para mais instruções.

  4. Volte ao console em que o exemplo está sendo executado. Você vai notar que o foi concluído e está exibindo seu token de atualização e alguns seguidas pelas propriedades necessárias para configurar o biblioteca de cliente:

    #Mon Apr 18 09:07:51 EDT 2022
api.googleads.refreshToken=1/Yw.........................................
api.googleads.clientId=...........-...............apps.googleusercontent.com
api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
api.googleads.clientSecret=........................

  5. Copie as linhas do comentário de data # no final da saída na sua arquivo ads.properties.

    Substitua INSERT_DEVELOPER_TOKEN_HERE pelo seu token de desenvolvedor.

    Para facilitar a configuração, coloque o arquivo ads.properties na sua casa diretório.