Thumbnails

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

  • リソースの snippet.thumbnails プロパティは、そのリソースで利用可能なサムネイル画像を識別するオブジェクトです。
  • thumbnail リソースには、一連のオブジェクトが含まれます。各オブジェクトの名前(defaultmediumhigh など)はサムネイル画像のサイズを表します。
  • さまざまな種類のリソースで、さまざまなサイズのサムネイル画像をサポートできます。
  • さまざまな種類のリソースで、同じ名前のサムネイル画像に対してさまざまなサイズを定義できます。たとえば、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
画像の高さ。