LiveCuepoints: insert

Phương thức này không được dùng nữa và được thay thế bằng phương thức liveBroadcasts.cuepoint.

Chèn điểm dừng vào chương trình phát sóng trực tiếp. Hiện tại, những yêu cầu liên quan đến phương thức này phải được sự cho phép của tài khoản liên kết với tài khoản Chủ sở hữu nội dung trên YouTube.

Yêu cầu

Yêu cầu HTTP

POST https://www.googleapis.com/youtube/partner/v1/liveCuepoints

Ủy quyền

Yêu cầu này yêu cầu uỷ quyền có ít nhất một trong các phạm vi sau (đọc thêm về xác thực và cấp phép).

Phạm vi
https://www.googleapis.com/auth/youtubepartner

Các tham số

Bảng sau trình bày các tham số mà truy vấn này hỗ trợ. Tất cả thông số được liệt kê đều là thông số truy vấn.

Các tham số
Các thông số bắt buộc
channelId string
Thông số channelId xác định kênh sở hữu nội dung phát mà bạn đang chèn điểm dừng.
onBehalfOfContentOwner string
Thông số onBehalfOfContentOwner xác định chủ sở hữu nội dung mà người dùng đang đại diện cho họ.

Nội dung yêu cầu

Cung cấp tài nguyên liveCuepoint trong nội dung yêu cầu. Đối với tài nguyên đó:

  • Bạn phải chỉ định một giá trị cho các thuộc tính này:

    • broadcastId
    • settings.cueType

  • Bạn có thể đặt giá trị cho các thuộc tính sau:

    • settings.offsetTimeMs
    • settings.walltime
    • settings.durationSecs

Phản hồi

Nếu thành công, phương thức này sẽ trả về một tài nguyên liveCuepoint trong nội dung phản hồi.

Lỗi

Bảng sau đây xác định các thông báo lỗi mà API có thể trả về khi một lệnh gọi đến phương thức này. Vui lòng xem tài liệu về thông báo lỗi để biết thêm thông tin chi tiết.

Loại lỗi Thông tin chi tiết về lỗi Mô tả
invalidValue (400) conflictingTimeFields Bạn chỉ có thể chỉ định một trong offsetTimeMswalltime.