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

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

OAuth 2.0 認証情報を作成する

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

  2. クライアント ID とクライアント シークレットをメモしてから、このページに戻ります。

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

  1. ターミナルで GenerateUserCredentials の例を実行します。プロンプトが表示されたら、OAuth 2.0 クライアント ID とクライアント シークレットを入力します。

    dotnet run GenerateUserCredentials.csproj

  2. このコードサンプルでは、URL がブラウザで自動的に開きます。ブラウザ セッションにログインしていない場合は、ウェブページに Google アカウントへのログインを求めるメッセージが表示されます。すでにログインしている場合は、ログイン プロンプトをスキップして、URL にリダイレクトされます。この URL で、アプリがユーザーに代わって Google 広告アカウントにアクセスできるように承認する必要があります。

    Google 広告にアクセスする際に使用している Google アカウントでログインします。通常、これは、アカウント階層で管理する必要があるすべてのアカウントを含む Google 広告 MCC アカウントへのログイン メールです。OAuth 2.0 同意画面で [続行] をクリックします。

    OAuth 2.0 同意画面

    認証が成功したことを示すメッセージが表示されたページに移動します。

    Your refresh token has been fetched. Check the
console output for further instructions.

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

    Copy the following content into your App.config file.

<add key = 'OAuth2Mode' value = 'APPLICATION' />
<add key = 'OAuth2ClientId' value = '******' />
<add key = 'OAuth2ClientSecret' value = '******' />
<add key = 'OAuth2RefreshToken' value = '******' />

    App.config ファイルで LOGIN_CUSTOMER_ID ヘッダーも設定してください。詳細については、 構成ガイドをご覧ください。

    <add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />

    その他の構成オプションについては、構成ガイドをご覧ください。

インタラクティブ アプリケーションの OAuth2 認証情報を生成する

API 呼び出しを行う Google 広告アカウントを事前に把握していない場合は、セッションにログインしているユーザーの認証情報を使用して、実行時にアカウントを検出できます。現在ログインしているユーザーが認証され、OAuth2 認証情報が実行時に取得される例については、AuthenticateInAspNetCoreApplication をご覧ください。