Implementazione: valutazioni

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 sono like, dislike e none. 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
Nota: puoi anche recuperare un elenco dei video piaciuti dell'utente (ma non i video non piaciuti) seguendo la procedura per recuperare i video preferiti di un canale. Nel primo passaggio della procedura, invece di recuperare l'ID playlist dei tuoi video preferiti, recupera l'ID playlist dei video che ti sono piaciuti. La proprietà 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.