Thumbnails

thumbnail リソースは、リソースに関連付けられたさまざまなサムネイル画像サイズを識別します。サムネイル画像には次の特性があります。

  • リソースの snippet.thumbnails プロパティは、そのリソースで使用できるサムネイル画像を識別するオブジェクトです。
  • thumbnail リソースには、一連のオブジェクトが含まれます。各オブジェクトの名前（default、medium、high など）は、サムネイル画像のサイズを表します。
  • さまざまな種類のリソースで、さまざまなサイズのサムネイル画像をサポートできます。
  • さまざまな種類のリソースで、同じ名前のサムネイル画像に対してさまざまなサイズを定義できます。たとえば、video リソースの default サムネイル画像は通常 120 x 90 ピクセル、channel リソースの default サムネイル画像は通常 88 x 88 ピクセルです。
  • 同じ種類のリソースで、元の画像や YouTube にアップロードされたコンテンツの解像度によって、特定の画像に対してさまざまなサイズのサムネイル画像を指定できます。たとえば HD 動画は、HD 以外の動画よりも高解像度のサムネイルをサポートできます。
  • サムネイル画像のサイズに関する情報を含む各オブジェクトには、width プロパティと height プロパティがあります。ただし width と height のプロパティがその画像に対して返されないことがあります。
  • アップロードされたサムネイル画像が必要な寸法に一致しない場合、その画像はアスペクト比を変更することなく、正しいサイズに合わせてサイズ変更されます。画像はトリミングされませんが、サイズが正しくなるように黒いバーが含まれる場合があります。

Methods

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

プロパティ

次の表は、このリソースで使用されているプロパティの定義を示したものです。

プロパティ
default object
デフォルトのサムネイル画像。動画（または、再生リストのアイテムや検索結果など、動画を参照するリソース）のデフォルト サムネイルは幅 120px、高さ 90px です。チャンネルのデフォルト サムネイルは幅 88px、高さ 88px です。
default.url string
画像の URL。
default.width unsigned integer
画像の幅。
default.height unsigned integer
画像の高さ。
medium object
高解像度バージョンのサムネイル画像。動画（または動画を参照するリソース）の場合、この画像は幅 320px、高さ 180px です。チャンネルの場合は、幅 240px、高さ 240px です。
medium.url string
画像の URL。
medium.width unsigned integer
画像の幅。
medium.height unsigned integer
画像の高さ。
high object
サムネイル画像の高解像度バージョン。動画（または動画を参照するリソース）の場合、この画像は幅 480px、高さ 360px です。チャンネルの場合、幅 800px、高さ 800px です。
high.url string
画像の URL。
high.width unsigned integer
画像の幅。
high.height unsigned integer
画像の高さ。
standard object
high 解像度の画像よりもさらに高解像度のサムネイル画像。この画像は、一部の動画や、動画を参照するその他のリソース（再生リストのアイテムや検索結果など）で使用できます。この画像は幅 640 ピクセル、高さ 480 ピクセルです。
standard.url string
画像の URL。
standard.width unsigned integer
画像の幅。
standard.height unsigned integer
画像の高さ。
maxres object
最高解像度バージョンのサムネイル画像。この画像サイズは、一部の動画のほか、再生リストのアイテムや検索結果など、動画を参照するその他のリソースで使用できます。この画像は幅 1,280 ピクセル、高さ 720 ピクセルです。
maxres.url string
画像の URL。
maxres.width unsigned integer
画像の幅。
maxres.height unsigned integer
画像の高さ。