REST Resource: networks.assets.adBreaks
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.
Tài nguyên: AdBreak
Siêu dữ liệu về điểm chèn quảng cáo dùng để quyết định quảng cáo cho điểm chèn quảng cáo trong một sự kiện video trực tiếp.
Biểu diễn dưới dạng JSON |
{
"name": string,
"expectedDuration": string,
"customParams": string,
"scte35CueOut": string,
"podTemplateName": string,
"breakState": enum (BreakState )
} |
Trường |
name |
string
Chỉ có đầu ra. Tên tài nguyên của Điểm chèn quảng cáo. Trường này sẽ có định dạng là "networks//asset//adBreaks/". network_code là mã mạng trong Google Ad Manager có chứa nội dung này. Asset_key là khoá của Sự kiện phát trực tiếp trong Google Ad Manager mà bạn dùng để tạo điểm chèn quảng cáo. adBreakId là khoá của Điểm chèn quảng cáo. CHỈ ĐẦU RA.
|
expectedDuration |
string (Duration format)
Bắt buộc. Thời lượng chèn dự kiến. Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s ". Ví dụ: "3.5s" .
|
customParams |
string
Cặp khoá-giá trị được đưa vào các yêu cầu quảng cáo cho điểm chèn này để nhắm mục tiêu theo tiêu chí tuỳ chỉnh trong Ad Manager. Ví dụ: "key1=value&key2=value2,value22"
|
scte35CueOut |
string
Dữ liệu được mã hoá cơ sở 64 từ điểm bắt đầu scte35. Có thể bao gồm lệnh splice_insert() hoặc time_signal(). Ví dụ: - với time_signal(): “/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAAAA nay/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg ==” - với splice_insert khiếu nại ((): "/DAvAAAAAAAA///wFAVIAAAACPf+/+c2nALv4AUAAAAAAAsz1AAAAAA)
|
podTemplateName |
string
Tên mẫu nhóm Google Ad Manager.
|
breakState |
enum (BreakState )
Trạng thái hiện tại của Điểm chèn quảng cáo.
|
BreakState
Trạng thái của một Điểm chèn quảng cáo.
Enum |
BREAK_STATE_UNSPECIFIED |
Trạng thái Điểm chèn quảng cáo không xác định. |
BREAK_STATE_DECISIONED |
Quá trình quyết định Điểm chèn quảng cáo đã bắt đầu nhưng chưa được phân phối cho người dùng. |
BREAK_STATE_COMPLETE |
Điểm chèn quảng cáo đã được phân phối cho người dùng. |
Phương thức |
|
API để tạo Điểm chèn quảng cáo trong sự kiện phát trực tiếp. |
|
API để liệt kê các Điểm chèn quảng cáo trong sự kiện phát trực tiếp. |
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\u003eAdBreak resource stores ad break metadata for live video events, including duration, custom parameters, and SCTE-35 cue-out data.\u003c/p\u003e\n"],["\u003cp\u003eAdBreaks can be created and listed using the provided APIs for live stream management within Google Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eBreakState indicates the current status of an Ad Break, ranging from initial decisioning to complete delivery to users.\u003c/p\u003e\n"],["\u003cp\u003eAd Manager pod template names can be associated with AdBreaks to facilitate ad serving and targeting.\u003c/p\u003e\n"]]],["This document outlines the `AdBreak` resource, used for ad decisioning in live video events. Key details include the `name`, `expectedDuration`, `customParams`, `scte35CueOut`, `podTemplateName`, and `breakState`. `breakState` tracks the ad break's progress, with possible states like \"DECISIONED\" or \"COMPLETE\". Two API methods are provided: `create` to generate new ad breaks, and `list` to view existing ones within a live stream.\n"],null,["# REST Resource: networks.assets.adBreaks\n\n- [Resource: AdBreak](#AdBreak)\n - [JSON representation](#AdBreak.SCHEMA_REPRESENTATION)\n - [BreakState](#AdBreak.BreakState)\n- [Methods](#METHODS_SUMMARY)\n\nResource: AdBreak\n-----------------\n\nAd break metadata used to decision ads for an ad break in a live video event.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"expectedDuration\": string, \"customParams\": string, \"scte35CueOut\": string, \"podTemplateName\": string, \"breakState\": enum (/ad-manager/video/rest/v1/networks.assets.adBreaks#AdBreak.BreakState) } ``` |\n\n| Fields ||\n|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The resource name of the Ad Break. This field will have the format of \"networks//assets//adBreaks/\". network_code is the network code in Google Ad Manager to which this content belongs. asset_key is the key of the Live Stream Event in Google Ad Manage under which the Ad Break was created. adBreakId is the key of the Ad Break. OUTPUT ONLY. |\n| `expectedDuration` | `string (`[Duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration)` format)` Required. Expected break duration. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n| `customParams` | `string` Key-value pairs to be included on ad requests for this break for custom criteria targeting in Ad Manager. Example: 'key1=value\\&key2=value2,value22' |\n| `scte35CueOut` | `string` Base 64 encoded data from the scte35 cue out. May include splice_insert() or time_signal() command. Examples: - with time_signal(): \"/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==\" - with splice_insert(): \"/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo=\" |\n| `podTemplateName` | `string` Google Ad Manager pod template name. |\n| `breakState` | `enum (`[BreakState](/ad-manager/video/rest/v1/networks.assets.adBreaks#AdBreak.BreakState)`)` The current state of the Ad Break. |\n\n### BreakState\n\nThe state of an Ad Break.\n\n| Enums ||\n|---------------------------|--------------------------------------------------------------|\n| `BREAK_STATE_UNSPECIFIED` | The Ad Break state is unknown. |\n| `BREAK_STATE_DECISIONED` | Ad Break decisioning started but not yet delivered to users. |\n| `BREAK_STATE_COMPLETE` | Ad Break was delivered to users. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------|---------------------------------------------------|\n| ### [create](/ad-manager/video/rest/v1/networks.assets.adBreaks/create) | API to create an Ad Break within the live stream. |\n| ### [list](/ad-manager/video/rest/v1/networks.assets.adBreaks/list) | API to list Ad Breaks within the live stream. |"]]