Thumbnails

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

  • リソースの snippet.thumbnails プロパティは、そのリソースに使用可能なサムネイル画像を識別するオブジェクトです。
  • thumbnail リソースには一連のオブジェクトが含まれています。各オブジェクトの名前(defaultmediumhigh など)はサムネイル画像のサイズを表します。
  • さまざまな種類のリソースで、さまざまなサイズのサムネイル画像をサポートできます。
  • さまざまな種類のリソースで、同じ名前のサムネイル画像に対してさまざまなサイズを定義できます。たとえば default サムネイル画像(video リソース)は通常 120 x 90 ピクセルで、default サムネイル画像(channel リソース)は通常 88 x 88 ピクセルです。
  • 同じ種類のリソースで、元の画像や YouTube にアップロードされたコンテンツの解像度によって、特定の画像に対してさまざまなサイズのサムネイル画像を指定できます。たとえば HD 動画は、HD 以外の動画よりも高解像度のサムネイルをサポートできます。
  • サムネイル画像のサイズについての情報が含まれている各オブジェクトは、width プロパティと height プロパティを持ちます。ただし 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
  }
}

プロパティ

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

プロパティ
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
画像の高さ。