Method: networks.sources.content.adBreaks.list
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
API để liệt kê các điểm chèn quảng cáo trong luồng phát trực tiếp.
Yêu cầu HTTP
GET https://admanagervideo.googleapis.com/v1/{content=networks/*/sources/*/content/*}/adBreaks
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Thông số |
content |
string
Không bắt buộc. Đây là một cách khác để xác định LiveStreamEvent, nếu sự kiện đó được liên kết với một nội dung trong GAM. Đường dẫn này phải có định dạng "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}"
|
Tham số truy vấn
| Thông số |
parent |
string
Không bắt buộc. Trường này xác định LiveStreamEvent mà điểm chèn quảng cáo này sẽ được liên kết bằng khoá tài sản của luồng phát trực tiếp. Mã này phải có định dạng "networks/{network_code}/assets/{asset_code}"
|
customParent |
string
Không bắt buộc. Trường này xác định LiveStreamEvent mà điểm chèn quảng cáo này sẽ được liên kết bằng khoá nội dung tuỳ chỉnh. Mã này phải có định dạng "networks/{network_code}/customAssets/{asset_code}"
|
pageSize |
integer
Không bắt buộc. Số lượng điểm chèn quảng cáo tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định, hệ thống sẽ trả về tối đa 10 điểm chèn quảng cáo. Giá trị tối đa là 100; các giá trị lớn hơn 100 sẽ được chuyển đổi thành 100.
|
pageToken |
string
Không bắt buộc. Mã thông báo trang nhận được từ một lệnh gọi adBreaks.list trước đó. Cung cấp thông tin này để truy xuất trang tiếp theo. Khi phân trang, tất cả các tham số khác được cung cấp cho adBreaks.list phải khớp với lệnh gọi đã cung cấp mã thông báo trang.
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của ListAdBreaksResponse.
Phạm vi cấp phép
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/contentingestion
https://www.googleapis.com/auth/video-ads
Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-21 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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)."]]
