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

プロパティ

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