Thumbnails

Tài nguyên thumbnail xác định nhiều kích thước hình ảnh thu nhỏ liên kết với tài nguyên. Hãy lưu ý các đặ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 các đố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 ảnh thu nhỏ.
  • Mỗi loại tài nguyên có thể hỗ trợ các kích thước hình thu nhỏ riêng.
  • Các loại tài nguyên khác nhau có thể xác định 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 và 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 có thể vẫn 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 gốc hoặc nội dung đã 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 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, 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 phù hợp với kích thước bắt buộc, thì 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ể có các thanh màu đen để kích thước được chính xác.

Phương thức

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

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

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 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 video), chẳng hạn như mục trong danh sách phát hoặc kết quả tìm kiếm, có chiều rộng 120px và chiều cao 90px. Hình thu nhỏ mặc định cho kênh có chiều rộng 88 px và chiều cao 88 px.
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 rộng 320px và cao 180px. Đối với 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 một video), hình ảnh này rộng 480px và cao 360px. Đối với kênh, hình ảnh này rộng 800px và 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ỏ có độ phân giải cao hơn so với hình ảnh có độ phân giải high. Hình ảnh này khả dụng cho một số video và 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 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 áp dụng cho một số video và 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 1280 px và cao 720 px.
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.