Implementazione: classificazioni

Gli esempi riportati di seguito mostrano come utilizzare l'API YouTube Data (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 per 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 di cui viene assegnata la classificazione (o di cui viene rimossa la classificazione).
  • Il parametro rating specifica la classificazione che l'utente che autorizza la richiesta vuole registrare. I valori di parametro validi sono like, dislike e none. I primi due valori impostano una valutazione, mentre il terzo rimuove qualsiasi valutazione esistente per l'utente.

La richiesta di esempio riportata di seguito assegna una valutazione positiva (Mi piace) al video del discorso di apertura della conferenza Google I/O 2014:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?
        id=wtLJPvx7-ys
        &rating=like

Recuperare la valutazione di un video da parte dell'utente corrente

Il metodo videos.getRating consente di recuperare la classificazione di uno o più video da parte dell'utente attualmente autenticato. Nella richiesta, imposta il valore del parametro id su un elenco separato da virgole di ID video di YouTube per le risorse per le quali stai recuperando i dati sulle valutazioni. Tieni presente che questa richiesta deve essere autorizzata utilizzando OAuth 2.0.

La richiesta di esempio riportata di seguito recupera la valutazione dell'utente corrente del video del discorso principale della conferenza Google I/O 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 videos.list del metodo videos.list consente di recuperare un elenco di video valutati dall'utente che ha autorizzato la richiesta dell'API.myRating Il valore del parametro indica se vuoi recuperare i video a cui hai messo Mi piace o Non mi piace.

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 che l'utente ha aggiunto ai preferiti (ma non dei video a cui ha aggiunto Non mi piace) seguendo la procedura per recuperare i video preferiti di un canale. Nel passaggio 1 di questa procedura, anziché recuperare l'ID della playlist dei video preferiti del canale, recupera l'ID della playlist dei video piaciuti del canale. La proprietà contentDetails.relatedPlaylists.likes contiene il valore.

L'API consente quindi di recuperare un elenco di video che l'utente ha messo Mi piace 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.