- 資源:VideoContent
- VideoContentStatus
- 中繼資料
- GracenoteMetadata
- VideoContentSyndicationInfo
- SyndicatedVideoContentNames
- DynamicAdInsertionInfo
- VideoIngestUrlInfo
- VideoFormat
- VideoPreconditioned
- ClosedCaptionUrlInfo
- ClosedCaptionFormat
- 方法
資源:VideoContent
內容的中繼資料,
JSON 表示法 |
---|
{ "name": string, "status": enum ( |
欄位 | |
---|---|
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 可根據相應影片放送哪些廣告。這個值可以是數字或英數字元。 |
status |
內容狀態。如未加入此屬性,系統會啟用預設值。 |
title |
必要欄位。內容的標題。 |
updateTime |
必要欄位。上次修改內容的時間。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
publishTime |
內容的發布時間。如果影片設計為在廣告規則中加入指定開始和結束時間,則這個欄位為必填欄位。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
duration |
內容的時間長度。時間長度可以降至毫秒層級。 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
cuePoints[] |
用於識別提示點。提示點是可在影片中插入廣告的時間點。提示點支援的單位為毫秒。如果影片含有片中廣告,則為必填欄位。 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
thumbnailUrl |
內容的縮圖網址。 |
metadata |
指出內容的自訂中繼資料。 |
gracenoteMetadata |
內容的 Gracenote 相關中繼資料。 |
syndicationMetadata |
內容聯合發布相關中繼資料。 |
dynamicAdInsertionMetadata |
內容的動態廣告插播相關中繼資料。 |
VideoContentStatus
用來針對內容放送或不要放送指定廣告的狀態選項。
列舉 | |
---|---|
ACTIVE |
系統會放送指定內容廣告。 |
BLOCKED |
如果狀態為「已封鎖」,系統就不會放送任何廣告。 |
DELETED |
內容會在 Ad Manager 中封存。如果 Ad Manager 收到對標示為 DELETED 內容的廣告請求,內部廣告、指定廣告空間單元或其他指定條件的廣告仍可繼續放送。如要封鎖廣告,請將狀態設為「已封鎖」。 |
中繼資料
內容的自訂中繼資料,
JSON 表示法 |
---|
{ "keyValues": { string: value, ... } } |
欄位 | |
---|---|
keyValues |
將內容的自訂中繼資料識別為鍵/值組合。只接受字串或字串清單的值。 |
GracenoteMetadata
內容的 Gracenote 中繼資料。
JSON 表示法 |
---|
{ "gracenoteId": string, "gracenoteSeriesId": string } |
欄位 | |
---|---|
gracenoteId |
必要欄位。指的是內容的 Gracenote ID。必須使用下列其中一個有效前置字元:1.「EP」- 第 2 輪系列的第 1 集。MV- 電影 3.SP- 體育賽事 |
gracenoteSeriesId |
選用設定。這個欄位是指 Gracenote 系列 ID。開頭須為「SH」。 |
VideoContentSyndicationInfo
用於指定標準內容和聯合發布內容間關係的中繼資料。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 syndication 。VideoContentSyndiationMetadata 只能包含下列其中一項。syndication 只能是下列其中一項: |
|
canonicalVideoContent |
標準內容的名稱。格式須為「networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}」且不屬於包含這個欄位的內容聯播網。 |
syndicatedVideoContentNames |
發布聯合發布內容 |
SyndicatedVideoContentNames
所有聯合發布內容的名稱清單。
JSON 表示法 |
---|
{ "syndicatedVideoContent": [ string ] } |
欄位 | |
---|---|
syndicatedVideoContent[] |
聯合發布內容名稱的重複欄位。格式須為「networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}」且不屬於包含這個欄位的內容聯播網。 |
DynamicAdInsertionInfo
動態廣告插播相關資訊。
JSON 表示法 |
---|
{ "videoIngestUrlInfo": { object ( |
欄位 | |
---|---|
videoIngestUrlInfo |
用於設定條件及產生播放清單的主要 m3u8 檔案連結。 |
mediaUpdateTime |
videoIngestUrlInfo 中參照的影片檔案上次修改的時間。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
closedCaptionUrlInfo[] |
隱藏式輔助字幕/字幕檔案的網址。 |
fwCaid |
FreeWheel 自訂資產 ID,用於指定廣告目標。 |
VideoIngestUrlInfo
中繼資料,指定用於設定條件及產生播放清單的 m3u8 檔案連結。
JSON 表示法 |
---|
{ "videoFormat": enum ( |
欄位 | |
---|---|
videoFormat |
影片的格式, |
videoPreconditioned |
指出內容是否已針對片中廣告設有條件,也就是說,您的區隔已在廣告時段分割。 |
url |
m3u8 檔案連結。 |
VideoFormat
影片內容適用的編碼格式。
列舉 | |
---|---|
VIDEO_FORMAT_UNSPECIFIED |
未指定影片格式。 |
HLS |
application/x-mpegURL |
DASH |
application/dash+xml |
VideoPreconditioned
影片內容的條件狀態。
列舉 | |
---|---|
NO |
尚未設定條件。 |
YES |
影片已經過條件變更/剪輯。 |
ClosedCaptionUrlInfo
一個隱藏式輔助字幕檔案的中繼資料。
JSON 表示法 |
---|
{
"languageCode": string,
"closedCaptionFormat": enum ( |
欄位 | |
---|---|
languageCode |
代表隱藏式輔助字幕檔案所用語言的 IETF BCP-47 語言代碼。 |
closedCaptionFormat |
隱藏式輔助字幕檔案的格式。 |
url |
隱藏式輔助字幕檔案的網址。 |
ClosedCaptionFormat
隱藏式輔助字幕檔案可能採用的格式。
列舉 | |
---|---|
CLOSED_CAPTION_FORMAT_UNSPECIFIED |
未指定隱藏式輔助字幕格式。 |
TTML |
application/ttaf+xml |
WEB_VTT |
text/vtt |
方法 |
|
---|---|
|
這個 API 可建立新內容或更新中繼資料 (如果 Ad Manager 中已有內容)。 |