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 のプロパティがその画像に対して返されないことがあります。
• アップロードされたサムネイル画像が必要な寸法に一致しない場合、その画像はアスペクト比を変更することなく、正しいサイズに合わせてサイズ変更されます。画像はトリミングされませんが、サイズが正しくなるように黒いバーが含まれる場合があります。

メソッド

この 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
  },
  "standard": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  },
  "maxres": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  }
}

プロパティ

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