Thumbnails

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 risorsa video in genere sono 120 x 90 px, mentre le dimensioni delle miniature default per una risorsa channel 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.