Gli esempi seguenti mostrano come completare diversi tipi di richieste di ricerca nell'API v3.
Video
Questo esempio chiama il metodo search.list per trovare i video in alta definizione (HD) più guardati associati alla query "cane skateboard". La query imposta i parametri order, part, q, type e videoDefinition.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &order=viewCount &q=skateboarding+dog &type=video &videoDefinition=high
Per esempi di codice, consulta la documentazione del metodo search.list.
Playlist
Questo esempio mostra come trovare le playlist corrispondenti al termine di query "GoogleDevelopers". Chiama il metodo search.list e imposta il valore del parametro type su playlist in modo che il set di risultati includa solo le playlist.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=GoogleDevelopers &type=playlist
Canali
Questo esempio mostra come trovare i canali corrispondenti al termine di query "viaggi". Chiama il metodo search.list e imposta il valore del parametro type su channel in modo che il set di risultati includa solo i canali.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=travel &type=channel
Risultati pertinenti a una lingua specifica
Questo esempio chiama il metodo search.list per trovare i risultati di ricerca più pertinenti per una lingua specifica. L'esempio mostra che il termine di query è marine (q=marine) e che la risposta dell'API deve contenere i risultati più pertinenti per la lingua francese (relevanceLanguage=fr).
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=marine &relevanceLanguage=fr
Tieni presente che la richiesta non imposta un valore per il parametro type, il che significa che ogni risultato di ricerca potrebbe fare riferimento a un video, una playlist o un canale.
Video caricati tramite l'app o il sito web dello sviluppatore
Questo esempio mostra come utilizzare il parametro forDeveloper per limitare una ricerca in modo da recuperare solo i video caricati tramite l'applicazione o il sito web dello sviluppatore. Questo parametro può essere utilizzato in combinazione con parametri di ricerca facoltativi, come il parametro q.
Nota:questa query non restituisce risultati in API Explorer perché quest'ultimo non supporta i caricamenti di video. Puoi eseguire questa query per la tua applicazione al di fuori di Explorer API, ma non puoi ottenere risultati per la tua applicazione utilizzando Explorer API.
Ogni video caricato viene taggato automaticamente con il numero del progetto associato all'applicazione dello sviluppatore nella Console API di Google.
Quando una richiesta di ricerca imposta successivamente il parametro forDeveloper su true, il servizio API utilizza le credenziali di autorizzazione della richiesta per identificare lo sviluppatore. Di conseguenza, uno sviluppatore può limitare i risultati ai video caricati tramite la propria app o il proprio sito web, ma non ai video caricati tramite altri siti o app.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true