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.

  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.