Method: networks.assets.adBreaks.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
API برای فهرست کردن Ad Break ها در جریان مستقیم.
درخواست HTTP
GET https://admanagervideo.googleapis.com/v1/{parent=networks/*/assets/*}/adBreaks
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string اختیاری. این فیلد LiveStreamEvent را مشخص می کند که این وقفه تبلیغاتی باید با استفاده از کلید دارایی پخش جریانی زنده به آن مرتبط شود. باید فرمت "networks/{network_code}/assets/{asset_code}" را داشته باشد. |
پارامترهای پرس و جو
| پارامترها |
|---|
customParent | string اختیاری. این فیلد LiveStreamEvent را مشخص می‌کند که این وقفه تبلیغاتی باید با استفاده از کلید دارایی سفارشی مرتبط شود. باید فرمت "networks/{network_code}/customAssets/{asset_code}" را داشته باشد. |
content | string اختیاری. این یک راه جایگزین برای شناسایی LiveStreamEvent است، اگر با محتوایی در GAM مرتبط باشد. باید فرمت "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" را داشته باشد. |
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 مراجعه کنید.
،
API برای فهرست کردن Ad Break ها در جریان مستقیم.
درخواست HTTP
GET https://admanagervideo.googleapis.com/v1/{parent=networks/*/assets/*}/adBreaks
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string اختیاری. این فیلد LiveStreamEvent را مشخص می کند که این وقفه تبلیغاتی باید با استفاده از کلید دارایی پخش جریانی زنده به آن مرتبط شود. باید فرمت "networks/{network_code}/assets/{asset_code}" را داشته باشد. |
پارامترهای پرس و جو
| پارامترها |
|---|
customParent | string اختیاری. این فیلد LiveStreamEvent را مشخص می‌کند که این وقفه تبلیغاتی باید با استفاده از کلید دارایی سفارشی مرتبط شود. باید فرمت "networks/{network_code}/customAssets/{asset_code}" را داشته باشد. |
content | string اختیاری. این یک راه جایگزین برای شناسایی LiveStreamEvent است، اگر با محتوایی در GAM مرتبط باشد. باید فرمت "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" را داشته باشد. |
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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-21 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-21 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis API allows you to retrieve a list of Ad Breaks associated with a live stream event using the \u003ccode\u003eadBreaks.list\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eYou can identify the LiveStreamEvent using either the live stream asset key (\u003ccode\u003eparent\u003c/code\u003e), custom asset key (\u003ccode\u003ecustomParent\u003c/code\u003e), or content association within GAM (\u003ccode\u003econtent\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a paginated list of Ad Breaks, with control over the page size and retrieval of subsequent pages using page tokens.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required using OAuth scopes, specifically \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.assets.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/{parent=networks/*/assets/*}/adBreaks`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path 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\n### Query parameters\n\n| Parameters ||\n|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\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| `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| `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)."]]
