このドキュメントでは、Ad Manager API の認証方法について説明します。Google 使用するインターフェースと、使用する環境によって、 が、すべての API リクエストには、API トークンを Ad Manager API のスコープ。
アド マネージャーのクライアント ライブラリでは、アプリケーションのデフォルト認証情報が使用されます。 を使用して、Ad Manager API スコープのアクセス トークンを生成します。このガイドでは、 アプリケーションのデフォルト認証情報を構成する方法を説明します。
クライアント ライブラリを使用していない場合でも、認証情報を作成する必要がある リクエストを承認するために使用します
認証と認可の詳細については、コースのリソース OAuth 2.0 の使用ガイド
認証タイプを決定する
| 認証タイプ | 説明 |
|---|---|
| サービス アカウント | Google Workspace の専用アカウントとして認証する場合は、
アクセスを許可できます。 詳細 |
| ウェブ アプリケーション | 任意のユーザーとして認証する場合は、これを選択します。
アプリケーションにアクセスする権限を付与するユーザー
アドマネージャーのデータを処理できます 詳細 |
| ローカルでの開発 | 自身のアカウントとして認証する場合は、これを選択します ローカルの Google アカウントまたはサービス アカウント 開発環境です。 |
Ad Manager API を有効にする
Ad Manager API を Google API Console クラウド プロジェクト。
プロンプトが表示されたら、プロジェクトのいずれかを選択するか、新しいプロジェクトを作成します。
認証情報を作成
認証タイプのタブをクリックし、 認証情報を作成します。
サービス アカウント
Google Cloud
Google Cloud で実行されているワークロードを認証するには、Google Cloud の コードが配置されているコンピューティング リソースに できます。
たとえば、サービス アカウントを Compute Engine 仮想マシンの Cloud Run サービス、Dataflow ジョブによって定義できます。このアプローチは Google Cloud で実行するコードに推奨される認証方法である コンピューティング リソースです。
サービス アカウントを接続できるリソースについては、 サービス アカウントをリソースに関連付ける方法については、 サービス アカウントの接続に関するドキュメントをご覧ください。
オンプレミスまたは別のクラウド プロバイダ
Google Cloud の外部から認証を設定する際の推奨方法は、
Workload Identity 連携を使用する。新しい
認証情報の構成ファイルを作成し、GOOGLE_APPLICATION_CREDENTIALS を
そのリソースを指定します。この方法は、他の VM よりも
サービス アカウント キーを作成します。
Workload Identity 連携を構成できない場合は、次のことを行う必要があります。 サービス アカウントを作成し、そのサービス アカウントのキーを作成します。
[認証情報] ページで [認証情報を作成] を選択し、 [Service Account] を選択します。
作成するサービス アカウントのメールアドレスをクリックします。 指定します。
[キー] タブをクリックします。
[鍵を追加] プルダウン メニューをクリックし、[新しい鍵を作成] を選択します。
鍵のタイプとして [JSON] を選択し、[作成] をクリックします。
環境変数
GOOGLE_APPLICATION_CREDENTIALSをパスに設定します。 必要があります。
Linux または macOS
export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH
Windows
set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH
ウェブ アプリケーション
プロンプトが表示されたら、Ad Manager API を有効にしたプロジェクトを選択します。
[認証情報] ページで [認証情報を作成] を選択し、 [OAuth クライアント ID] を選択します。
アプリケーションの種類として [ウェブ アプリケーション] を選択します。
フォームに入力し、[作成] をクリックします。言語と方法を使用するアプリケーション フレームワーク（PHP、Java、Python、Ruby、.NET など）では、 リダイレクト URI。リダイレクト URI は、OAuth 2.0 サーバーの レスポンスを送信できます。これらのエンドポイントは、Google の 検証ルールをご覧ください。
認証情報を作成したら、client_secret.json ファイルをダウンロードします。そのアプリケーションだけがアクセスできる場所にファイルを安全に保存します。
こちらの手順に沿って OAuth 2.0 アクセス トークンを取得します。
ローカルでの開発
ローカル環境でアプリケーションのデフォルト認証情報（ADC）を設定します。
Google Cloud CLI をインストールし、次のコマンドを実行して初期化します。 command:
gcloud init
Google アカウントのローカル認証情報を作成し、 プロジェクト ID を、Ad Manager API が有効になっているプロジェクトにマッピングします。
gcloud auth application-default login --scopes="https://www.googleapis.com/auth/admanager"
gcloud auth application-default set-quota-project PROJECT_ID
または、環境を設定するサービス アカウントとして認証します。
変数 GOOGLE_APPLICATION_CREDENTIALS を鍵ファイルのパスに置き換えます。
Linux または macOS
export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH
Windows
set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH
アド マネージャー ネットワークを設定する
サービス アカウント
- アド マネージャー ネットワークに移動します。
- [管理者] タブをクリックします。
- [API アクセス] が有効になっていることを確認します。
- [サービス アカウント ユーザーを追加] ボタンをクリックします。
- サービス アカウントのメールアドレスを使用してフォームに入力します。「 サービス アカウント ユーザーを適切なロールとチームに追加する必要があります。 API 統合の参考になります
- [Save] ボタンをクリックします。次の内容を確認するメッセージが表示されます。 サービスアカウントを追加できます
- [ユーザー] タブに移動して既存のサービス アカウント ユーザーを表示し、 [サービス アカウント] フィルタをクリックします。
ウェブ アプリケーション
- アド マネージャー ネットワークに移動します。
- [管理者] タブをクリックします。
- [API アクセス] が有効になっていることを確認します。
ローカルでの開発
- アド マネージャー ネットワークに移動します。
- [管理者] タブをクリックします。
- [API アクセス] が有効になっていることを確認します。
クライアント ライブラリを使用しない場合
クライアント ライブラリを使用しない場合でも、 使用します。
アクセス トークンを取得する詳しい手順については、以下をご覧ください。 Google API で OAuth2 を使用する
アクセス トークン
API へのリクエストにアクセス トークンを含めるには、
access_token クエリ パラメータまたは Authorization HTTP ヘッダーの Bearer 値。
クエリ文字列は頻繁に作成されることが多いため、可能な限り HTTP ヘッダーを使用することをおすすめします。
サーバーログに記録されます。
例:
GET /v1/networks/1234
Host: admanager.googleapis.com
Authorization: Bearer ya29.a0Ad52N3_shYLX
GET https://admanager.googleapis.com/v1/networks/1234?access_token=1/fFAGRNJru1FTz70BzhT3Zg
範囲
各アクセス トークンは 1 つ以上のスコープに関連付けられています。スコープは、 アクセス トークンで許可されるリソースとオペレーションのセットです。アド マネージャー REST API のスコープは 1 つのみです。承認はユーザー単位で行う必要があります。 継承されます。
| 範囲 | 権限 |
|---|---|
https://www.googleapis.com/auth/admanager
|
キャンペーンの表示と管理 詳しく説明します |