Method: videoContent.networks.sources.content.update

這個 API 可建立新內容或更新中繼資料 (如果 Ad Manager 中已有內容)。作業成功時會傳回內容,失敗時會傳回 google.rpc.Code

要求範例如下:

{
   "status": "ACTIVE",
   "title": "Best video ever",
   "updateTime": "2019-01-24T01:30:15.01Z",
   "duration": "230s",
   "cuePoints": ["55.532s", "192s"],
   "publishTime": "2019-01-24T01:30:15.01Z",
   "thumbnailUrl": "http://www.domain.com/tn.jpg",
   "metadata": {
       "keyValues": {
           "category": "sports",
           "tag": ["soccer", "messi"],
       }
   }
}

HTTP 要求

PUT https://admanagervideo.googleapis.com/v1/videoContent/{videoContent.name=networks/*/sources/*/content/*}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
videoContent.name

string

僅供輸出。影片內容的資源名稱。這個欄位的格式為:「networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}」

network_code 是 Google Ad Manager 中屬於這個內容所屬的聯播網代碼。

content_source_id 是 Google Ad Manager 中,這項內容所屬的來源 ID。

cms_content_id 是 Google Ad Manager 中的 CMS 內容 ID,此 ID 是廣告請求的一部分,可指出 Ad Manager 可根據相應影片放送哪些廣告。這個值可以是數字或英數字元。

要求主體

要求主體包含 VideoContent 的例項。

回應主體

如果成功,回應主體會包含 VideoContent 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍:

  • https://www.googleapis.com/auth/contentingestion
  • https://www.googleapis.com/auth/video-ads

詳情請參閱 OAuth 2.0 總覽