Watermarks

Tài nguyên watermark xác định một hình ảnh sẽ hiển thị trong quá trình phát các video của một kênh cụ thể. Bạn cũng có thể chỉ định kênh đích nơi hình ảnh sẽ liên kết đến cũng như chi tiết về thời gian xác định thời điểm hình mờ xuất hiện trong khi phát video và khoảng thời gian hiển thị hình mờ.

Phương thức

API hỗ trợ các phương thức sau cho tài nguyên watermarks:

tập hợp
Tải hình mờ lên YouTube và đặt hình mờ đó cho một kênh.
huỷ thiết lập
Xoá hình mờ của kênh. Thử ngay.

Trình bày tài nguyên

Cấu trúc JSON dưới đây thể hiện định dạng của tài nguyên watermarks:

{
  "timing": {
    "type": string,
    "offsetMs": unsigned long,
    "durationMs": unsigned long
  },
  "position": {
    "type": string,
    "cornerPosition": string
  },
  "imageUrl": string,
  "imageBytes": bytes,
  "targetChannelId": string
}

Thuộc tính

Bảng sau đây xác định các thuộc tính xuất hiện trong tài nguyên này:

Thuộc tính
timing object
Đối tượng timing đóng gói thông tin về khoảng thời gian hiển thị hình mờ của kênh trong quá trình phát video.
timing.type string
Phương pháp thời gian xác định thời điểm hình mờ xuất hiện trong quá trình phát video. Nếu giá trị là offsetFromStart, thì trường offsetMs sẽ thể hiện phần chênh lệch so với điểm bắt đầu video. Nếu giá trị là offsetFromEnd, thì trường offsetMs sẽ thể hiện phần chênh lệch so với cuối video.
timing.offsetMs unsigned long
Mức chênh lệch thời gian (được chỉ định bằng mili giây) sẽ xác định thời điểm mặt hàng quảng cáo xuất hiện trong các lượt phát video. Giá trị của thuộc tính type xác định liệu độ lệch được đo từ đầu hay cuối video.
timing.durationMs unsigned long
Khoảng thời gian (tính bằng mili giây) mà hình mờ sẽ hiển thị.
position object
Đối tượng position đóng gói thông tin về vị trí không gian trong video mà hình mờ sẽ hiển thị.
position.type string
Cách đặt mặt hàng được quảng bá trong trình phát video.

Các giá trị hợp lệ cho tài sản này là:
  • góc
position.cornerPosition string
Góc của người chơi nơi mặt hàng được quảng bá sẽ xuất hiện. Mục này luôn xuất hiện ở góc trên bên phải trình phát.

Các giá trị hợp lệ cho tài sản này là:
  • topRight
imageUrl string
URL cho hình mờ của kênh. YouTube sẽ tạo URL này và trả về trong phản hồi của API cho yêu cầu watermark.set.
imageBytes bytes
Kích thước của hình mờ, tính bằng byte.
targetChannelId string
Mã nhận dạng kênh YouTube của kênh mà ảnh mờ có liên kết.