為直播活動建立設定

如要整合 Ad Manager，您必須為特定直播活動建立直播設定。Video Stitcher API 會將此設定註冊至 Ad Manager。

建立插入畫面

建立直播設定之前，請先建立插入畫面。在無法插入廣告時，Video Stitcher API 會插入預設的暫離字卡影片。您必須使用 Video Stitcher API 註冊標題卡影片，才能在沒有廣告時使用標題卡。標題卡影片可以是任何含有至少一個音軌的 MP4 檔案。

建立這個資訊板有兩種方法。您可以在 Ad Manager 帳戶中建立預設的聯播網片尾，也可以使用 Video Stitcher API 建立片尾。

在 Ad Manager 中建立單張海報

如要在 Ad Manager 帳戶中建立預設聯播網插入畫面，請按照「建立插入畫面填補內容空白」一節的步驟操作，然後跳至「建立即時設定」一節。

使用 Video Stitcher API 建立標題

如要使用 Video Stitcher API 建立標題，請使用 projects.locations.slates.create 方法。

使用任何要求資料之前，請先替換以下項目：

• PROJECT_NUMBER：您的 Google Cloud 專案編號；位於 身分與存取權管理設定頁面上的「專案編號」欄位
• LOCATION：建立板書的位置；請使用支援的地區之一
  顯示地區
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• SLATE_ID：板條例定義的 ID。這個 ID 只能包含小寫英文字母、數字和連字號。第一個字元必須是英文字母，最後一個字元必須是英文字母或數字，整個 ID 的長度上限為 63 個字元。
• SLATE_URL：MP4 影片的公開 URI，其中至少包含一個音訊軌 (範例影片)
• NETWORK_CODE：Ad Manager 聯播網的數字 ID，可在發布商帳戶的「全域設定」中找到

如要傳送要求，請展開以下其中一個選項：

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

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"

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

$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：您的 Google Cloud 專案編號；位於「IAM 設定」頁面的「專案編號」欄位
• LOCATION：資料的位置；請使用其中一個支援的地區
  顯示地區
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• OPERATION_ID：作業的 ID

如要傳送要求，請展開以下其中一個選項：

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

$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：您的 Google Cloud 專案編號；位於 身分與存取權管理設定頁面上的「專案編號」欄位
• LOCATION：建立即時設定的位置；請使用其中一個支援的區域
  顯示地區
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• LIVE_CONFIG_ID：即時設定的使用者定義 ID。這個 ID 只能包含小寫英文字母、數字和連字號。第一個字元必須是英文字母，最後一個字元必須是英文字母或數字，整個 ID 的長度上限為 63 個字元。
• SOURCE_LIVESTREAM_URI：直播影片資訊清單的來源網址。這個值必須可供 Video Stitcher API 存取。網址必須可供所有人存取，或在 CDN 啟用網址簽署功能時，已向 Video Stitcher API 提供已註冊的 CDN 金鑰。如果您使用 Live Stream API 建立測試直播，則這是 Cloud Storage 值區中 main.m3u8 或 main.mpd 檔案的 URI。
• AD_TAG_URI

  從廣告伺服器擷取的廣告中繼資料網址；如果是 Ad Manager 整合，這必須是有效的 Ad Manager 直播影片廣告代碼。如要取得有效的廣告代碼，請按照「產生影片和音訊廣告代碼」一文的步驟操作，並進行以下修改：
  • 如要啟用即時流量，請啟用即時流量。
  • 在「Player SDK type」中，選取「Google IMA SDK」。
  • 將參數 ad_rule=0 新增至代碼 (例如，將 &ad_rule=0 新增至結尾)。
• SLATE_ID：在沒有拼接廣告的情況下，要使用的廣告板 ID
• NETWORK_CODE：Ad Manager 聯播網的數字 ID，可在發布商帳戶的 全域設定中找到。
• AD_TRACKING：串流的廣告追蹤行為。如要整合 IMA SDK，請使用 CLIENT。如要進行伺服器端廣告追蹤，請使用 SERVER。您也可以稍後針對個別工作階段覆寫這個值。

如要傳送要求，請展開以下其中一個選項：

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

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"

@'
{
  "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

$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
}

Video Stitcher API 會非同步註冊 Ad Manager 帳戶的設定。這可能需要幾分鐘的時間。

這個指令會建立長時間執行作業 (LRO)，您可以查詢該作業來追蹤進度。詳情請參閱「檢查結果」。

取得設定

如要取得設定，請使用 projects.locations.liveConfigs.get 方法。

使用任何要求資料之前，請先替換以下項目：

• PROJECT_NUMBER：您的 Google Cloud 專案編號；位於 身分與存取權管理設定頁面上的「專案編號」欄位
• LOCATION：即時設定的位置；請使用支援的區域之一
  顯示地區
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• LIVE_CONFIG_ID：即時設定的使用者定義 ID

如要傳送要求，請展開以下其中一個選項：

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"

$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。您會在後續步驟中將這些值傳送至互動式媒體廣告 (IMA) SDK。