Method: networks.assets.adBreaks.list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
GET https://admanagervideo.googleapis.com/v1/{parent=networks/*/assets/*}/adBreaks
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 |
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。
|
pageToken |
string
(選用步驟) 屬於接收自前一個 adBreaks.list 呼叫的網頁權杖。提供此項目即可擷取後續網頁。 進行分頁時，提供至 adBreaks.list 的所有其他參數須與提供網頁權杖的呼叫相符。
|
回應主體
如果成功，回應主體會包含 ListAdBreaksResponse 的執行例項。
授權範圍
需要下列其中一種 OAuth 範圍：
https://www.googleapis.com/auth/contentingestion
https://www.googleapis.com/auth/video-ads
詳情請參閱 OAuth 2.0 總覽。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 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)."]]
