Thumbnails

Tài nguyên thumbnail xác định kích thước hình thu nhỏ khác nhau liên kết với một tài nguyên. Xin lưu ý các đặc điểm sau 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 các hình thu nhỏ hiện có cho tài nguyên đó.
  • Tài nguyên thumbnail chứa một loạt đối tượng. Tên của từng đố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 ảnh 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 và hình thu nhỏ default cho tài nguyên channel thường là 88px x 88px.
  • Các tài nguyên thuộc cùng loại có thể vẫn có các kích thước hình thu nhỏ khác nhau cho một số hình ảnh nhất định tùy thuộc vào độ phân giải của hình ảnh gốc hoặc nội dung đượ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ỏ 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ỏ đã tải lên không khớp với kích thước bắt buộc, hình ảnh sẽ được đổi kích thước cho phù hợp với kích thước chính xác mà không thay đổi tỷ lệ khung hình. Hình ảnh không bị cắt nhưng có thể bao gồm các thanh màu đen để kích thước chính xác.

Phương pháp

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

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

Biểu diễn 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:

Thuộc tính
default object
Hình thu nhỏ mặc định. Hình thu nhỏ mặc định của video hoặc tài nguyên đề cập đến một video (chẳng hạn như một mục trong danh sách phát hoặc kết quả tìm kiếm) có chiều rộng là 120px và chiều cao là 90px. Hình thu nhỏ mặc định của một kênh có chiều rộng 88px và chiều cao 88px.
default.url string
URL của hình ảnh.
default.width unsigned integer
Chiều rộng của hình ảnh.
default.height unsigned integer
Chiều cao của hình ảnh.
medium object
Phiên bản hình thu nhỏ có độ phân giải cao hơn. Đối với video (hoặc tài nguyên đề cập đến video), hình ảnh này có chiều rộng 320px và chiều cao 180px. Đối với một kênh, hình ảnh này rộng 240px và cao 240px.
medium.url string
URL của hình ảnh.
medium.width unsigned integer
Chiều rộng của hình ảnh.
medium.height unsigned integer
Chiều cao của hình ảnh.
high object
Phiên bản hình thu nhỏ có độ phân giải cao. Đối với video (hoặc tài nguyên đề cập đến video), hình ảnh này có chiều rộng 480px và chiều cao 360px. Đối với một kênh, hình ảnh này có chiều rộng 800px và chiều cao 800px.
high.url string
URL của hình ảnh.
high.width unsigned integer
Chiều rộng của hình ảnh.
high.height unsigned integer
Chiều cao của hình ảnh.
standard object
Phiên bản hình thu nhỏ thậm chí còn cao hơn phiên bản hình ảnh có độ phân giải high. Hình ảnh này có sẵn cho một số video và các tài nguyên khác đề cập đến video, chẳng hạn như các mục trong danh sách phát hoặc kết quả tìm kiếm. Hình ảnh này rộng 640 px và cao 480 px.
standard.url string
URL của hình ảnh.
standard.width unsigned integer
Chiều rộng của hình ảnh.
standard.height unsigned integer
Chiều cao của hình ảnh.
maxres object
Phiên bản hình thu nhỏ có độ phân giải cao nhất. Kích thước hình ảnh này có sẵn cho một số video và các tài nguyên khác đề cập đến video, như các mục trong danh sách phát hoặc kết quả tìm kiếm. Hình ảnh này có chiều rộng 1280px và chiều cao 720px.
maxres.url string
URL của hình ảnh.
maxres.width unsigned integer
Chiều rộng của hình ảnh.
maxres.height unsigned integer
Chiều cao của hình ảnh.