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: