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

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

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

ステップ 1 - OAuth2 認証情報を作成する

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

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

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

ステップ 2 - クライアント ライブラリを設定する

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

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

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

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