Thumbnails

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

  • 资源的 snippet.thumbnails 属性是一个对象，用于标识可用于相应资源的缩略图。
  • thumbnail 资源包含一系列对象。每个对象（default、medium、high 等）的名称都表示缩略图图片大小。
  • 不同类型的资源可能支持不同大小的缩略图。
  • 不同类型的资源可能会为名称相同的缩略图定义不同的大小。例如，video 资源的 default 缩略图通常为 120x90 像素，而 channel 资源的 default 缩略图通常为 88x88 像素。
  • 对于某些图片，即使资源类型相同，缩略图图片尺寸也可能不同，具体取决于原始图片的分辨率或上传到 YouTube 的内容。例如，高清视频可能支持比非高清视频分辨率更高的缩略图。
  • 每个包含缩略图大小信息的对象都具有 width 属性和 height 属性。不过，系统可能不会返回相应图片的宽度和高度属性。
  • 如果上传的缩略图不符合所需的尺寸，系统会调整图片大小以符合正确的尺寸，但不会更改其宽高比。图片未被裁剪，但可能包含黑边，以便尺寸正确。

方法

该 API 支持以下针对 thumbnails 资源的方法：

set
向 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 像素（宽）x 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
图片的高度。