Search

Un risultato search contiene informazioni su un video di YouTube, un canale o una playlist che corrispondono ai parametri di ricerca specificati in una richiesta API. Anche se un risultato di ricerca rimanda a una risorsa identificabile in modo univoco, come un video, non dispone di dati persistenti propri.

Metodi

L'API supporta i seguenti metodi di ricerca:

list

Restituisce una raccolta di risultati di ricerca che corrispondono ai parametri di query specificati nella richiesta API. Per impostazione predefinita, un insieme di risultati di ricerca identifica le risorse video, channel e playlist corrispondenti, ma puoi anche configurare le query in modo da recuperare solo un tipo specifico di risorsa. Prova subito.

Rappresentazione delle risorse

La seguente struttura JSON mostra il formato di un risultato di ricerca:

{
  "kind": "youtube#searchResult",
  "etag": etag,
  "id": {
    "kind": string,
    "videoId": string,
    "channelId": string,
    "playlistId": string
  },
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "liveBroadcastContent": string
  }
}

Proprietà

La tabella seguente definisce le proprietà visualizzate in un risultato di ricerca:

Proprietà
kind	string Identifica il tipo di risorsa API. Il valore sarà youtube#searchResult.
etag	etag L'ETag di questa risorsa.
id	object L'oggetto id contiene informazioni che possono essere utilizzate per identificare in modo univoco la risorsa che corrisponde alla richiesta di ricerca.
id.kind	string Il tipo di risorsa API.
id.videoId	string Se il valore della proprietà id.type è youtube#video, questa proprietà sarà presente e il suo valore conterrà l'ID utilizzato da YouTube per identificare in modo univoco un video che corrisponde alla query di ricerca.
id.channelId	string Se il valore della proprietà id.type è youtube#channel, questa proprietà sarà presente e il suo valore conterrà l'ID utilizzato da YouTube per identificare in modo univoco un canale che corrisponde alla query di ricerca.
id.playlistId	string Se il valore della proprietà id.type è youtube#playlist, questa proprietà sarà presente e il suo valore conterrà l'ID utilizzato da YouTube per identificare in modo univoco una playlist che corrisponde alla query di ricerca.
snippet	object L'oggetto snippet contiene i dettagli di base di un risultato di ricerca, come il titolo o la descrizione. Ad esempio, se il risultato di ricerca è un video, il titolo sarà il titolo del video e la descrizione sarà la descrizione del video.
snippet.publishedAt	datetime La data e l'ora di creazione della risorsa identificata dal risultato di ricerca. Il valore è specificato nel formato ISO 8601.
snippet.channelId	string Il valore che YouTube utilizza per identificare in modo univoco il canale che ha pubblicato la risorsa identificata dal risultato di ricerca.
snippet.title	string Il titolo del risultato di ricerca.
snippet.description	string Una descrizione del risultato di ricerca.
snippet.thumbnails	object Una mappa delle miniature associate al risultato di ricerca. Per ogni oggetto nella mappa, la chiave è il nome dell'immagine in miniatura e il valore è un oggetto che contiene altre informazioni sulla miniatura.
snippet.thumbnails.(key)	object I valori chiave validi sono: default: 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. medium: una versione a risoluzione più elevata 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. high: 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. standard: una versione dell'immagine in miniatura con una risoluzione ancora più alta 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. maxres: 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. Nota:le miniature a 1080p+ (fhd, qhd e uhd) non sono supportate per i risultati di ricerca. Per recuperare miniature a risoluzione più elevata, chiama l'endpoint specifico della risorsa (ad esempio videos.list) utilizzando l'ID della risorsa.
snippet.thumbnails.(key).url	string L'URL dell'immagine.
snippet.thumbnails.(key).width	unsigned integer La larghezza dell'immagine.
snippet.thumbnails.(key).height	unsigned integer L'altezza dell'immagine.
snippet.channelTitle	string Il titolo del canale che ha pubblicato la risorsa identificata dal risultato di ricerca.
snippet.liveBroadcastContent	string Un'indicazione che specifica se una risorsa video o channel contiene contenuti di trasmissioni live. I valori validi della proprietà sono upcoming, live e none. Per una risorsa video, un valore di upcoming indica che il video è una trasmissione live che non è ancora iniziata, mentre un valore di live indica che il video è una trasmissione live attiva. Per una risorsa channel, un valore pari a upcoming indica che il canale ha una trasmissione programmata che non è ancora iniziata, mentre un valore pari a live indica che il canale ha una trasmissione live attiva.