如要為專案啟用 Video Stitcher API，請與客戶經理聯絡，或洽詢業務團隊，進一步瞭解詳情。

本頁面由 Cloud Translation API 翻譯而成。

為直播活動建立設定

如要整合 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，可在發布商帳戶的「全域設定」中找到
重要事項：您必須加入 gamSlate 物件，才能在 Google Ad Manager (GAM) 中使用資訊板。

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

curl (Linux、macOS 或 Cloud Shell)

注意：以下指令假設您已使用使用者帳戶登入 gcloud CLI，方法是執行 gcloud init 或 gcloud auth login，或是使用 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 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中。在終端機中執行下列指令，即可在目前目錄中建立或覆寫此檔案：

@'
{
  "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：您的 Google Cloud 專案編號；位於「IAM 設定」頁面的「專案編號」欄位
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)

注意：下列指令假設您已透過執行 gcloud init 或 gcloud auth login 登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$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
注意：如果您使用 Ad Manager 建立預設聯播網廣告板，請從請求中移除 defaultSlate 欄位，以便使用預設聯播網廣告板。
NETWORK_CODE：Ad Manager 聯播網的數字 ID，可在發布商帳戶的 全域設定中找到。
AD_TRACKING：串流的廣告追蹤行為。如要整合 IMA SDK，請使用 CLIENT。如要進行伺服器端廣告追蹤，請使用 SERVER。您也可以稍後針對個別工作階段覆寫這個值。

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

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中。在終端機中執行下列指令，即可在目前目錄中建立或覆寫此檔案：

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)

將要求主體儲存在名為 request.json 的檔案中。在終端機中執行下列指令，即可在目前目錄中建立或覆寫此檔案：

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

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 (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)

注意：下列指令假設您已透過執行 gcloud init 或 gcloud auth login 登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

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

總覽

準備好讓用戶端應用程式與 Google Ad Manager 搭配運作

為直播活動建立設定 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

建立插入畫面

在 Ad Manager 中建立單張海報

使用 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)

為直播活動建立設定