Thumbnails

thumbnail 資源會識別與資源相關聯的不同縮圖大小。請注意縮圖的下列特性：

• 資源的 snippet.thumbnails 屬性是物件，可識別該資源可用的縮圖。
• thumbnail 資源包含一系列物件。每個物件的名稱 (default、medium、high 等) 是指縮圖大小。
• 不同類型的資源可能支援不同大小的縮圖。
• 不同類型的資源可能會為同名縮圖定義不同大小。舉例來說，default video 資源的縮圖通常為 120 x 90 像素，default channel 資源的縮圖通常為 88 x 88 像素。
• 視上傳至 YouTube 的原始圖片或內容解析度而定，相同類型的資源仍可能出現不同大小的縮圖。舉例來說，HD 影片支援的縮圖解析度可能比非 HD 影片更高。
• 每個包含縮圖大小資訊的物件都有 width 屬性和 height 屬性。不過，系統可能不會傳回該圖片的寬度和高度屬性。
• 如果上傳的縮圖不符合規定尺寸，系統會調整圖片大小，使其符合正確尺寸，但不會變更顯示比例。圖片不會經過裁剪，但可能包含黑邊，以確保大小正確。

方法

這個 API 支援 thumbnails 資源的下列方法：

設定

將自訂影片縮圖上傳至 YouTube，並設為影片縮圖。

資源表示法

下列 JSON 結構顯示 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
  }
}

屬性

下表定義這個資源中顯示的屬性：