Method: networks.sources.content.adBreaks.list
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
HTTP 请求
GET https://admanagervideo.googleapis.com/v1/{content=networks/*/sources/*/content/*}/adBreaks
网址采用 gRPC 转码语法。
路径参数
参数 |
content |
string
可选。如果 LiveStreamEvent 与 GAM 中的某项内容相关联,则这是识别该 LiveStreamEvent 的另一种方式。其格式必须为“networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}”
|
查询参数
参数 |
parent |
string
可选。此字段使用直播素材资源键来标识相应广告插播时间点应关联到的 LiveStreamEvent。其格式必须为“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 概览。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-21。
[null,null,["最后更新时间 (UTC):2025-08-21。"],[[["\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)."]]