Implementazione: richieste di ricerca

I seguenti esempi mostrano come completare diversi tipi di richieste di ricerca nell'API v3.

Video

In questo esempio viene chiamato il metodo search.list per trovare i video più visualizzati in alta definizione (HD) associati alla query "cane da 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 un esempio dei codici, 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 ricerca "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 determinata lingua. L'esempio mostra che il termine di query è marino (q=marine) e che la risposta dell'API deve contenere 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 la ricerca e recuperare solo i video caricati tramite l'applicazione o il sito web dello sviluppatore. Questo parametro può essere utilizzato in combinazione con i parametri di ricerca facoltativi, ad esempio il parametro q.

Nota:questa query non restituisce risultati in Explorer API perché Explorer API 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 tramite Explorer API.

A ogni video caricato viene aggiunto automaticamente un tag con il numero di progetto associato all'applicazione dello sviluppatore nella console API di Google.

Quando in seguito una richiesta di ricerca imposta il parametro forDeveloper su true, il servizio API utilizza le credenziali di autorizzazione della richiesta per identificare lo sviluppatore. Pertanto, uno sviluppatore può limitare i risultati ai video caricati tramite l'app o il sito web dello sviluppatore, ma non a quelli caricati tramite altre app o altri siti.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=fun
        &forDeveloper=true