Una risorsa thumbnail
identifica le diverse dimensioni delle miniature 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 miniature disponibili per la 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. - Tipi di risorse diversi possono supportare dimensioni dell'immagine in miniatura diverse.
- Tipi diversi di risorse possono definire dimensioni diverse per le miniature con lo stesso nome. Ad esempio, le dimensioni delle miniature
default
per una risorsavideo
in genere sono 120 x 90 px, mentre le dimensioni delle miniaturedefault
per una risorsachannel
sono in genere 88 x 88 px. - Le risorse dello stesso tipo potrebbero comunque avere dimensioni delle miniature diverse per determinate immagini, a seconda della risoluzione dell'immagine originale o dei contenuti caricati su YouTube. Ad esempio, un video HD potrebbe supportare miniature a risoluzione più elevata rispetto a quelle non in HD.
- Ogni oggetto contenente informazioni su una dimensione dell'immagine in miniatura ha una proprietà
width
e una proprietàheight
. Tuttavia, le proprietà di altezza e larghezza potrebbero non essere restituite. - Se l'immagine in miniatura caricata non corrisponde alle dimensioni richieste, viene ridimensionata per adattarsi alle dimensioni corrette senza modificarne le proporzioni. L'immagine non è ritagliata, ma può includere barre nere per rendere le dimensioni corrette.
Metodi
L'API supporta i seguenti metodi per le risorse di thumbnails
:
- imposta
- Carica una miniatura personalizzata per un video 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à che vengono visualizzate in questa risorsa:
Proprietà | |
---|---|
default |
object L'immagine in miniatura predefinita. La miniatura predefinita di un video, o una risorsa che fa riferimento a un video, ad esempio una playlist o un risultato di ricerca, è larga 120 px e alta 90 px. La miniatura predefinita di 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 dell'immagine in miniatura a risoluzione più elevata. 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 è larga 240 px e alta 240 px. |
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 è larga 800 px e alta 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 a risoluzione ancora più alta dell'immagine in miniatura rispetto a quella con risoluzione high . Questa immagine è disponibile per alcuni video e altre risorse che fanno riferimento ai video, come elementi delle playlist o 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. Le dimensioni di questa immagine sono disponibili per alcuni video e altre risorse che fanno riferimento a video, ad esempio elementi delle playlist o risultati di ricerca. Questa immagine è larga 1280 px e alta 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. |