這個 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 |
僅供輸出。影片內容的資源名稱。這個欄位的格式為:「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 總覽。