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)
必要欄位。預期的廣告插播時間長度。 持續時間以秒為單位,最多 9 個小數位數,結尾為「s 」。範例:"3.5s" 。
|
customParams |
string
針對 Ad Manager 中的自訂條件指定,要加入這個廣告插播的廣告請求中的鍵/值組合。例如:「key1=value&key2=value2,value22」
|
scte35CueOut |
string
來自 scte35 提示點的 Base 64 編碼資料。可能包含 splice_insert() 或 time_signal() 指令。範例:- with time_signal(): “/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==” - 搭配 splice_insert():"/DAvAAAAAAAAz=AVAAKAAz1/AUAAKAAz1/AUAAKAAnv4
|
podTemplateName |
string
Google Ad Manager 廣告連播範本名稱。
|
breakState |
enum (BreakState )
廣告插播目前的狀態。
|
方法 |
|
提供相關 API,用於在直播中建立廣告插播時間點。 |
|
提供相關 API,用於列出直播中的廣告插播時間點。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-21 (世界標準時間)。
[null,null,["上次更新時間: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. |"]]