Un risultato di ricerca 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, ad esempio un video, non dispone di dati permanenti.
Metodi
L'API supporta i seguenti metodi di ricerca:
- list
- Restituisce una raccolta di risultati di ricerca che corrispondono ai parametri di ricerca specificati nella richiesta API. Per impostazione predefinita, un set di risultati di ricerca identifica le risorse
video
,channel
eplaylist
corrispondenti, ma puoi anche configurare le query in modo che recuperino 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à che vengono 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 della 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 dettagli di base su un risultato di ricerca, ad esempio il titolo o la descrizione. Ad esempio, se il risultato di ricerca è un video, il titolo corrisponderà al 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 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 Le coppie chiave-valore valide sono:
|
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 include contenuti di trasmissione dal vivo. I valori validi della proprietà sono upcoming , live e none .Per una risorsa video , il valore upcoming indica che il video è una trasmissione in diretta non ancora iniziata, mentre un valore live indica che si tratta di una trasmissione in diretta attiva. Per una risorsa channel , un valore upcoming indica che il canale ha una trasmissione pianificata non ancora iniziata, mentre un valore live indica che il canale ha una trasmissione dal vivo attiva. |