Watermarks

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

Phương pháp

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

đặt

Tải hình mờ lên YouTube và đặt hình ảnh đó cho kênh.

chưa đặt

Xoá hình mờ của kênh. Thử ngay.

Biểu diễn tài nguyên

Cấu trúc JSON bên dưới cho thấy đị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ề thời gian phát video khi hình mờ của kênh sẽ hiển thị.
timing.type	string Phương pháp xác định thời gian xác định thời điểm hình ảnh hình mờ xuất hiện trong khi phát video. Nếu giá trị là offsetFromStart, thì trường offsetMs đại diện cho độ lệch từ đầu video. Nếu giá trị là offsetFromEnd, thì trường offsetMs đại diện cho một phần bù trừ từ cuối video.
timing.offsetMs	unsigned long Độ lệch thời gian, chỉ định bằng mili giây, xác định thời điểm mục quảng cáo xuất hiện trong thời gian phát video. Giá trị của thuộc tính type xác định độ lệch này được đo từ đầu hoặc cuối video.
timing.durationMs	unsigned long Thời lượng, tính bằng mili giây, mà hình ảnh 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ẽ xuất hiện.
position.type	string Cách đặt mục quảng cáo trong trình phát video. Giá trị hợp lệ cho thuộc tính 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 của trình phát. Các giá trị hợp lệ cho thuộc tính 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 API cho một 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 có hình ảnh hình mờ liên kết.