- 资源:VideoContent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- VideoContentStatus
- 元数据
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- GracenoteMetadata
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- VideoContentSyndicationInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- SyndicatedVideoContentNames
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- DynamicAdInsertionInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- VideoIngestUrlInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- VideoFormat
- VideoPreconditioned
- ClosedCaptionUrlInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 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,作为广告请求的一部分,用于确定 Ad Manager 可以针对相应的视频投放哪些广告。此值可以是数字或字母数字。 |
status |
内容的状态。如果省略此项,则使用默认值。 |
title |
必需。内容的标题。 |
updateTime |
必需。内容的上次修改时间。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: |
publishTime |
内容的发布时间。如果将视频纳入指定开始时间和结束时间的广告规则中,则该字段为必填字段。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: |
duration |
内容的时长。支持的持续时间可精确到毫秒。 该时长以秒为单位,最多包含九个小数位,以“ |
cuePoints[] |
标识广告插入点。广告插入点是用时间表示的视频中可以插入广告的位置。广告插入点支持精确到毫秒级。如果视频包含中贴片广告插播时间点,则此字段为必填字段。 该时长以秒为单位,最多包含九个小数位,以“ |
thumbnailUrl |
内容的缩略图网址。 |
metadata |
标识内容的自定义元数据。 |
gracenoteMetadata |
内容与 Gracenote 相关的元数据。 |
syndicationMetadata |
内容的联合发布相关元数据。 |
dynamicAdInsertionMetadata |
内容中与动态广告插播相关的元数据。 |
VideoContentStatus
用于是否投放针对某内容的定位广告的状态选项。
枚举 | |
---|---|
ACTIVE |
将投放按内容定位的广告。 |
BLOCKED |
如果状态为“已阻止”,系统将不会针对此内容投放任何广告。 |
DELETED |
这些内容会在 Ad Manager 中归档。如果 Ad Manager 收到针对标记为“已删除”的内容的广告请求,则自家广告、定位到广告资源单元或其他定位条件的广告仍可针对这些内容进行投放。要屏蔽广告,请将状态设置为“已屏蔽”。 |
元数据
内容的自定义元数据。
JSON 表示法 |
---|
{ "keyValues": { string: value, ... } } |
字段 | |
---|---|
keyValues |
将内容的自定义元数据标识为键值对。值仅接受字符串或字符串列表。 |
GracenoteMetadata
内容的 Gracenote 元数据。
JSON 表示法 |
---|
{ "gracenoteId": string, "gracenoteSeriesId": string } |
字段 | |
---|---|
gracenoteId |
必需。指内容的 Gracenote ID。必须包含以下有效前缀之一:1.“EP”- 电视剧第 2 集。“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 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: |
closedCaptionUrlInfo[] |
字幕/翻译字幕文件的网址。 |
fwCaid |
用于广告定位的 FreeWheel 自定义素材资源 ID。 |
VideoIngestUrlInfo
元数据,用于指定用于调节和生成播放列表的 m3u8 文件的链接。
JSON 表示法 |
---|
{ "videoFormat": enum ( |
字段 | |
---|---|
videoFormat |
视频的格式。 |
videoPreconditioned |
用于指明内容是否已针对中贴片广告进行了调节,也就是说,在广告插播时间点,您的片段已经被拆分了。 |
url |
指向 m3u8 文件的链接。 |
视频格式
视频内容可采用的格式编码。
枚举 | |
---|---|
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 中)。 |