Ta strona została przetłumaczona przez Cloud Translation API.

Thumbnails

Zasób thumbnail określa różne rozmiary obrazów miniatur powiązane z zasobem. Pamiętaj o następujących cechach miniatur:

Właściwość snippet.thumbnails zasobu to obiekt, który określa miniatury dostępnych dla tego zasobu miniatur.
Zasób thumbnail zawiera serię obiektów. Nazwa każdego obiektu (default, medium, high itd.) odnosi się do rozmiaru obrazu miniatury.
Różne rodzaje zasobów mogą obsługiwać różne rozmiary obrazów miniatur.
Różne typy zasobów mogą definiować różne rozmiary miniatur obrazów o tej samej nazwie. Na przykład miniatura zasobu default w przypadku zasobu video ma zwykle 120 x 90 pikseli, a miniatura default zasobu channel ma zwykle 88 x 88 pikseli.
Zasoby tego samego typu mogą mieć różne rozmiary miniatur w przypadku niektórych obrazów w zależności od rozdzielczości oryginalnego obrazu lub treści przesłanych do YouTube. Na przykład film HD może obsługiwać miniatury w wyższej rozdzielczości niż filmy w innych formatach.
Każdy obiekt zawierający informacje o rozmiarze obrazu miniatury ma właściwość width i height. W przypadku tego obrazu mogą jednak nie być zwracane właściwości szerokości i wysokości.
Jeśli przesłany obraz miniatury nie spełnia wymaganych wymiarów, rozmiar obrazu jest zmieniany w taki sposób, by pasował do właściwego rozmiaru, bez zmiany proporcji. Obraz nie jest przycięty, ale może zawierać czarne paski zapewniające prawidłowy rozmiar.

Metody

Interfejs API obsługuje te metody zasobów thumbnails:

ustaw: Przesyła niestandardową miniaturę do YouTube i ustawia ją dla filmu.

Reprezentacja zasobu

Poniższa struktura JSON pokazuje format zasobu 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
  }
}

Właściwości

Poniższa tabela przedstawia właściwości, które pojawiają się w tym zasobie:

Właściwości
`default`	`object` Domyślny obraz miniatury. Domyślna miniatura filmu lub zasobu nawiązującego do filmu, np. elementu playlisty czy wyniku wyszukiwania – ma 120 pikseli szerokości i 90 pikseli wysokości. Domyślna miniatura kanału ma 88 pikseli szerokości i 88 pikseli wysokości.
`default.url`	`string` Adres URL obrazu.
`default.width`	`unsigned integer` Szerokość obrazu.
`default.height`	`unsigned integer` Wysokość obrazu.
`medium`	`object` Wersja miniatury obrazu w wyższej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) obraz ten ma 320 pikseli szerokości i 180 pikseli wysokości. W przypadku kanału obraz ma 240 pikseli szerokości i 240 pikseli wysokości.
`medium.url`	`string` Adres URL obrazu.
`medium.width`	`unsigned integer` Szerokość obrazu.
`medium.height`	`unsigned integer` Wysokość obrazu.
`high`	`object` Wersja obrazu miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) obraz ten ma 480 pikseli szerokości i 360 pikseli wysokości. W przypadku kanału obraz ma 800 pikseli szerokości i 800 pikseli wysokości.
`high.url`	`string` Adres URL obrazu.
`high.width`	`unsigned integer` Szerokość obrazu.
`high.height`	`unsigned integer` Wysokość obrazu.
`standard`	`object` Obraz miniatury ma jeszcze wyższą rozdzielczość niż obraz w rozdzielczości `high`. Ten obraz jest dostępny w przypadku niektórych filmów i innych zasobów odnoszących się do filmów, takich jak elementy playlist czy wyniki wyszukiwania. Ten obraz ma 640 pikseli szerokości i 480 pikseli wysokości.
`standard.url`	`string` Adres URL obrazu.
`standard.width`	`unsigned integer` Szerokość obrazu.
`standard.height`	`unsigned integer` Wysokość obrazu.
`maxres`	`object` Wersja miniatury obrazu w najwyższej rozdzielczości. Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów i innych zasobów dotyczących filmów, takich jak elementy playlist czy wyniki wyszukiwania. Ten obraz ma 1280 pikseli szerokości i 720 pikseli wysokości.
`maxres.url`	`string` Adres URL obrazu.
`maxres.width`	`unsigned integer` Szerokość obrazu.
`maxres.height`	`unsigned integer` Wysokość obrazu.