このガイドでは、独自の認証情報とデスクトップ フローまたはウェブフローを使用して、API アクセスに OAuth2 を設定する方法について説明します。
1 つのアカウントの OAuth2 認証情報を生成する
Google Ads API アカウントを呼び出す最も簡単な方法は
API を呼び出すすべてのアカウントを、1 つの Google 広告クライアント センター(MCC)アカウントの下にリンクします。
GenerateUserCredentials
の例を使用して、MCC アカウントにアクセスできるユーザーの OAuth2 認証情報を生成します。OAuth2 認証情報を使用して、Google Ads API を使って管理する必要があるすべてのアカウントを呼び出します。
この手順は、OAuth2 認証情報の許可されたスコープを取り消すか削除するか、または変更する必要がある場合を除き、1 回だけ行います。
ステップ 1 - OAuth2 認証情報を作成する
クライアント ID とシークレットをメモしてから、このページに戻ります。
ステップ 2 - クライアント ライブラリを設定する
ターミナルで
GenerateUserCredentials
の例を実行します。これにより、OAuth2 クライアント ID とシークレットの入力を求められます。これはインタラクティブな例であり、入力が必要になります。
dotnet run GenerateUserCredentials.csproj
この例では、OAuth2 クライアント ID とシークレットを指定するように求められます。ステップ 1 の詳細を入力します。
この例では、ブラウザで URL が自動的に開きます。ブラウザ セッションにログインしていない場合は、ウェブページで Google アカウントへのログインを求められます。すでにログインしている場合は、ログイン プロンプトがスキップされ、Google 広告アカウントへのアクセスをアプリケーションに許可するよう求める URL にリダイレクトされます。
承認が成功したことを示すメッセージが表示されます。
更新トークンを取得しました。詳しい手順については、コンソールの出力をご覧ください。
例を実行していたコンソールに戻ります。サンプルを完了し、更新トークンといくつかの手順が表示されているはずです。その後、クライアント ライブラリを設定するために必要なプロパティが続きます。
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
をご覧ください。