Method: networks.customAssets.adBreaks.create
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
API ליצירת הפסקת פרסום בשידור חי.
בקשת HTTP
POST https://admanagervideo.googleapis.com/v1/{customParent=networks/*/customAssets/*}/adBreaks
כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים |
customParent |
string
בשדה הזה מציינים את האירוע LiveStreamEvent שאליו צריך לשייך את הפסקת הפרסום הזו באמצעות מפתח הנכס המותאם אישית. הפורמט שלו חייב להיות "networks/{network_code}/customAssets/{asset_code}"
|
פרמטרים של שאילתה
| פרמטרים |
parent |
string
בשדה הזה מציינים את האירוע של השידור החי שאליו צריך לשייך את הפסקת הפרסום הזו, באמצעות מפתח הנכס של השידור החי. הפורמט שלו צריך להיות networks/{network_code}/assets/{asset_code}
|
content |
string
זו דרך חלופית לזיהוי של LiveStreamEvent, אם הוא משויך לפריט תוכן ב-GAM. הפורמט שלו חייב להיות "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}"
|
adBreakId |
string
זהו adBreakId שהמשתמשים יכולים לספק דרך הבקשה.
|
גוף הבקשה
גוף הבקשה מכיל מופע של AdBreak.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של AdBreak.
היקפי הרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/contentingestion
https://www.googleapis.com/auth/video-ads
מידע נוסף זמין במאמר סקירה כללית על OAuth 2.0.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-21 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-21 (שעון UTC)."],[[["\u003cp\u003eThis API creates an Ad Break within a live stream using an HTTP POST request to a specified URL.\u003c/p\u003e\n"],["\u003cp\u003eAd Breaks can be associated with LiveStreamEvents using either a custom asset key (\u003ccode\u003ecustomParent\u003c/code\u003e) or a live stream asset key (\u003ccode\u003eparent\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain an instance of \u003ccode\u003eAdBreak\u003c/code\u003e, and a successful response will return the newly created \u003ccode\u003eAdBreak\u003c/code\u003e instance.\u003c/p\u003e\n"],["\u003cp\u003eThis API requires specific OAuth scopes for authorization, such as \u003ccode\u003ehttps://www.googleapis.com/auth/contentingestion\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/video-ads\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: networks.customAssets.adBreaks.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\nAPI to create an Ad Break within the live stream.\n\n### HTTP request\n\n`POST https://admanagervideo.googleapis.com/v1/{customParent=networks/*/customAssets/*}/adBreaks`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customParent` | `string` This field identifies the LiveStreamEvent that this ad break should be associated to using the custom asset key. It must have the format of \"networks/{network_code}/customAssets/{asset_code}\" |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` This field identifies the LiveStreamEvent that this ad break should be associated to using the live stream asset key. It must have the format of \"networks/{network_code}/assets/{asset_code}\" |\n| `content` | `string` This is an alternative way to identify the LiveStreamEvent, if it's associated with a piece of content within GAM. It must have the format of \"networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}\" |\n| `adBreakId` | `string` This is the adBreakId that users can provide through the request. |\n\n### Request body\n\nThe request body contains an instance of [AdBreak](/ad-manager/video/rest/v1/networks.assets.adBreaks#AdBreak).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [AdBreak](/ad-manager/video/rest/v1/networks.assets.adBreaks#AdBreak).\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/contentingestion`\n- `\n https://www.googleapis.com/auth/video-ads`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
