クライアント アプリケーション用に必須情報を収集する
Google アド マネージャーで VOD アセット セッションを作成するために必要な次の情報が必要です。
| フィールド | 説明 |
|---|---|
projectNumber | アド マネージャー対応セッションの作成に使用される
Google Cloudプロジェクト番号
(PROJECT_NUMBER)
代わりに、プロジェクトIDを使用することもできます。 |
region |
IMA SDK で VOD セッションの作成に使用する
ロケーション
（LOCATION）。 |
vodConfigId | Video Stitcher API で VOD ストリームを登録するために使用される VOD 構成 ID。構成リソース名全体の形式は次のとおりです。projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID VOD_CONFIG_ID）の最後の部分です。構成のロケーションは、VOD セッションを作成するロケーションと同じものにする必要があることに留意してください。 |
networkCode | アド マネージャー ネットワークの数値識別子（NETWORK_CODE）。 |
oAuthToken | 動画スティッチャー ユーザーのロールを持つサービス アカウントの有効期間が短い OAuth トークン有効期間が短い OAuth トークンを生成するをご覧ください。 |
表 1.アド マネージャー対応の VOD アセット セッションに必要な情報
テスト用に有効期間が短い OAuth トークンを生成する
動画スティッチャー ユーザーのロールを持つサービス アカウントに関連付けられた有効期間が短い OAuth トークンを生成するには、次の手順を行います。
PATH_TO_YOUR_SERVICE_KEYは、ローカルマシンにダウンロードした JSON ファイルのパスに置き換えます。gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
- サービス アカウントから OAuth 2.0 署名なしトークンを取得します。
gcloud auth print-access-token
こちらは有効期間が短いトークンであるため、gcloud auth print-access-token コマンドを使用してトークンを定期的に再生成し、新しいトークンをクライアント アプリケーションに送信する必要があります。有効期間の短いトークンを提供する本番環境サービスの構築については、次のセクションをご覧ください。
クライアント アプリケーションに情報を提供するサービスを作成する
クライアントに渡される必須情報を提供可能なサービスを作成します。アプリケーションからサービスに VOD アセットの再生方法に関する情報が要求されると、サービスは表 1 に記載された情報を返す必要があります。
特に、このサービスは安全な方法でクライアント アプリケーションに OAuth トークンを提供しなければなりません。2 つのサービス アカウントを使用してこのサービスを構成します（1 つは他方のアカウントの権限借用）。1 つのサービス アカウントにサービス トークン作成者のロールが付与され、動画スティッチャー ユーザーのロールを持つサービス アカウントに対して OAuth トークンが作成されます。次に例を示します。
- サービス アカウント 1: 呼び出し元のサービス アカウントです。このアカウントは、サービス アカウント 2 に対するサービス トークン作成者権限を持ち、クライアント アプリケーションに対するサービス アカウント 2 の権限を借用します。
- サービス アカウント 2: これはセッションを作成する動画スティッチャー ユーザーのロールを持つ権限借用サービス アカウントです。
クライアント ライブラリのコードサンプルを含む、サービスから OAuth トークンを提供する方法については、有効期間の短いアクセス トークンを作成するをご覧ください。