Thumbnails

Tài nguyên thumbnail xác định nhiều kích thước hình thu nhỏ được liên kết với một tài nguyên. Xin lưu ý những đặc điểm sau đây của hình thu nhỏ:

• Thuộc tính snippet.thumbnails của tài nguyên là một đối tượng xác định hình thu nhỏ có sẵn cho tài nguyên đó.
• Tài nguyên thumbnail chứa một loạt đối tượng. Tên của mỗi đối tượng (default, medium, high, v.v.) đề cập đến kích thước hình thu nhỏ.
• Các loại tài nguyên khác nhau có thể hỗ trợ nhiều kích thước hình thu nhỏ.
• Các loại tài nguyên khác nhau có thể xác định các kích thước khác nhau cho hình thu nhỏ có cùng tên. Ví dụ: hình thu nhỏ default cho tài nguyên video thường có kích thước 120px x 90px, còn hình thu nhỏ default cho tài nguyên channel thường có kích thước 88px x 88px.
• Các tài nguyên cùng loại vẫn có thể có kích thước hình thu nhỏ khác nhau đối với một số hình ảnh, tuỳ thuộc vào độ phân giải của hình ảnh hoặc nội dung gốc được tải lên YouTube. Ví dụ: video HD có thể hỗ trợ hình thu nhỏ có độ phân giải cao hơn so với video không phải HD.
• Mỗi đối tượng chứa thông tin về kích thước hình thu nhỏ đều có một thuộc tính width và một thuộc tính height. Tuy nhiên, các thuộc tính chiều rộng và chiều cao có thể không được trả về cho hình ảnh đó.
• Nếu hình thu nhỏ được tải lên không có kích thước theo yêu cầu, thì hình ảnh đó sẽ được đổi kích thước cho phù hợp mà không thay đổi tỷ lệ khung hình. Hình ảnh không bị cắt nhưng có thể có các thanh màu đen để đảm bảo kích thước chính xác.

Phương thức

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

set

Tải một hình thu nhỏ tuỳ chỉnh cho video lên YouTube và đặt hình thu nhỏ đó cho một video.

Cách trình bày tài nguyên

Cấu trúc JSON sau đây cho thấy định dạng của tài nguyên thumbnails:

{
  "default": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  },
  "medium": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  },
  "high": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  },
  "standard": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  },
  "maxres": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  }
}

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: