REST Resource: videoAdvertisingOptions

Tài nguyên: VideoAdvertisingOption

Các chế độ cài đặt quảng cáo của một video. Chế độ cài đặt này xác định các loại quảng cáo có thể chạy trong video cũng như thời điểm quảng cáo được phép chạy trong video.

Biểu diễn dưới dạng JSON
{
  "kind": string,
  "adFormats": [
    string
  ],
  "breakPosition": [
    string
  ],
  "adBreaks": [
    {
      object (AdBreak)
    }
  ],
  "autoGeneratedBreaks": boolean,
  "id": string,
  "tpAdServerVideoId": string,
  "tpTargetingUrl": string,
  "tpUrlParameters": string
}
Các trường
kind

string

Loại tài nguyên API. Đối với tài nguyên này, giá trị là youtubePartner#videoAdvertisingOption.

adFormats[]

string

Danh sách các định dạng quảng cáo mà video được phép hiển thị. Lưu ý: kể từ tháng 11 năm 2023, bạn chỉ có thể bật/tắt quảng cáo của bên thứ ba trong cột này. Hãy xem bài viết hỗ trợ để biết thêm thông tin. Các chế độ kiểm soát định dạng quảng cáo sau không còn hoạt động nữa và không nên được đưa vào yêu cầu API: instream_standard, display, preroll, postroll.

breakPosition[]

string

Thời điểm xảy ra điểm chèn quảng cáo trong khi phát video.

adBreaks[]

object (AdBreak)

Danh sách các thời điểm YouTube có thể hiển thị quảng cáo trong luồng trong khi phát video.

autoGeneratedBreaks

boolean

Bật video này để chèn quảng cáo giữa video được tạo tự động.

id

string

Mã nhận dạng mà YouTube sử dụng để xác định riêng video liên quan đến các chế độ cài đặt quảng cáo.

tpAdServerVideoId

string

Giá trị nhận dạng duy nhất video cho máy chủ quảng cáo bên thứ ba.

tpTargetingUrl

string

URL cơ sở cho máy chủ quảng cáo của bên thứ ba mà từ đó YouTube có thể truy xuất quảng cáo trong luồng cho video.

tpUrlParameters

string

Chuỗi thông số cần nối vào cuối yêu cầu tới máy chủ quảng cáo của bên thứ ba.

AdBreak

Tài nguyên adBreak chứa thông tin về thời điểm YouTube có thể hiển thị quảng cáo trong luồng lúc phát video.

Biểu diễn dưới dạng JSON
{
  "position": string,
  "midrollSeconds": integer
}
Các trường
position

string

Thời điểm xảy ra điểm chèn quảng cáo trong khi phát video.

midrollSeconds

integer

Thời gian của điểm chèn quảng cáo được chỉ định là số giây kể từ lúc bắt đầu video.

Phương thức

get

Truy xuất cài đặt quảng cáo cho video được chỉ định.

getEnabledAds

Truy xuất thông tin chi tiết về các loại quảng cáo được cho phép trên video do đối tác hoặc người dùng cụ thể tải lên.

patch

vá các cài đặt quảng cáo cho video được chỉ định.

update

Cập nhật chế độ cài đặt quảng cáo cho video được chỉ định.