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 にアクセスすると、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 ファイルをホーム ディレクトリに配置します。