Watermarks

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

Phương thức

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

set
Tải hình ảnh hình mờ lên YouTube và đặt hình mờ cho một kênh.
unset
Xoá hình ảnh hình mờ của một kênh. Thử ngay.

Cách trình bày 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 bao bọc thông tin về thời điểm hình ảnh hình mờ của một kênh sẽ xuất hiện trong quá trình phát video. Bạn phải có đối tượng này khi gọi watermarks.set.
timing.type string
Phương thức tính thời gian xác định thời điểm hình ảnh hình mờ xuất hiện trong quá trình phát video. Bạn phải cung cấp thuộc tính này khi gọi watermarks.set.

Các giá trị hợp lệ là:
  • offsetFromStart: Trường offsetMs biểu thị độ lệch so với điểm bắt đầu của video.
  • offsetFromEnd: Trường offsetMs biểu thị độ lệch so với cuối video.
timing.offsetMs unsigned long
Độ lệch thời gian (tính bằng mili giây) xác định thời điểm mặt hàng được quảng bá xuất hiện trong quá trình phát video. Bạn phải cung cấp thuộc tính này khi gọi watermarks.set. Khi type là offsetFromEnd, offsetMs phải có ít nhất 1000 mili giây.
timing.durationMs unsigned long
Khoảng thời gian (tính bằng mili giây) mà hình ảnh hình mờ sẽ hiển thị. Thuộc tính này là không bắt buộc. Nếu được chỉ định, thời lượng tối thiểu là 1000 mili giây. Khi type là offsetFromEnd, durationMs không được vượt quá offsetMs.
position object
Không dùng nữa: Đối tượng position không còn được dùng nữa và sẽ bị YouTube bỏ qua. Hình mờ luôn xuất hiện ở góc trên cùng bên phải của trình phát video.
imageUrl string
URL của hình ảnh 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 ảnh hình mờ, tính bằng byte.
targetChannelId string
Mã nhận dạng kênh YouTube của kênh mà hình ảnh hình mờ liên kết đến.