I seguenti esempi mostrano come utilizzare la YouTube Data API (v3) per eseguire funzioni relative alle classificazioni dei video.
Votazione di un video
Chiama il metodo videos.rate
per inviare la valutazione di un utente su un video. Questa richiesta deve essere autorizzata utilizzando OAuth 2.0.
Imposta i seguenti due parametri nella richiesta:
- Il parametro
id
specifica l'ID del video di YouTube che viene valutato (o la cui valutazione è stata rimossa). - Il parametro
rating
specifica la valutazione che l'utente che autorizza la richiesta vuole registrare. I valori parametro validi sonolike
,dislike
enone
. I primi due valori definiscono una valutazione, mentre il terzo rimuove qualsiasi valutazione che esisteva in precedenza per l'utente.
La seguente richiesta di esempio fornisce una valutazione positiva (simile) al video del discorso di apertura alla conferenza Google I/O del 2014:
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate? id=wtLJPvx7-ys &rating=like
Recuperare la valutazione corrente di un video da parte dell'utente
Il metodo videos.getRating
consente di recuperare la valutazione dell'utente attualmente autenticato per uno o più video. Nella richiesta, imposta il valore del parametro id
su un elenco di ID video di YouTube separati da virgole per le risorse per le quali stai recuperando i dati delle valutazioni. Tieni presente che questa richiesta deve essere autorizzata utilizzando OAuth 2.0.
La richiesta di esempio di seguito recupera la valutazione dell'utente corrente per il video del discorso di apertura alla conferenza Google I/O del 2014. Se hai eseguito l'esempio precedente in Explorer API, la risposta dell'API dovrebbe indicare che la valutazione è like
.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating? id=wtLJPvx7-ys
Recuperare i video valutati dall'utente corrente
Il parametro myRating
del metodo videos.list
consente di recuperare un elenco di video classificati dall'utente che autorizza la richiesta API. Il valore parametro indica se vuoi recuperare i video che ti sono piaciuti o non ti sono piaciuti.
La richiesta di esempio riportata di seguito recupera un elenco di video a cui l'utente corrente ha assegnato una valutazione like
. La richiesta deve essere autorizzata utilizzando OAuth 2.0.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list? part=snippet &myRating=like
contentDetails.relatedPlaylists.likes
contiene il valore.Di conseguenza, l'API ti consente di recuperare un elenco di video che l'utente ha apprezzato utilizzando il metodo
videos.list
o il metodo playlistItems.list
. Poiché in una risorsa video
vengono restituite informazioni diverse rispetto a una risorsa playlistItem
, puoi scegliere il metodo più adatto alle tue esigenze.