Questa pagina è stata tradotta dall'API Cloud Translation.

Search

Un risultato search contiene informazioni su un video, un canale o una playlist di YouTube 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 ha dati permanenti propri.

Metodi

L'API supporta i seguenti metodi di ricerca:

list: Restituisce una raccolta di risultati di ricerca corrispondenti 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 corrispondente 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 relativo 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 relativo 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 relativo valore conterrà l'ID utilizzato da YouTube per identificare in modo univoco una playlist corrispondente alla query di ricerca.
`snippet`	`object` L'oggetto `snippet` contiene i dettagli di base di un risultato di ricerca, ad esempio 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 utilizzato da YouTube 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 di immagini in miniatura 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 di un video o di una risorsa che rimanda a un video, ad esempio un elemento di 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. `medium`: una versione dell'immagine in miniatura con una risoluzione più elevata. Per un video (o una risorsa che fa riferimento a un video), l'immagine deve avere una larghezza di 320 pixel e un'altezza di 180 pixel. Per un canale, l'immagine deve avere una larghezza di 240 pixel e un'altezza di 240 pixel. `high`: una versione ad alta risoluzione dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), l'immagine deve avere una larghezza di 480 pixel e un'altezza di 360 pixel. Per un canale, l'immagine deve avere una larghezza di 800 pixel e un'altezza di 800 pixel. `standard`: una versione dell'immagine in miniatura con una risoluzione ancora superiore 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 è larga 640 px e alta 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 è larga 1280 pixel e alta 720 pixel.
`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` Indica se una risorsa `video` o `channel` contiene contenuti di trasmissione in diretta. I valori validi della proprietà sono `upcoming`, `live` e `none`. Per una risorsa `video`, un valore `upcoming` indica che il video è una trasmissione in diretta non ancora iniziata, mentre un valore `live` indica che il video è una trasmissione in diretta attiva. Per una risorsa `channel`, un valore `upcoming` indica che il canale ha una trasmissione programmata che non è ancora iniziata, mentre un valore `live` indica che il canale ha una trasmissione in diretta attiva.