為 VOD 工作階段建立設定

如要整合 Ad Manager，您必須為 VOD 工作階段建立廣告代碼。你也需要建立 VOD 設定。Video Stitcher API 會將此設定註冊至 Ad Manager。

在 Ad Manager 中建立廣告代碼

請在 Ad Manager 帳戶中執行下列步驟：

1. 新增廣告單元。
2. 啟用廣告規則。

3. 建立新的廣告規則。在這個步驟中，請前往 Ad Manager 的「指定目標」>「廣告空間」專區。選取上一個步驟中建立的新廣告單元。

4. 請按照「產生影片和音訊廣告代碼」一文的步驟建立有效的廣告代碼，並進行下列修改：

   • 選取「播放器 SDK 類型」時，請選取「Google IMA SDK」。
   • 將參數 ad_rule=1 新增至代碼 (例如，將 &ad_rule=1 新增至結尾)。
   • 將參數 vid_d=vod-asset-duration-in-secs 新增至標記 (例如，將 &vid_d=1800 新增至 30 分鐘 VOD 資產的結尾)。
   • 將參數 output=vast 修改為 output=xml_vmap1。影片多重廣告播放清單 (VMAP) 規格是唯一支援的輸出類型。

建立 VOD 設定

如要建立設定，請使用 projects.locations.vodConfigs.create 方法。如需選用欄位 (例如自訂標頭)，請參閱 VOD 設定參考說明文件。

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

• PROJECT_NUMBER：您的 Google Cloud 專案編號；位於 身分與存取權管理設定頁面上的「專案編號」欄位
• LOCATION：建立 VOD 設定的位置；請使用支援的區域之一
  顯示地區
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• VOD_CONFIG_ID：使用者定義的 VOD 設定 ID。這個 ID 只能包含小寫英文字母、數字和連字號。第一個字元必須是英文字母，最後一個字元必須是英文字母或數字，整個 ID 的長度上限為 63 個字元。
• VOD_URI：要拼接的媒體 URI。這個 URI 必須參照 MPEG-DASH 資訊清單 (MPD) 檔案或 HLS 資訊清單 (M3U8) 檔案。使用您註冊 CDN 金鑰的公開 URI 或未簽署的 URI。
• AD_TAG_URI

  從廣告伺服器擷取的廣告中繼資料網址；如果是 Ad Manager 整合，這個網址必須是有效的 Ad Manager 影片廣告代碼。如要取得有效的廣告代碼，請按照「在 Ad Manager 中建立廣告代碼」一節中的步驟操作。
• NETWORK_CODE：Ad Manager 聯播網的數字 ID，可在發布商帳戶的 通用設定中找到

JSON 要求主體：

{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "networkCode": "NETWORK_CODE"
  }
}

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

cat > request.json << 'EOF'
{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "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/vodConfigs?vodConfigId=VOD_CONFIG_ID"

@'
{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "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/vodConfigs?vodConfigId=VOD_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/vodConfigs/VOD_CONFIG_ID",
    "verb": "create",
    "cancelRequested": false,
    "apiVersion": "v1"
  },
  "done": false
}

這個指令會建立長時間執行作業 (LRO)，您可以查詢該作業來追蹤進度。複製傳回的 OPERATION_ID，這是 name 欄位的最後一部分，可在下一節中使用。

查看結果

使用 projects.locations.operations.get 方法檢查是否已建立 VOD 設定。如果回應中包含 "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/vodConfigs/VOD_CONFIG_ID",
    "verb": "create"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.VodConfig",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID",
    "sourceUri": "VOD_URI",
    "adTagUri": "AD_TAG_URI",
    "gamVodConfig": {
      "networkCode": "NETWORK_CODE"
    },
    "state": "READY"
  }
}

確認狀態已設為 READY。如果沒有，請稍候幾秒鐘，然後再次傳送要求。

如要進一步瞭解 VOD 設定，請參閱「建立及管理 VOD 設定」。