Stiamo aggiornando l'API Data in modo che corrisponda al modo in cui YouTube conteggia le visualizzazioni di Shorts.
Scopri di più
Implementazione: classificazioni
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-11-23 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2024-11-23 UTC."],[[["The YouTube Data API (v3) allows users to rate videos using the `videos.rate` method, with options to `like`, `dislike`, or remove a rating (`none`), requiring OAuth 2.0 authorization."],["You can retrieve the currently authenticated user's rating for specific videos by using the `videos.getRating` method and providing a comma-separated list of video IDs, also requiring OAuth 2.0."],["The API enables the retrieval of a list of videos rated by the current user, either liked or disliked, through the `videos.list` method and its `myRating` parameter, which also requires OAuth 2.0."],["Alternatively, users can retrieve a list of their liked videos by using the `playlistItems.list` method and accessing the `contentDetails.relatedPlaylists.likes` property, which offers an alternative to the `videos.list` method."]]],["The YouTube Data API (v3) facilitates video rating management. Using `videos.rate`, users can set or remove ratings (`like`, `dislike`, `none`) for specific videos via the `id` and `rating` parameters. `videos.getRating` retrieves a user's rating for videos, referencing video IDs. The `videos.list` method, with the `myRating` parameter, fetches videos the user has rated as \"like\", and similar functionality is available via the `playlistItems.list` method. All requests require OAuth 2.0 authorization.\n"]]
