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. ターミナルで generate_user_credentials のサンプルを実行します。コマンドライン フラグを使用して、前の手順でダウンロードした JSON ファイルを渡します。

    generate_user_credentials.py \
      --client_secrets_path=${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. 承認が成功したことを示すメッセージが表示されます。

    更新トークンが取得されました。詳しい手順については、コンソールの出力をご覧ください。

  4. サンプルを実行したコンソールに戻ります。更新トークンとクライアント ライブラリの構成手順が表示されているはずです。

    Your refresh token is: 1/Yw.........................................
    Add your refresh token to your client library configuration as described here:
    https://developers.google.com/google-ads/api/docs/client-libs/python/configuration