Method: networks.sources.content.adBreaks.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
API להצגת רשימה של הפסקות לפרסום בשידור חי.
בקשת HTTP
GET https://admanagervideo.googleapis.com/v1/{content=networks/*/sources/*/content/*}/adBreaks
כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים |
content |
string
אופציונלי. זו דרך חלופית לזיהוי של LiveStreamEvent, אם הוא משויך לפריט תוכן ב-GAM. הפורמט שלו חייב להיות "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}"
|
פרמטרים של שאילתה
| פרמטרים |
parent |
string
אופציונלי. בשדה הזה מציינים את האירוע של השידור החי שאליו צריך לשייך את הפסקת הפרסום הזו, באמצעות מפתח הנכס של השידור החי. הפורמט שלו צריך להיות networks/{network_code}/assets/{asset_code}
|
customParent |
string
אופציונלי. בשדה הזה מציינים את האירוע LiveStreamEvent שאליו צריך לשייך את הפסקת הפרסום הזו באמצעות מפתח הנכס המותאם אישית. הפורמט שלו חייב להיות "networks/{network_code}/customAssets/{asset_code}"
|
pageSize |
integer
אופציונלי. המספר המקסימלי של הפסקות הפרסום שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים, יוחזרו עד 10 הפסקות לפרסומות. הערך המקסימלי הוא 100. ערכים מעל 100 יוגבלו ל-100.
|
pageToken |
string
אופציונלי. טוקן דף שהתקבל מקריאה קודמת של adBreaks.list. צריך להזין את האסימון כדי לאחזר את הדף הבא. כשמבצעים חלוקה לעמודים, כל הפרמטרים האחרים שסופקו ל-adBreaks.list חייבים להיות זהים לקריאה שסיפקה את אסימון הדף.
|
גוף הבקשה
גוף הבקשה צריך להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של ListAdBreaksResponse.
היקפי הרשאות
נדרש אחד מהיקפי ההרשאות הבאים של 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 allows you to retrieve a list of ad breaks associated with a live stream event.\u003c/p\u003e\n"],["\u003cp\u003eAd breaks can be identified by their association with either a content ID within GAM or a live stream asset key.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify optional parameters for filtering and pagination of the results, such as parent, customParent, pageSize, and pageToken.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication is required using OAuth scopes, either \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.sources.content.adBreaks.list\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 list Ad Breaks within the live stream.\n\n### HTTP request\n\n`GET https://admanagervideo.googleapis.com/v1/{content=networks/*/sources/*/content/*}/adBreaks`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `content` | `string` Optional. 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\n### Query parameters\n\n| Parameters ||\n|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Optional. 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| `customParent` | `string` Optional. 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| `pageSize` | `integer` Optional. The maximum number of ad breaks to return. The service may return fewer than this value. If unspecified, at most 10 ad breaks will be returned. The maximum value is 100; values above 100 will be coerced to 100. |\n| `pageToken` | `string` Optional. A page token, received from a previous `adBreaks.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `adBreaks.list` must match the call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [ListAdBreaksResponse](/ad-manager/video/rest/v1/ListAdBreaksResponse).\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)."]]
