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

このガイドでは、独自の認証情報とデスクトップ フローまたはウェブフローのいずれかを使用して、API アクセスのために OAuth2 を設定する方法について説明します。

1 つのアカウントに OAuth2 認証情報を生成する

Google Ads API アカウントを呼び出す最も簡単な方法は

  1. API 呼び出しを行うすべてのアカウントを、1 つの Google 広告クライアント センター（MCC）アカウントの下にリンクします。

  2. GenerateUserCredentials サンプルを使用して、MCC アカウントへのアクセス権を持つユーザーの OAuth2 認証情報を生成します。

  3. OAuth2 の認証情報を使って、Google Ads API を使って管理する必要があるすべてのアカウントを呼び出します。

この手順は、OAuth2 認証情報の許可スコープを取り消すか削除するか、変更する必要がない限り、1 回だけ行う必要があります。

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

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

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

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

  1. ターミナルで GenerateUserCredentials サンプルを実行します。これにより、OAuth2 クライアント ID とクライアント シークレットの入力を求められます。

    これはインタラクティブな例であり、入力が必要になります。

    dotnet run GenerateUserCredentials.csproj

  2. この例では、OAuth2 クライアント ID とシークレットの入力を求められます。ステップ 1 で取得した詳細情報を入力します。

  3. この例では、ブラウザで URL が自動的に開きます。ブラウザ セッションにログインしていない場合は、ウェブページで Google アカウントへのログインを求められます。すでにログインしている場合は、ログイン プロンプトがスキップされ、アプリケーションがユーザーに代わって Google 広告アカウントにアクセスすることを承認するよう求められる URL にリダイレクトされます。

    同意画面

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

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

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

    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 = '******' />

Make sure you also set the LOGIN_CUSTOMER_ID header. See
https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration#google_ads_api_settings
to learn more.

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

See https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration
for alternate configuration options.

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

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