Thumbnails

Una risorsa thumbnail identifica le diverse dimensioni delle immagini in miniatura associate a una risorsa. Tieni presente le seguenti caratteristiche delle immagini in miniatura:

  • La proprietà snippet.thumbnails di una risorsa è un oggetto che identifica le immagini in miniatura disponibili per quella risorsa.
  • Una risorsa thumbnail contiene una serie di oggetti. Il nome di ogni oggetto (default, medium, high e così via) si riferisce alle dimensioni dell'immagine in miniatura.
  • Diversi tipi di risorse possono supportare dimensioni diverse delle immagini in miniatura.
  • Diversi tipi di risorse possono definire dimensioni diverse per le immagini in miniatura con lo stesso nome. Ad esempio, l'immagine in miniatura default per una risorsa video è in genere 120 x 90 px, mentre l'immagine in miniatura default per una risorsa channel è in genere 88 x 88 px.
  • Le risorse dello stesso tipo potrebbero comunque avere dimensioni diverse delle immagini in miniatura per determinate immagini, a seconda della risoluzione dell'immagine o dei contenuti originali caricati su YouTube. Ad esempio, un video HD potrebbe supportare miniature con una risoluzione più elevata rispetto ai video non HD.
  • Ogni oggetto che contiene informazioni sulle dimensioni di un'immagine in miniatura ha una proprietà width e una proprietà height. Tuttavia, le proprietà di larghezza e altezza potrebbero non essere restituite per l'immagine.
  • Se un'immagine in miniatura caricata non corrisponde alle dimensioni richieste, viene ridimensionata in modo da corrispondere alle dimensioni corrette senza modificarne le proporzioni. L'immagine non è ritagliata, ma potrebbe includere barre nere per garantire le dimensioni corrette.

Metodi

L'API supporta i seguenti metodi per le risorse thumbnails:

set
Carica una miniatura personalizzata su YouTube e la imposta per un video.

Rappresentazione delle risorse

La seguente struttura JSON mostra il formato di una risorsa 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
  }
}

Proprietà

La tabella seguente definisce le proprietà visualizzate in questa risorsa:

Proprietà
default object
L'immagine in miniatura predefinita. La miniatura predefinita per un video o una risorsa che fa riferimento a un video, ad esempio un elemento di una playlist o un risultato di ricerca, ha una larghezza di 120 px e un'altezza di 90 px. La miniatura predefinita per un canale è larga 88 px e alta 88 px.
default.url string
L'URL dell'immagine.
default.width unsigned integer
La larghezza dell'immagine.
default.height unsigned integer
L'altezza dell'immagine.
medium object
Una versione ad alta risoluzione dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine ha una larghezza di 320 px e un'altezza di 180 px. Per un canale, questa immagine misura 240 px di larghezza e 240 px di altezza.
medium.url string
L'URL dell'immagine.
medium.width unsigned integer
La larghezza dell'immagine.
medium.height unsigned integer
L'altezza dell'immagine.
high object
Una versione ad alta risoluzione dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine ha una larghezza di 480 px e un'altezza di 360 px. Per un canale, questa immagine ha una larghezza di 800 px e un'altezza di 800 px.
high.url string
L'URL dell'immagine.
high.width unsigned integer
La larghezza dell'immagine.
high.height unsigned integer
L'altezza dell'immagine.
standard object
Una versione dell'immagine in miniatura con una risoluzione ancora più elevata rispetto all'immagine con risoluzione high. Questa immagine è disponibile per alcuni video e altre risorse che fanno riferimento ai video, come gli elementi delle playlist o i risultati di ricerca. Questa immagine ha una larghezza di 640 px e un'altezza di 480 px.
standard.url string
L'URL dell'immagine.
standard.width unsigned integer
La larghezza dell'immagine.
standard.height unsigned integer
L'altezza dell'immagine.
maxres object
La versione con la risoluzione più alta dell'immagine in miniatura. Questa dimensione dell'immagine è disponibile per alcuni video e altre risorse che fanno riferimento ai video, come gli elementi delle playlist o i risultati di ricerca. Questa immagine ha una larghezza di 1280 px e un'altezza di 720 px.
maxres.url string
L'URL dell'immagine.
maxres.width unsigned integer
La larghezza dell'immagine.
maxres.height unsigned integer
L'altezza dell'immagine.