Thumbnails

Zasób thumbnail określa różne rozmiary obrazów miniatur powiązanych z zasobem. Zwróć uwagę na następujące cechy obrazów miniatur:

  • Właściwość snippet.thumbnails zasobu określa obiekt miniatur, które są dla niego dostępne.
  • Zasób thumbnail zawiera serię obiektów. Nazwa każdego obiektu (default, medium, high itd.) odnosi się do rozmiaru obrazu miniatury.
  • Różne typy zasobów mogą obsługiwać różne rozmiary obrazów miniatur.
  • Różne typy zasobów mogą określać różne rozmiary obrazów miniatur o tej samej nazwie. Na przykład miniatura default zasobu video ma zwykle 120 na 90 pikseli, a miniatura default dla zasobu channel to zwykle 88 na 88 pikseli.
  • Zasoby tego samego typu mogą nadal mieć różne rozmiary miniatur w zależności od rozdzielczości oryginalnego obrazu lub innych treści przesłanych do YouTube. Na przykład film w jakości HD może obsługiwać miniatury w wyższej rozdzielczości niż filmy w innej rozdzielczości.
  • Każdy obiekt zawierający informacje o rozmiarze obrazu miniatury ma właściwość width i height. W przypadku tego obrazu może nie zostać jednak zwrócona wartość szerokości i wysokości.
  • Jeśli przesłany obraz miniatury nie pasuje do wymaganych wymiarów, jego rozmiar jest dopasowywany do odpowiedniego rozmiaru bez zmiany współczynnika proporcji. Obraz nie jest przycięty, ale może zawierać czarne pasy, aby rozmiar był prawidłowy.

Metody

Interfejs API obsługuje następujące metody w przypadku zasobów thumbnails:

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

Reprezentowanie zasobów

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

Usługi

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

Usługi
default object
Domyślny obraz miniatury Domyślna miniatura filmu – lub zasób, który odnosi się do filmu – na przykład element playlisty lub wynik wyszukiwania – to 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
Miniatura w wyższej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu), obraz ma szerokość 320 pikseli i wysokość 180 pikseli. W przypadku kanału obraz 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
Miniatura w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu), obraz ma szerokość 480 i wysokość 360 pikseli. W przypadku kanału obraz ma szerokość 800 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 obrazu miniatury jeszcze wyższa niż w high. Ten obraz jest dostępny w przypadku niektórych filmów i innych zasobów, które odnoszą się do filmów, takich jak elementy playlisty czy wyniki wyszukiwania. Obraz ma szerokość 640 i wysokość 480 pikseli.
standard.url string
Adres URL obrazu.
standard.width unsigned integer
Szerokość obrazu.
standard.height unsigned integer
Wysokość obrazu.
maxres object
Miniatura w najwyższej rozdzielczości. Ten rozmiar jest dostępny w przypadku niektórych filmów i innych zasobów, które odnoszą się do filmów, takich jak elementy playlisty czy wyniki wyszukiwania. 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.