Thumbnails

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

• 資源的 snippet.thumbnails 屬性是一個物件，用於識別該資源可用的縮圖圖片。
• thumbnail 資源包含一系列物件。每個物件的名稱 (default、medium、high 等) 都是指縮圖大小。
• 不同類型的資源可能支援不同的縮圖大小。
• 不同類型的資源可能會為名稱相同的縮圖定義不同的大小。舉例來說，video 資源的 default 縮圖圖片通常為 120 x 90 像素，channel 資源的 default 縮圖圖片則通常為 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
  }
}

屬性

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