REST Resource: networks.assets.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 Ad Manage שבו נוצר ההפסקה למודעות. adBreakId הוא המפתח של ההפסקה למודעות. פלט בלבד.
|
expectedDuration |
string (Duration format)
חובה. משך ההפסקה הצפוי. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".
|
customParams |
string
צמדי מפתח/ערך שייכללו בבקשות להצגת מודעות בהפסקה הזו לטירגוט לפי קריטריונים מותאמים אישית ב-Ad Manager. דוגמה: 'key1=value&key2=value2,value22'
|
scte35CueOut |
string
יציאה בקידוד scte35 מסימון scte35 על בסיס נתונים בקידוד 64. יכול לכלול את הפקודה splice_insert() או time_signal() . דוגמאות: – עם time_signal(): “/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==” - עם splice_insert() : '/DAvAAAAAAAA/wFAVIPf+AADVAAAAAA/wFAVIPf+AADVAAAAAA/ /wFAVIPf+AADVAAAAa/PAAGlmbAICAAAAADVAAAAAAAA
|
podTemplateName |
string
שם תבנית Pod של Google Ad Manager.
|
breakState |
enum (BreakState)
המצב הנוכחי של ההפסקה למודעות.
|
BreakState
| טיפוסים בני מנייה (enum) |
BREAK_STATE_UNSPECIFIED |
מצב ההפסקה למודעה לא ידוע. |
BREAK_STATE_DECISIONED |
ההחלטה לגבי ההפסקות למודעות התחילה אבל עדיין לא נמסרה למשתמשים. |
BREAK_STATE_COMPLETE |
ההפסקה למודעות נשלחה למשתמשים. |
שיטות |
|
|
API ליצירת הפסקה למודעה בתוך השידור החי. |
|
|
API לרישום הפסקות למודעות בשידור החי. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-21 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-21 (שעון UTC)."],[[["\u003cp\u003eAdBreak resource stores ad break metadata for live video events, including duration, custom parameters, and SCTE-35 cue-out data.\u003c/p\u003e\n"],["\u003cp\u003eAdBreaks can be created and listed using the provided APIs for live stream management within Google Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eBreakState indicates the current status of an Ad Break, ranging from initial decisioning to complete delivery to users.\u003c/p\u003e\n"],["\u003cp\u003eAd Manager pod template names can be associated with AdBreaks to facilitate ad serving and targeting.\u003c/p\u003e\n"]]],["This document outlines the `AdBreak` resource, used for ad decisioning in live video events. Key details include the `name`, `expectedDuration`, `customParams`, `scte35CueOut`, `podTemplateName`, and `breakState`. `breakState` tracks the ad break's progress, with possible states like \"DECISIONED\" or \"COMPLETE\". Two API methods are provided: `create` to generate new ad breaks, and `list` to view existing ones within a live stream.\n"],null,["# REST Resource: networks.assets.adBreaks\n\n- [Resource: AdBreak](#AdBreak)\n - [JSON representation](#AdBreak.SCHEMA_REPRESENTATION)\n - [BreakState](#AdBreak.BreakState)\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### BreakState\n\nThe state of an Ad Break.\n\n| Enums ||\n|---------------------------|--------------------------------------------------------------|\n| `BREAK_STATE_UNSPECIFIED` | The Ad Break state is unknown. |\n| `BREAK_STATE_DECISIONED` | Ad Break decisioning started but not yet delivered to users. |\n| `BREAK_STATE_COMPLETE` | Ad Break was delivered to users. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------|---------------------------------------------------|\n| ### [create](/ad-manager/video/rest/v1/networks.assets.adBreaks/create) | API to create an Ad Break within the live stream. |\n| ### [list](/ad-manager/video/rest/v1/networks.assets.adBreaks/list) | API to list Ad Breaks within the live stream. |"]]
