Thumbnails

thumbnail 资源用于标识与资源相关联的不同缩略图大小。请注意缩略图的以下特征：

  • 资源的 snippet.thumbnails 属性是一个对象，用于标识该资源可用的缩略图。
  • thumbnail 资源包含一系列对象。每个对象的名称（default、medium、high 等）均引用缩略图图片的大小。
  • 不同类型的资源可能支持不同的缩略图大小。
  • 不同类型的资源可以为同名的缩略图定义不同的尺寸。例如，video 资源的 default 缩略图通常为 120 x 90 像素，而 channel 资源的 default 缩略图通常为 88 x 88 像素。
  • 同一类型的资源对于某些图片，可能仍然具有不同的缩略图大小，具体取决于原始图片或上传到 YouTube 的内容的分辨率。例如，与非高清视频相比，高清视频可能支持的缩略图分辨率更高。
  • 每个包含缩略图大小相关信息的对象都有一个 width 属性和 height 属性。但是，系统可能不会返回该图片的宽度和高度属性。
  • 如果上传的缩略图不符合要求的尺寸，系统会调整其大小以匹配正确的尺寸，而不改变其宽高比。图片未剪裁，但可能包含黑条以确保大小正确。

方法

对于 thumbnails 资源，该 API 支持以下方法：

设置
将自定义视频缩略图上传到 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
图片的高度。