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

このページは Cloud Translation API によって翻訳されました。

ライブ配信イベントの構成を作成する

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

スレートを作成する

ライブ構成を作成する前に、スレートを作成する必要があります。Video Stitcher API は、広告を挿入できない場合に、デフォルトのスレート動画を挿入します。スレート動画を Video Stitcher API に登録し、広告がない場合に使用するスレートを指定する必要があります。スレート動画には、少なくとも 1 つの音声トラックがある MP4 ファイルを使用できます。

このスレートを作成する方法は 2 つあります。アドマネージャーアカウントでデフォルトのネットワークスレートを作成する方法と、Video Stitcher API を使用してスレートを作成する方法です。

アドマネージャーでスレートを作成する

アドマネージャーアカウントでデフォルトのネットワークスレートを作成するには、コンテンツギャップを埋めるスレートを作成するの手順を実行してから、ライブ構成ファイルを作成するのセクションに進みます。

Video Stitcher API を使用してスレートを作成する

Video Stitcher API を使用してスレートを作成するには、projects.locations.slates.create メソッドを使用します。

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

PROJECT_NUMBER: プロジェクト番号。IAM 設定ページの [プロジェクト番号] フィールドにあります。 Google Cloud
LOCATION: スレートを作成するロケーション。サポートされているリージョンのいずれかを使用します。
ロケーションを表示
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
SLATE_ID: スレートのユーザー定義の識別子。この ID に使用できるのは、小文字、数字、ハイフンに限られます。最初の文字は英字で、最後の文字は英字または数字で、ID 全体は最大 63 文字です。
SLATE_URL: 音声トラックが少なくとも 1 つある MP4 動画の公開 URI（サンプル動画）
NETWORK_CODE: アドマネージャーネットワークの数値識別子。パブリッシャーアカウントのグローバル設定にあります
重要: Google アドマネージャー（GAM）でスレートを使用するには、gamSlate オブジェクトを含める必要があります。

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

curl（Linux、macOS、Cloud Shell）

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

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

cat > request.json << 'EOF'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "networkCode": "NETWORK_CODE"
  }
}
EOF

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/slates?slateId=SLATE_ID"

PowerShell（Windows）

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

@'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "networkCode": "NETWORK_CODE"
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

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

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/slates?slateId=SLATE_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/slates/SLATE_ID",
    "verb": "create"
  },
  "done": false
}

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

結果を確認する

スレートが作成されたかどうかを確認するには、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 print-access-token)" \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID"

PowerShell（Windows）

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

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://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.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "endTime": END_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "verb": "create"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.Slate",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "uri": "SLATE_URL",
    "gamSlate": {
      "networkCode": "NETWORK_CODE"
      "gamSlateId": "GAM_SLATE_ID"
    }
  }
}

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

構成を作成するには、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
```
広告サーバーから取得した広告メタデータの URL。アドマネージャーとの統合では、有効なアドマネージャーのライブ動画広告タグである必要があります。有効な広告タグを取得するには、以下の変更とともに動画とオーディオの広告タグを生成するの手順に沿って操作します。
- [ライブ配信] でライブ配信を有効にします。
- [プレーヤーの SDK タイプ] で [Google IMA SDK] を選択します。
- タグにパラメータ ad_rule=0 を追加します（たとえば、&ad_rule=0 を末尾に追加します）。
SLATE_ID: 合成された広告がない場合に使用するスレートの ID
注: アドマネージャーを使用してデフォルトネットワークスレートを作成した場合に、デフォルトネットワークスレートを使用するには、リクエストから defaultSlate フィールドを削除します。
NETWORK_CODE: アドマネージャーネットワークの数値識別子。パブリッシャーアカウントのグローバル設定にあります。
AD_TRACKING: ストリームの広告トラッキング動作。IMA SDK 統合の場合は、CLIENT を使用します。サーバーサイド広告トラッキングの場合は、SERVER を使用します。この値は、後でセッションごとにオーバーライドすることも可能です。

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

curl（Linux、macOS、Cloud Shell）

cat > request.json << 'EOF'
{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
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 \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs?liveConfigId=LIVE_CONFIG_ID"

PowerShell（Windows）

@'
{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
'@  | 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 "https://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"
  },
  "done": false
}

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

このコマンドは、進行状況を追跡するためにクエリできる長時間実行オペレーション（LRO）を作成します。詳細については、結果を確認するをご覧ください。

構成を取得する

構成を取得するには、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）

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://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 "https://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",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "stitchingPolicy": "CUT_CURRENT"
}

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

概要

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

ライブ配信イベントの構成を作成する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

スレートを作成する

アド マネージャーでスレートを作成する

Video Stitcher API を使用してスレートを作成する

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

結果を確認する

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

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

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

構成を取得する

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

ライブ配信イベントの構成を作成する

アドマネージャーでスレートを作成する