REST Resource: videoContent.networks.sources.content

資源:VideoContent

內容的中繼資料,

JSON 表示法
{
  "name": string,
  "status": enum (VideoContentStatus),
  "title": string,
  "updateTime": string,
  "publishTime": string,
  "duration": string,
  "cuePoints": [
    string
  ],
  "thumbnailUrl": string,
  "metadata": {
    object (Metadata)
  },
  "gracenoteMetadata": {
    object (GracenoteMetadata)
  },
  "syndicationMetadata": {
    object (VideoContentSyndicationInfo)
  },
  "dynamicAdInsertionMetadata": {
    object (DynamicAdInsertionInfo)
  }
}
欄位
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 可根據相應影片放送哪些廣告。這個值可以是數字或英數字元。

status

enum (VideoContentStatus)

內容狀態。如未加入此屬性,系統會啟用預設值。

title

string

必要欄位。內容的標題。

updateTime

string (Timestamp format)

必要欄位。上次修改內容的時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

publishTime

string (Timestamp format)

內容的發布時間。如果影片設計為在廣告規則中加入指定開始和結束時間,則這個欄位為必填欄位。

RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

duration

string (Duration format)

內容的時間長度。時間長度可以降至毫秒層級。

持續時間以秒為單位,最多 9 個小數位數,結尾為「s」。範例:"3.5s"

cuePoints[]

string (Duration format)

用於識別提示點。提示點是可在影片中插入廣告的時間點。提示點支援的單位為毫秒。如果影片含有片中廣告,則為必填欄位。

持續時間以秒為單位,最多 9 個小數位數,結尾為「s」。範例:"3.5s"

thumbnailUrl

string

內容的縮圖網址。

metadata

object (Metadata)

指出內容的自訂中繼資料。

gracenoteMetadata

object (GracenoteMetadata)

內容的 Gracenote 相關中繼資料。

syndicationMetadata

object (VideoContentSyndicationInfo)

內容聯合發布相關中繼資料。

dynamicAdInsertionMetadata

object (DynamicAdInsertionInfo)

內容的動態廣告插播相關中繼資料。

VideoContentStatus

用來針對內容放送或不要放送指定廣告的狀態選項。

列舉
ACTIVE 系統會放送指定內容廣告。
BLOCKED 如果狀態為「已封鎖」,系統就不會放送任何廣告。
DELETED 內容會在 Ad Manager 中封存。如果 Ad Manager 收到對標示為 DELETED 內容的廣告請求,內部廣告、指定廣告空間單元或其他指定條件的廣告仍可繼續放送。如要封鎖廣告,請將狀態設為「已封鎖」。

中繼資料

內容的自訂中繼資料,

JSON 表示法
{
  "keyValues": {
    string: value,
    ...
  }
}
欄位
keyValues

map (key: string, value: value (Value format))

將內容的自訂中繼資料識別為鍵/值組合。只接受字串或字串清單的值。

GracenoteMetadata

內容的 Gracenote 中繼資料。

JSON 表示法
{
  "gracenoteId": string,
  "gracenoteSeriesId": string
}
欄位
gracenoteId

string

必要欄位。指的是內容的 Gracenote ID。必須使用下列其中一個有效前置字元:1.「EP」- 第 2 輪系列的第 1 集。MV- 電影 3.SP- 體育賽事

gracenoteSeriesId

string

選用設定。這個欄位是指 Gracenote 系列 ID。開頭須為「SH」。

VideoContentSyndicationInfo

用於指定標準內容和聯合發布內容間關係的中繼資料。

JSON 表示法
{

  // Union field syndication can be only one of the following:
  "canonicalVideoContent": string,
  "syndicatedVideoContentNames": {
    object (SyndicatedVideoContentNames)
  }
  // End of list of possible types for union field syndication.
}
欄位
聯集欄位 syndication。VideoContentSyndiationMetadata 只能包含下列其中一項。syndication 只能是下列其中一項:
canonicalVideoContent

string

標準內容的名稱。格式須為「networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}」且不屬於包含這個欄位的內容聯播網。

syndicatedVideoContentNames

object (SyndicatedVideoContentNames)

發布聯合發布內容

SyndicatedVideoContentNames

所有聯合發布內容的名稱清單。

JSON 表示法
{
  "syndicatedVideoContent": [
    string
  ]
}
欄位
syndicatedVideoContent[]

string

聯合發布內容名稱的重複欄位。格式須為「networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}」且不屬於包含這個欄位的內容聯播網。

DynamicAdInsertionInfo

動態廣告插播相關資訊。

JSON 表示法
{
  "videoIngestUrlInfo": {
    object (VideoIngestUrlInfo)
  },
  "mediaUpdateTime": string,
  "closedCaptionUrlInfo": [
    {
      object (ClosedCaptionUrlInfo)
    }
  ],
  "fwCaid": string
}
欄位
videoIngestUrlInfo

object (VideoIngestUrlInfo)

用於設定條件及產生播放清單的主要 m3u8 檔案連結。

mediaUpdateTime

string (Timestamp format)

videoIngestUrlInfo 中參照的影片檔案上次修改的時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

closedCaptionUrlInfo[]

object (ClosedCaptionUrlInfo)

隱藏式輔助字幕/字幕檔案的網址。

fwCaid

string

FreeWheel 自訂資產 ID,用於指定廣告目標。

VideoIngestUrlInfo

中繼資料,指定用於設定條件及產生播放清單的 m3u8 檔案連結。

JSON 表示法
{
  "videoFormat": enum (VideoFormat),
  "videoPreconditioned": enum (VideoPreconditioned),
  "url": string
}
欄位
videoFormat

enum (VideoFormat)

影片的格式,

videoPreconditioned

enum (VideoPreconditioned)

指出內容是否已針對片中廣告設有條件,也就是說,您的區隔已在廣告時段分割。

url

string

m3u8 檔案連結。

VideoFormat

影片內容適用的編碼格式。

列舉
VIDEO_FORMAT_UNSPECIFIED 未指定影片格式。
HLS application/x-mpegURL
DASH application/dash+xml

VideoPreconditioned

影片內容的條件狀態。

列舉
NO 尚未設定條件。
YES 影片已經過條件變更/剪輯。

ClosedCaptionUrlInfo

一個隱藏式輔助字幕檔案的中繼資料。

JSON 表示法
{
  "languageCode": string,
  "closedCaptionFormat": enum (ClosedCaptionFormat),
  "url": string
}
欄位
languageCode

string

代表隱藏式輔助字幕檔案所用語言的 IETF BCP-47 語言代碼。

closedCaptionFormat

enum (ClosedCaptionFormat)

隱藏式輔助字幕檔案的格式。

url

string

隱藏式輔助字幕檔案的網址。

ClosedCaptionFormat

隱藏式輔助字幕檔案可能採用的格式。

列舉
CLOSED_CAPTION_FORMAT_UNSPECIFIED 未指定隱藏式輔助字幕格式。
TTML application/ttaf+xml
WEB_VTT text/vtt

方法

update

這個 API 可建立新內容或更新中繼資料 (如果 Ad Manager 中已有內容)。