Thumbnails

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

  • 資源的 snippet.thumbnails 屬性是一個物件,可識別該資源可用的縮圖。
  • thumbnail 資源包含一系列物件。每個物件 (defaultmediumhigh 等) 的名稱都代表縮圖圖片大小。
  • 不同的資源可能支援不同的縮圖圖片大小。
  • 不同的資源可以為名稱相同的縮圖圖片定義不同的大小。舉例來說,video 資源的 default 縮圖尺寸通常為 120px x 90px,channel 資源的 default 縮圖圖片通常為 88px x 88px。
  • 視原始圖片或影片上傳至 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
高解析度版本的縮圖。如果是影片 (或影片專用的資源),這張圖片寬度為 320px,高度為 180px。對頻道而言,這張圖片的圖片寬度為 240px,高度為 240px。
medium.url string
圖片網址。
medium.width unsigned integer
圖片的寬度。
medium.height unsigned integer
圖片的高度。
high object
高解析度圖片的縮圖。如果是影片 (或影片專用的資源),這張圖片寬度為 480px,高度為 360px。頻道圖片的寬度為 800 像素,高度為 800 像素。
high.url string
圖片網址。
high.width unsigned integer
圖片的寬度。
high.height unsigned integer
圖片的高度。
standard object
縮圖解析度的解析度比 high 解析度圖片高。這張圖片適用於部分影片和其他參考影片的資源,例如播放清單項目或搜尋結果。這張圖片寬度為 640px,高度為 480px。
standard.url string
圖片網址。
standard.width unsigned integer
圖片的寬度。
standard.height unsigned integer
圖片的高度。
maxres object
縮圖解析度最高的版本。此圖片大小適用於部分影片和其他參考影片的資源,例如播放清單項目或搜尋結果。此圖片的寬度為 1280px,高度為 720px。
maxres.url string
圖片網址。
maxres.width unsigned integer
圖片的寬度。
maxres.height unsigned integer
圖片的高度。