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 la risorsa in questione. - Una risorsa
thumbnail
contiene una serie di oggetti. Il nome di ciascun oggetto (default
,medium
,high
e così via) fa riferimento alle dimensioni dell'immagine in miniatura. - I diversi tipi di risorse possono supportare dimensioni delle immagini in miniatura diverse.
- Tipi di risorse diversi possono definire dimensioni diverse per le miniature con lo stesso nome. Ad esempio, l'immagine in miniatura
default
per una risorsavideo
di solito misura 120 x 90 px, mentre l'immagine in miniaturadefault
per una risorsachannel
misura in genere 88 x 88 px. - Risorse dello stesso tipo potrebbero comunque avere dimensioni diverse in miniatura 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 ai video non HD.
- Ogni oggetto che contiene informazioni sulle dimensioni di una miniatura ha una proprietà
width
e una proprietàheight
. Tuttavia, le proprietà di larghezza e altezza potrebbero non essere restituite per l'immagine in questione. - Se un'immagine in miniatura caricata non corrisponde alle dimensioni richieste, l'immagine viene ridimensionata in modo da corrispondere alle dimensioni corrette senza modificarne le proporzioni. L'immagine non viene ritagliata, ma potrebbe includere barre nere per cui le dimensioni sono corrette.
Metodi
L'API supporta i seguenti metodi per le risorse 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à 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, come un elemento della playlist o un risultato di ricerca, è larga 120 px e alta 90 px. La miniatura predefinita di un canale è di 88 px di larghezza e 88 px di altezza. |
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 a risoluzione più alta dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine è larga 320 px e alta 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 è larga 480 px e alta 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 dell'immagine in miniatura a risoluzione ancora più elevata rispetto all'immagine con risoluzione high . Questa immagine è disponibile per alcuni video e altre risorse che fanno riferimento ai video, ad esempio elementi della playlist o risultati di ricerca. Questa immagine è larga 640 px e alta 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 massima risoluzione dell'immagine in miniatura. Queste dimensioni delle immagini sono disponibili per alcuni video e altre risorse che fanno riferimento ai video, ad esempio elementi della 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. |