REST Resource: networks.customAssets.adBreaks

Tài nguyên: AdBreak

Siêu dữ liệu điểm chèn quảng cáo dùng để quyết định quảng cáo cho một điểm chèn quảng cáo trong sự kiện video trực tiếp.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "createTime": string,
  "expectedDuration": string,
  "customParams": string,
  "scte35CueOut": string,
  "podTemplateName": string,
  "breakState": enum (BreakState),
  "expectedStartTime": string,
  "expireDuration": string,
  "breakSequence": string,
  "breakParams": {
    object (BreakParams)
  },
  "matchParams": {
    object (MatchParams)
  },
  "servedBreak": {
    object (ServedBreak)
  }
}
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 "networks//assets//adBreaks/".

network_code là mã mạng trong Google Ad Manager mà nội dung này thuộc về.

asset_key là khoá của Sự kiện phát trực tiếp trong Google Ad Manager mà Khoảng thời gian quảng cáo được tạo.

adBreakId là khoá của Điểm chèn quảng cáo. CHỈ CÓ ĐẦU RA.
createTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian tạo Điểm chèn quảng cáo.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
expectedDuration

string (Duration format)

Bắt buộc. Thời lượng nghỉ dự kiến.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
customParams
(deprecated)

string

Không bắt buộc. Cặp khoá-giá trị cần được đưa vào 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" Không dùng nữa: Vui lòng đặt cust_params trong breakParams.ad_tag_params bằng cách sử dụng khoá "cust_params".
scte35CueOut

string

Không bắt buộc. Dữ liệu được mã hoá Base 64 từ điểm cue out scte35. Có thể bao gồm lệnh splice_insert() hoặc time_signal(). Ví dụ: – với time_signal(): "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==" – với splice_insert(): "/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo="
podTemplateName
(deprecated)

string

Không bắt buộc. Tên mẫu nhóm Google Ad Manager. Không dùng nữa: Vui lòng đặt cust_params trong breakParams.ad_tag_params bằng cách sử dụng khoá "ptpln".
breakState

enum (BreakState)

Chỉ có đầu ra. Trạng thái hiện tại của Điểm chèn quảng cáo.
expectedStartTime

string (Timestamp format)

Không bắt buộc. Thời gian bắt đầu dự kiến của Điểm chèn quảng cáo.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
expireDuration

string (Duration format)

Không bắt buộc. Hết hạn điểm chèn quảng cáo tại expectedStartTime + expireDuration. Nếu bạn không đặt expectedStartTime, Điểm chèn quảng cáo sẽ hết hạn sau expireDuration kể từ khi bắt đầu đưa ra quyết định. Mặc định: 30 phút Tối thiểu: 5 phút Tối đa: 6 giờ

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
breakSequence

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng trình tự quảng cáo trong video của Điểm chèn quảng cáo. Nhiều điểm chèn quảng cáo có thể có cùng breakSequence nếu được chỉ định rõ ràng thông qua breakParams.ad_tag_params bằng khoá mridx. Điều này giúp liên kết hiệu quả 2 điểm chèn quảng cáo trên GAM.
breakParams

object (BreakParams)

Không bắt buộc. Các tham số của điểm chèn quảng cáo sẽ được đưa vào yêu cầu quảng cáo cho điểm chèn này.
matchParams

object (MatchParams)

Không bắt buộc. Được dùng cho DAI kết hợp để xác định cách một Điểm chèn quảng cáo được tạo thông qua API khớp với một điểm chèn quảng cáo trong tệp kê khai. Khi phát hiện thấy một điểm chèn mới, một hàm so khớp sẽ chạy trên tất cả các điểm chèn quảng cáo của một sự kiện có breakState là SCHEDULED hoặc DECISIONED để kiểm tra xem tất cả các thông số đã đặt trong matchParams của một Điểm chèn quảng cáo có khớp với điểm chèn được phát hiện hay không. Trường hợp trùng khớp xảy ra nếu một trong các điều kiện sau được đáp ứng: 1. Điểm chèn quảng cáo có trường matchParams và tất cả các thông số được đặt trong trường này đều khớp với điểm chèn mới. 2. Điểm chèn quảng cáo là DECISIONED và không có trường matchParams.

Để ngăn hành vi "khớp tất cả" xảy ra do nhầm lẫn (sẽ xảy ra với matchParams trống nhưng vẫn xuất hiện), matchParams không được trống nếu được đặt. Nếu trường này xuất hiện trong một yêu cầu, bạn phải đặt ít nhất một trong các trường riêng của trường này.

Các điểm chèn quảng cáo được kiểm tra theo thứ tự sau: 1. có matchParams, được sắp xếp theo expectedStartTime tăng dần, createTime tăng dần, trong đó các điểm chèn quảng cáo không có expectedStartTime được ưu tiên khi sắp xếp 2. không có matchParams, được sắp xếp theo expectedStartTime tăng dần, createTime tăng dần, trong đó các điểm chèn quảng cáo không có expectedStartTime được ưu tiên khi sắp xếp

Nếu tất cả EABN đang chờ xử lý không khớp, DAI sẽ quay lại hành vi quyết định JIT bằng cách sử dụng chỉ mục quảng cáo trong video giữa giờ tiếp theo có sẵn
servedBreak

object (ServedBreak)

Chỉ có đầu ra. Thông tin này phản ánh thông tin thực tế của điểm chèn quảng cáo được phân phát. Chỉ đặt cho các điểm chèn quảng cáo có COMPLETE breakState.

Phương thức

create

 API để tạo Điểm chèn quảng cáo trong luồng phát trực tiếp.

list

 API để liệt kê các điểm chèn quảng cáo trong luồng phát trực tiếp.