Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

認証と承認

他の Google API と同様に、Google Ads API は認証と認可に OAuth 2.0 プロトコルを使用します。OAuth 2.0 を使用すると、Google Ads API クライアントアプリは、ユーザーのログイン情報を処理または保存することなく、ユーザーの Google 広告アカウントにアクセスできます。

このガイドでは、最も一般的な 3 つの OAuth 2.0 フローを使用して Google Ads API 認証用の Java クライアントライブラリを構成する方法と、必要な認証情報について説明します。

Google Ads API のアクセスモデルについて詳しくは、Google 広告のアクセスモデルガイドをご覧ください。

認証情報

Google Ads API にアクセスするには、OAuth 2.0 認証情報と、場合によってはログイン用のお客様 ID が必要です。

OAuth 2.0 認証情報

Google 広告アカウントにアクセスできる Google アカウントユーザーとして認可するには、OAuth 2.0 認証情報のセットを指定する必要があります。必要な認証情報の種類は、使用する OAuth 2.0 フローによって異なります。

このライブラリは、次の 3 つのフローをサポートしています。

サービスアカウントフロー
シングルユーザー認証フロー
マルチユーザー認証フロー

Google Ads API の OAuth フローの詳細については、OAuth の概要をご覧ください。必要な認証情報を取得するには、ニーズに最適なフローの手順に沿って操作してください。

必要に応じて、広告配信中アカウントへのアクセス権を提供するマネージャーアカウントのお客様 ID を指定します。マネージャーアカウントを介してクライアントアカウントにアクセスする場合は、これを指定する必要があります。お客様 ID へのパス上のすべてのマネージャーアカウントを指定する必要はありません。アクセス権限に使用している最上位のマネージャー ID のみを指定します。詳細については、関連ドキュメントをご覧ください。

クライアントライブラリでは、ログインお客様 ID は ads.properties ファイルの api.googleads.loginCustomerId キーで指定されます。

構成

クライアントライブラリは、ads.properties ファイル、環境変数、またはプログラムで構成できます。このガイドでは、ads.properties ファイルの使用に焦点を当てています。すべてのオプションの詳細については、構成ガイドをご覧ください。

ads.properties ファイルを使用する場合は、ホームディレクトリ ~/ads.properties に配置します。

OAuth ワークフロー

Google Ads API を使用する際に、よく使われるワークフローが 3 つあります。

サービスアカウントフロー

ワークフローに人間の操作が必要ない場合は、このワークフローをおすすめします。このワークフローでは、ユーザーが Google 広告アカウントにサービスアカウントを追加する構成手順が必要です。アプリは、サービスアカウントの認証情報を使用して、ユーザーの Google 広告アカウントを管理できます。

秘密鍵の JSON ファイルを取得したら、ads.properties ファイルに次の行を追加します。

api.googleads.serviceAccountSecretsPath=INSERT_PATH_TO_JSON_HERE
# Only add this key if you are using Google Workspace domain-wide delegation
# to impersonate a user who has access to the Google Ads account.
# api.googleads.serviceAccountUser=USER_EMAIL_TO_IMPERSONATE

詳細については、サービスアカウントのワークフローガイドをご覧ください。

シングルユーザー認証フロー

このワークフローは、サービスアカウントを使用できない場合に使用できます。このワークフローでは、次の 2 つの構成手順が必要です。

Google Ads API を使用して管理するすべてのアカウントへのアクセス権を 1 人のユーザーに付与します。一般的な方法は、ユーザーに Google Ads API MCC アカウントへのアクセス権を付与し、その MCC アカウントの下にあるすべてのターゲット Google 広告アカウントをリンクすることです。
ユーザーが gcloud CLI や GenerateUserCredentials コードサンプルなどのコマンドラインツールを実行して、ユーザーに代わってすべての Google 広告アカウントを管理することをアプリに許可します。

これらの認証情報を取得したら、ads.properties ファイルに次の行を追加します。

api.googleads.clientId=INSERT_CLIENT_ID_HERE
api.googleads.clientSecret=INSERT_CLIENT_SECRET_HERE
api.googleads.refreshToken=INSERT_REFRESH_TOKEN_HERE

詳細については、単一ユーザー認証ワークフローガイドをご覧ください。

マルチユーザー認証フロー

このワークフローは、アプリでユーザーがログインし、アプリがユーザーに代わって Google 広告アカウントを管理することを承認できる場合におすすめです。GenerateUserCredentials のコード例は、実行時にユーザー認証を取得して、ユーザーに代わって Google 広告アカウントを管理する方法を示すコマンドラインツールです。このコード例は、ユーザー認証を必要とするデスクトップアプリやウェブアプリを構築する際の参考として使用できます。

マルチユーザーアプリケーションの場合は、アプリケーションの OAuth 2.0 クライアント ID とクライアントシークレットを ads.properties（または別の構成ストア）に保存し、各エンドユーザーの更新トークンをアプリケーションデータベースに安全に保存して、UserCredentials と GoogleAdsClient のビルド時にプログラムで渡します。

api.googleads.clientId=INSERT_CLIENT_ID_HERE
api.googleads.clientSecret=INSERT_CLIENT_SECRET_HERE

詳細については、マルチユーザー認証ワークフローガイドをご覧ください。

複数のアカウントを管理する

ユーザーが複数の Google 広告アカウントを管理することはよくあります。アカウントに直接アクセスするか、Google 広告クライアントセンター（MCC）アカウントを使用します。Java クライアントライブラリには、このようなケースを処理する方法を示す次のコード例が用意されています。

GetAccountHierarchy のコード例は、Google 広告 MCC アカウントのすべてのアカウントのリストを取得する方法を示しています。
ListAccessibleCustomers のコード例は、ユーザーが直接アクセスできるすべてのアカウントのリストを取得する方法を示しています。これらのアカウントは、loginCustomerId 設定の有効な値として使用できます。

アプリケーションのデフォルト認証情報

Java クライアントライブラリは、アプリケーションのデフォルト認証情報による認証もサポートしています。

これは、ローカル開発や、異なる Google API に対する開発で特に役立ちます。必要な OAuth 2.0 スコープにアクセスできる限り、同じ認証情報を再利用できるためです。

Google Ads API の場合、アプリケーションのデフォルト認証情報が https://www.googleapis.com/auth/adwords OAuth 2.0 スコープにアクセスできることを確認します。

アプリケーションのデフォルト認証情報を使用するには、ads.properties ファイルで api.googleads.useApplicationDefaultCredentials オプションを true に設定します（または GoogleAdsClient.newBuilder() で .enableApplicationDefaultCredentials() を呼び出します）。アプリケーションのデフォルト認証情報を使用する場合、クライアント ID、クライアントシークレット、更新トークンは設定しないでください。

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