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.
[null,null,["Ultimo aggiornamento 2024-11-23 UTC."],[[["\u003cp\u003eThe YouTube Data API (v3) allows users to rate videos using the \u003ccode\u003evideos.rate\u003c/code\u003e method, with options to \u003ccode\u003elike\u003c/code\u003e, \u003ccode\u003edislike\u003c/code\u003e, or remove a rating (\u003ccode\u003enone\u003c/code\u003e), requiring OAuth 2.0 authorization.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve the currently authenticated user's rating for specific videos by using the \u003ccode\u003evideos.getRating\u003c/code\u003e method and providing a comma-separated list of video IDs, also requiring OAuth 2.0.\u003c/p\u003e\n"],["\u003cp\u003eThe API enables the retrieval of a list of videos rated by the current user, either liked or disliked, through the \u003ccode\u003evideos.list\u003c/code\u003e method and its \u003ccode\u003emyRating\u003c/code\u003e parameter, which also requires OAuth 2.0.\u003c/p\u003e\n"],["\u003cp\u003eAlternatively, users can retrieve a list of their liked videos by using the \u003ccode\u003eplaylistItems.list\u003c/code\u003e method and accessing the \u003ccode\u003econtentDetails.relatedPlaylists.likes\u003c/code\u003e property, which offers an alternative to the \u003ccode\u003evideos.list\u003c/code\u003e method.\u003c/p\u003e\n"]]],["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"],null,["# Implementation: Ratings\n\nThe following examples show how to use the YouTube Data API (v3) to perform functions related to video ratings.\n\nRate a video\n------------\n\nCall the [videos.rate](/youtube/v3/docs/videos/rate) method to submit a user's rating for a video. This request must be authorized using OAuth 2.0.\n\nSet the following two parameters in your request:\n\n\u003cbr /\u003e\n\n- The [id](/youtube/v3/docs/videos/rate#id) parameter specifies the YouTube video ID of the video that is being rated (or having its rating removed).\n- The [rating](/youtube/v3/docs/videos/rate#rating) parameter specifies the rating that the user authorizing the request wishes to record. Valid parameter values are `like`, `dislike`, and `none`. The first two values set a rating, and the third removes any rating that previously existed for the user.\n\n\u003cbr /\u003e\n\nThe sample request below gives a positive (like) rating to the video of the keynote speech at the 2014 Google I/O conference: \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?\n id=wtLJPvx7-ys\n &rating=like\n```\n\nRetrieve the current user's rating of a video\n---------------------------------------------\n\nThe [videos.getRating](/youtube/v3/docs/videos/getRating) method lets you retrieve the currently authenticated user's rating of one or more videos. In your request, set the [id](/youtube/v3/docs/videos/rate#id) parameter's value to a comma-separated list of YouTube video IDs for the resources for which you are retrieving rating data. Note that this request must be authorized using OAuth 2.0.\n\nThe sample request below retrieves the current user's rating of the video of the keynote speech at the 2014 Google I/O conference. (If you executed the previous example in the APIs Explorer, the API response should indicate that the rating is `like`. \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?\nid=wtLJPvx7-ys\n```\n\nRetrieve videos rated by the current user\n-----------------------------------------\n\nThe `videos.list` method's [myRating](/youtube/v3/docs/videos/list#myRating) parameter lets you retrieve a list of videos rated by the user authorizing the API request. The parameter value indicates whether you want to retrieve liked or disliked videos.\n\nThe sample request below retrieves a list of videos to which the current user gave a `like` rating. The request must be authorized using OAuth 2.0. \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?\npart=snippet\n&myRating=like\n``` \n**Note:** You can also retrieve a list of the user's liked videos (but not disliked videos) by following the flow for [retrieving a channel's favorite videos](#favorites). In step 1 of that process, instead of retrieving the playlist ID for the channel's favorite videos, retrieve the playlist ID for the channel's liked videos. The `contentDetails.relatedPlaylists.likes` property contains the value. \n\nThus, the API allows you to retrieve a list of videos that the user liked using either the `videos.list` method or the `playlistItems.list` method. Since different information is returned in a `video` resource than a `playlistItem` resource, you can choose the method that best suits your needs."]]
