Thumbnails

Zasób thumbnail określa różne rozmiary obrazów miniatury powiązanych z zasobem. Pamiętaj o tych cechach miniatur:

  • Właściwość snippet.thumbnails zasobu to obiekt, który identyfikuje miniatury dostępne dla tego zasobu.
  • Zasób thumbnail zawiera serię obiektów. Nazwa każdego obiektu (default, medium, high itd.) odnosi się do rozmiaru miniatury.
  • Różne typy zasobów mogą obsługiwać różne rozmiary obrazów miniatury.
  • Różne typy zasobów mogą definiować różne rozmiary obrazów miniatury o tej samej nazwie. Na przykład miniatura default zasobu video ma zwykle wymiary 120 x 90 pikseli, a miniatura default zasobu channel ma zwykle wymiary 88 x 88 pikseli.
  • Zasoby tego samego typu mogą nadal mieć różne rozmiary obrazów miniaturowych 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 o wyższej rozdzielczości niż filmy w jakości innej niż HD.
  • Każdy obiekt zawierający informacje o rozmiarze miniatury ma właściwości width i height. W przypadku tego obrazu właściwości szerokości i wysokości mogą jednak nie zostać zwrócone.
  • Jeśli przesłana miniatura nie ma wymaganych wymiarów, jej rozmiar zostanie zmieniony na prawidłowy bez zmiany współczynnika proporcji. Obraz nie jest przycięty, ale może zawierać czarne paski, aby miał odpowiedni rozmiar.

Metody

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

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

Prezentacja zasobów

Poniższa struktura JSON przedstawia 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 zawiera definicje właściwości, które pojawiają się w tym zasobie:

Właściwości
default object
Domyślna miniatura. Domyślna miniatura filmu lub zasobu, który odnosi się do filmu, np. elementu playlisty lub wyniku wyszukiwania, ma szerokość 120 pikseli i wysokość 90 pikseli. 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 w wyższej rozdzielczości. W przypadku filmu (lub zasobu, który odwołuje się do filmu) ten obraz ma szerokość 320 pikseli i wysokość 180 pikseli. W przypadku kanału obraz ten ma szerokość 240 pikseli i wysokość 240 pikseli.
medium.url string
Adres URL obrazu.
medium.width unsigned integer
Szerokość obrazu.
medium.height unsigned integer
Wysokość obrazu.
high object
Wersja miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odwołuje się do filmu) obraz ma szerokość 480 pikseli i wysokość 360 pikseli. W przypadku kanału obraz ten ma szerokość i wysokość 800 pikseli.
high.url string
Adres URL obrazu.
high.width unsigned integer
Szerokość obrazu.
high.height unsigned integer
Wysokość obrazu.
standard object
Wersja miniatury o jeszcze wyższej rozdzielczości niż obraz o rozdzielczości high. Jest ona dostępna w przypadku niektórych filmów i innych zasobów, które się do nich odnoszą, np. elementów playlisty czy wyników wyszukiwania. Ten obraz ma szerokość 640 pikseli i wysokość 480 pikseli.
standard.url string
Adres URL obrazu.
standard.width unsigned integer
Szerokość obrazu.
standard.height unsigned integer
Wysokość obrazu.
maxres object
Najwyższa rozdzielczość miniatury. Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów i innych zasobów, które odwołują się do filmów, takich jak elementy playlisty czy wyniki wyszukiwania. Ten obraz ma szerokość 1280 pikseli i wysokość 720 pikseli.
maxres.url string
Adres URL obrazu.
maxres.width unsigned integer
Szerokość obrazu.
maxres.height unsigned integer
Wysokość obrazu.