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

屬性

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

屬性
default object
預設縮圖。影片的預設縮圖 (或參照影片的資源，例如播放清單項目或搜尋結果) 寬度為 120 像素，高度為 90 像素。頻道的預設縮圖寬度和高度皆為 88 像素。
default.url string
圖片的網址。
default.width unsigned integer
圖片寬度。
default.height unsigned integer
圖片的高度。
medium object
縮圖圖片的高解析度版本。如果是影片 (或參照影片的資源)，這張圖片的寬度為 320 像素，高度為 180 像素。如果是頻道，這張圖片的寬度和高度都是 240 像素。
medium.url string
圖片的網址。
medium.width unsigned integer
圖片寬度。
medium.height unsigned integer
圖片的高度。
high object
縮圖圖片的高解析度版本。如果是影片 (或參照影片的資源)，這張圖片的寬度為 480 像素，高度為 360 像素。如果是頻道，這張圖片的寬度和高度都是 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
圖片的高度。