プロジェクトで Video Stitcher API を有効にするには、アカウント担当者に問い合わせるか、営業担当者にお問い合わせください。

ライブストリームイベントの構成を作成する

アドマネージャーを統合するには、特定のライブストリームイベントに対してライブ構成を作成する必要があります。動的ストレッチャー API では、この構成がアドマネージャーに登録されます。

ソースマニフェストの要件

Video Stitcher API は、ソースマニフェストを解析して、構成をアドマネージャーに登録します。ソースマニフェストは、形式に応じて特定の特性を持つ必要があります。

HLS

コンテナ形式は FMP4 または多重化された MPEG-TS であることが必要です。
マニフェストに、次の（適切に入力された）フィールドを持つレンディションが少なくとも 1 つあることが必要です。
- コーデック
- bandwidth

MPEG-DASH

MPD@type を動的（@type="dynamic"）に設定
MPD@profiles には、ISO ライブプロファイル urn:mpeg:dash:profile:isoff-live:2011 が含まれる
1 つ以上の期間に、1 つ以上のアダプテーションセットが含まれる
各アダプテーションセットには 1 つ以上の表現が含まれる
表現には、 $Number$ または $Time$ の識別子を持つ SegmentTemplate が含まれるか、継承されている
すべてのアダプテーションセットで @segmentAlignment を true に設定する
表現は空でない必要がある

ライブ構成ファイルを作成する

構成を作成するには、projects.locations.liveConfigs.create メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_NUMBER: IAM 設定ページの [プロジェクト番号] フィールドにある Google Cloud プロジェクト番号
LOCATION: 構成を作成するロケーション。サポートされているリージョンのいずれかを使用します。
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
LIVE_CONFIG_ID: ライブ構成のユーザー定義の識別子。この ID に使用できるのは、小文字、数字、ハイフンに限られます。最初の文字は英字で、最後の文字は英字または数字で、ID 全体は最大 63 文字です。
SOURCE_LIVESTREAM_URI: ライブストリーム動画マニフェストのソース URL。動画スティッチャー API にアクセスできる必要があります。URL は一般公開されている必要があります。もしくは、CDN に対して URL 署名が有効になっている場合には、登録済みの CDN 鍵が動画スティッチャー API に提供されている必要があります。Live Stream API を使用してテストライブストリームを作成した場合、これは Cloud Storage バケットの main.m3u8 ファイルまたは main.mpd ファイルの URI です。
AD_TAG_URI: （この値を以下のリクエスト JSON コードブロックに貼り付けます）。広告サーバーから取得した広告メタデータの URL。アドマネージャーとの統合では、有効なアドマネージャーのライブ動画広告タグである必要があります。有効な広告タグを取得するには、動画とオーディオの広告タグを生成するの手順に沿って以下を変更します。
- [ライブトラフィック] で、ライブトラフィックを有効にします。
- [プレーヤーの SDK タイプ] で [Google IMA SDK] を選択します。
- タグにパラメータ ad_rule=0 を追加します（たとえば、&ad_rule=0 を末尾に追加します）。
NETWORK_CODE: アドマネージャーネットワークの数値識別子。パブリッシャーアカウントのグローバル設定にあります。

JSON 本文のリクエスト:

{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "CLIENT"
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存します。ターミナルで次のコマンドを実行して、このファイルを現在のディレクトリに作成または上書きします。

cat > request.json << 'EOF'
{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "CLIENT"
}
EOF

そのうえで、次のコマンドを実行して REST リクエストを送信します。

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "x-goog-user-project: PROJECT_NUMBER" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs?liveConfigId=LIVE_CONFIG_ID"

PowerShell（Windows）

@'
{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "CLIENT"
}
'@  | Out-File -FilePath request.json -Encoding utf8

その後、次のコマンドを実行して REST リクエストを送信します。

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs?liveConfigId=LIVE_CONFIG_ID" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID",
    "verb": "create",
    "cancelRequested": false,
    "apiVersion": "v1"
  },
  "done": false
}

このコマンドは、進行状況を追跡するためにクエリできる長時間実行オペレーション（LRO）を作成します。次のセクションで使用するために、返された OPERATION_ID（name フィールドの最後の部分）をコピーします。

結果を確認する

動画スティッチャー API は、構成をアドマネージャーアカウントに非同期で登録します。これには数分かかります。

projects.locations.operations.get メソッドを使用して、ライブ構成ファイルが作成されたかどうかを確認します。レスポンスに "done: false" が含まれている場合は、レスポンスに "done: true" が含まれるまでコマンドを繰り返します。

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_NUMBER: IAM 設定ページの [プロジェクト番号] フィールドにある Google Cloud プロジェクト番号
LOCATION: データのロケーション。サポートされているリージョンのいずれかを使用します。
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
OPERATION_ID: オペレーションの ID。

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "x-goog-user-project: PROJECT_NUMBER" \
    "videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID"

PowerShell（Windows）

次のコマンドを実行します。

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.media.asset.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "endTime": END_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID",
    "verb": "create",
    "cancelRequested": false,
    "apiVersion": "v1"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.LiveConfig",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID",
    "sourceUri": "SOURCE_LIVESTREAM_URI",
    "adTagUri": "AD_TAG_URI",
    "gamLiveConfig": {
      "networkCode": "NETWORK_CODE",
      "assetKey": "ASSET_KEY",
      "customAssetKey": "PROJECT_NUMBER-LOCATION-LIVE_CONFIG_ID"
    },
    "state": "READY",
    "adTracking": "CLIENT",
    "stitchingPolicy": "CUT_CURRENT"
  }
}

構成を取得する

構成を取得するには、projects.locations.liveConfigs.get メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_NUMBER: IAM 設定ページの [プロジェクト番号] フィールドにある Google Cloud プロジェクト番号
LOCATION: ライブ構成ファイルのロケーション。サポートされているリージョンのいずれかを使用してください。
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
LIVE_CONFIG_ID: ライブ構成ファイルのユーザー定義の識別子。

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID"

PowerShell（Windows）

次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID",
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
    "assetKey": "ASSET_KEY",
    "customAssetKey": "PROJECT_NUMBER-LOCATION-LIVE_CONFIG_ID"
  },
  "state": "READY",
  "adTracking": "CLIENT",
  "stitchingPolicy": "CUT_CURRENT"
}

customAssetKey フィールドを見つけて、返された CUSTOM_ASSET_KEY をコピーします。これらの値は、次のステップで Interactive Media Ads（IMA）SDK に送信されます。

Media CDN の CDN キーを設定する

クライアントアプリケーションを準備して Google アドマネージャーと連携させる

ライブ ストリーム イベントの構成を作成する

ソース マニフェストの要件

HLS

MPEG-DASH

ライブ構成ファイルを作成する

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

結果を確認する

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

構成を取得する

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

ライブストリームイベントの構成を作成する

ソースマニフェストの要件