Implementazione: classificazioni

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 per un video. Questa richiesta deve essere autorizzata tramite OAuth 2.0.

Imposta i due parametri seguenti nella richiesta:

  • Il parametro id specifica l'ID del video di YouTube del video oggetto della valutazione (o della rimozione della relativa classificazione).
  • Il parametro rating specifica la valutazione che l'utente che autorizza la richiesta vuole registrare. I valori validi dei parametri sono like, dislike e none. I primi due valori impostano una valutazione, mentre il terzo rimuove qualsiasi valutazione precedentemente esistente per l'utente.

La richiesta di esempio riportata di seguito dà una valutazione positiva (Mi piace) 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

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

Il metodo videos.getRating ti consente di recuperare la valutazione di uno o più video da parte degli utenti attualmente autenticati. Nella tua richiesta, imposta il valore del parametro id su un elenco separato da virgole di ID video di YouTube relativi alle risorse per cui stai recuperando i dati relativi alle 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 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

Recupera 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 del 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 valutato 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 (ma non quelli non piaciuti) seguendo la procedura per recuperare i video preferiti di un canale. Nel passaggio 1 di questa procedura, invece di recuperare l'ID playlist dei video preferiti del canale, recupera l'ID playlist dei video piaciuti del canale. La proprietà contentDetails.relatedPlaylists.likes contiene il valore.

Pertanto, l'API ti consente di recuperare un elenco di video che sono piaciuti all'utente utilizzando il metodo videos.list o 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.