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

属性

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