Thumbnails

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

属性

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