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
  }
}

屬性

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

屬性
default object
預設的縮圖圖片。影片的預設縮圖或參照影片的資源 (例如播放清單項目或搜尋結果) 的預設縮圖寬度為 120 像素，高度為 90 像素。頻道的預設縮圖寬度為 88 像素、高度 88 像素。
default.url string
圖片的網址。
default.width unsigned integer
圖片的寬度。
default.height unsigned integer
圖片的高度。
medium object
縮圖的解析度更高。如為影片 (或參照影片的資源)，這張圖片的寬度為 320 像素，高度為 180 像素。頻道的圖片寬度為 240 像素，高度為 240 像素。
medium.url string
圖片的網址。
medium.width unsigned integer
圖片的寬度。
medium.height unsigned integer
圖片的高度。
high object
高解析度縮圖圖片。如為影片 (或參照影片的資源)，這張圖片的寬度為 480 像素，高度為 360 像素。對頻道而言，這張圖片寬度為 800 像素，高度為 800 像素。
high.url string
圖片的網址。
high.width unsigned integer
圖片的寬度。
high.height unsigned integer
圖片的高度。
standard object
比 high 解析度圖片還要更高的縮圖版本。這張圖片適用於某些參照影片的影片和其他資源，例如播放清單項目或搜尋結果。這張圖片寬度為 640 像素，高度為 480 像素。
standard.url string
圖片的網址。
standard.width unsigned integer
圖片的寬度。
standard.height unsigned integer
圖片的高度。
maxres object
縮圖的解析度最高的版本。這個圖片大小適用於某些參照影片的影片和其他資源，例如播放清單項目或搜尋結果。這張圖片的寬度為 1280 像素，高度為 720 像素。
maxres.url string
圖片的網址。
maxres.width unsigned integer
圖片的寬度。
maxres.height unsigned integer
圖片的高度。