REST Resource: networks.sources.content.adBreaks
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
资源:AdBreak
广告插播时间点元数据,用于为直播视频事件中的广告插播时间点决定广告。
JSON 表示法 |
{
"name": string,
"expectedDuration": string,
"customParams": string,
"scte35CueOut": string,
"podTemplateName": string,
"breakState": enum (BreakState )
} |
字段 |
name |
string
仅限输出。广告插播时间点的资源名称。此字段的格式为“networks//assets//adBreaks/”。 network_code 是此内容所属的 Google Ad Manager 中的广告联盟代码。 asset_key 是 Google 广告管理中直播活动的键,它是用来创建广告插播时间点的。 adBreakId 是广告插播时间点的键。仅限输出。
|
expectedDuration |
string (Duration format)
必需。预期的广告插播时长。 该时长以秒为单位,最多包含九个小数位,以“s ”结尾。示例:"3.5s" 。
|
customParams |
string
要在 Ad Manager 中用于自定义条件定位的此插播时间点的广告请求中包含的键值对。示例:'key1=value&key2=value2,value22'
|
scte35CueOut |
string
scte35 cue out 中采用 Base64 编码的数据。可以包含 splice_insert() 或 time_signal() 命令。如果
|
podTemplateName |
string
Google Ad Manager Pod 模板名称。
|
breakState |
enum (BreakState )
广告插播的当前状态。
|
方法 |
|
用于在直播活动中创建广告插播时间点的 API。 |
|
用于列出直播活动中的广告插播时间点的 API。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-21。
[null,null,["最后更新时间 (UTC):2025-08-21。"],[[["\u003cp\u003eAdBreak is metadata used to manage ad breaks within live video events for ad decisioning.\u003c/p\u003e\n"],["\u003cp\u003eIt features attributes like name, expected duration, custom parameters, SCTE-35 cue-out, pod template name, and break state.\u003c/p\u003e\n"],["\u003cp\u003eYou can create and list AdBreaks using the provided API methods.\u003c/p\u003e\n"]]],["Ad Break metadata defines ad decision criteria for live video events. Key information includes the `name` (resource identifier), `expectedDuration` (in seconds), `customParams` (key-value targeting), `scte35CueOut` (Base64 encoded data), `podTemplateName`, and `breakState` (current state). The `create` method allows for creating ad breaks, and `list` allows for viewing them. The Ad break has a defined structure using a JSON representation.\n"],null,["# REST Resource: networks.sources.content.adBreaks\n\n- [Resource: AdBreak](#AdBreak)\n - [JSON representation](#AdBreak.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: AdBreak\n-----------------\n\nAd break metadata used to decision ads for an ad break in a live video event.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"expectedDuration\": string, \"customParams\": string, \"scte35CueOut\": string, \"podTemplateName\": string, \"breakState\": enum (/ad-manager/video/rest/v1/networks.assets.adBreaks#AdBreak.BreakState) } ``` |\n\n| Fields ||\n|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The resource name of the Ad Break. This field will have the format of \"networks//assets//adBreaks/\". network_code is the network code in Google Ad Manager to which this content belongs. asset_key is the key of the Live Stream Event in Google Ad Manage under which the Ad Break was created. adBreakId is the key of the Ad Break. OUTPUT ONLY. |\n| `expectedDuration` | `string (`[Duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration)` format)` Required. Expected break duration. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n| `customParams` | `string` Key-value pairs to be included on ad requests for this break for custom criteria targeting in Ad Manager. Example: 'key1=value\\&key2=value2,value22' |\n| `scte35CueOut` | `string` Base 64 encoded data from the scte35 cue out. May include splice_insert() or time_signal() command. Examples: - with time_signal(): \"/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==\" - with splice_insert(): \"/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo=\" |\n| `podTemplateName` | `string` Google Ad Manager pod template name. |\n| `breakState` | `enum (`[BreakState](/ad-manager/video/rest/v1/networks.assets.adBreaks#AdBreak.BreakState)`)` The current state of the Ad Break. |\n\n| Methods ------- ||\n|----------------------------------------------------------------------------------|---------------------------------------------------|\n| ### [create](/ad-manager/video/rest/v1/networks.sources.content.adBreaks/create) | API to create an Ad Break within the live stream. |\n| ### [list](/ad-manager/video/rest/v1/networks.sources.content.adBreaks/list) | API to list Ad Breaks within the live stream. |"]]