thumbnail
資源可識別與資源相關聯的不同縮圖圖片大小。請注意縮圖的下列特性:
- 資源的
snippet.thumbnails
屬性是一個物件,可識別該資源可用的縮圖。 thumbnail
資源包含一系列物件。每個物件 (default
、medium
、high
等) 的名稱都代表縮圖圖片大小。- 不同的資源可能支援不同的縮圖圖片大小。
- 不同的資源可以為名稱相同的縮圖圖片定義不同的大小。舉例來說,
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 圖片的高度。 |