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
  }
}

属性

下表定义了此资源中显示的属性：