thumbnail
资源用于标识与资源关联的不同缩略图大小。请注意缩略图的以下特征:
- 资源的
snippet.thumbnails
属性是一个对象,用于标识可用于该资源的缩略图。 thumbnail
资源包含一系列对象。每个对象(default
、medium
、high
等)的名称指的是缩略图大小。- 不同类型的资源可能支持不同的缩略图尺寸。
- 不同类型的资源可能会为同名缩略图定义不同的尺寸。例如,
video
资源的default
缩略图通常为 120 x 90 像素,channel
资源的default
缩略图通常为 88 x 88 像素。 - 对于同类型资源,某些图片可能还有不同的缩略图大小,具体取决于原始图片或上传到 YouTube 的内容的分辨率。例如,与非高清视频相比,高清视频支持的缩略图分辨率可能更高。
- 每个包含缩略图大小信息的对象都具有
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 px,高度为 90 px。频道的默认缩略图宽度为 88px,高度为 88px。 |
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 图片的高度。 |