OAuth デスクトップおよびウェブ アプリケーションのフロー

このガイドでは、独自の認証情報とデスクトップ フローまたはウェブフローを使用して、API アクセス用の OAuth2 を設定する方法について説明します。これらの手順は、OAuth2 認証情報で許可するスコープの取り消し、削除、変更を行う場合を除き、1 回だけ行います。

OAuth2 認証情報を作成する

  1. 手順に沿って、Google Ads API の Google API Console プロジェクトを設定します。

  2. クライアントの JSON ファイルをダウンロードします。ダウンロードするには、まず [OAuth クライアントをダウンロード] アイコンをクリックしてから、次の画面で [JSON をダウンロード] ボタンをクリックします。

    ファイルをホーム ディレクトリに保存して、ローカル ファイル ~/client_secret_XXX.apps.googleusercontent.com.json(XXX はプロジェクトに固有の値です)を作成します。次のステップでこのファイルを使用して、コードサンプルを実行します。

クライアント ライブラリを設定する

  1. ターミナルで GenerateUserCredentials のサンプルを実行します。コマンドライン フラグを使用して、前の手順でダウンロードした JSON ファイルを渡します。

    Gradle を使用してコマンドラインから実行するには

    ./gradlew --console=plain --quiet runExample \
      --example="authentication.GenerateUserCredentials \
      --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
    
  2. この例では、URL にアクセスするよう求められます。この URL で、OAuth2 認証情報がユーザーに代わって Google 広告アカウントにアクセスできるようにします。

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

    シークレット ブラウジング セッションまたはシークレット ウィンドウで URL に移動します。Google 広告へのアクセスに使用している Google アカウントでログインします。OAuth2 同意画面で [続行] をクリックします。

    同意画面

  3. 承認が成功したことを示すメッセージが表示されます。

    認証コードが正常に取得されました。

    詳しい手順については、GenerateUserCredentials のコンソール出力をご覧ください。

  4. サンプルを実行しているコンソールに戻ります。サンプルが完了し、更新トークンと手順が表示され、その後にクライアント ライブラリの構成に必要なプロパティが表示されます。

    #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. 日付コメント # から出力の末尾までの行を ads.properties ファイルにコピーします。

    INSERT_DEVELOPER_TOKEN_HERE は、実際の開発者トークンに置き換えてください。

    最も簡単な設定を行うには、ads.properties ファイルをホーム ディレクトリに配置します。