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 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 risorsa video di solito misura 120 x 90 px, mentre l'immagine in miniatura default per una risorsa channel 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.