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,作为广告请求的一部分,用于确定 Ad Manager 可以针对相应的视频投放哪些广告。此值可以是数字或字母数字。

status

enum (VideoContentStatus)

内容的状态。如果省略此项,则使用默认值。

title

string

必需。内容的标题。

updateTime

string (Timestamp format)

必需。内容的上次修改时间。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

publishTime

string (Timestamp format)

内容的发布时间。如果将视频纳入指定开始时间和结束时间的广告规则中,则该字段为必填字段。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

duration

string (Duration format)

内容的时长。支持的持续时间可精确到毫秒。

该时长以秒为单位,最多包含九个小数位,以“s”结尾。示例:"3.5s"

cuePoints[]

string (Duration format)

标识广告插入点。广告插入点是用时间表示的视频中可以插入广告的位置。广告插入点支持精确到毫秒级。如果视频包含中贴片广告插播时间点,则此字段为必填字段。

该时长以秒为单位,最多包含九个小数位,以“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 收到针对标记为“已删除”的内容的广告请求,则自家广告、定位到广告资源单元或其他定位条件的广告仍可针对这些内容进行投放。要屏蔽广告,请将状态设置为“已屏蔽”。

元数据

内容的自定义元数据。

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 集。“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 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"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 文件的链接。

视频格式

视频内容可采用的格式编码。

枚举
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 中)。