Aggiungi una valutazione di Mi piace o Non mi piace a un video o rimuovi una valutazione da un video.
Impatto della quota: una chiamata a questo metodo ha un costo della quota di 50 unità.
NOTA:questa scelta non influisce sul conteggio ufficiale dei Mi piace/Non mi piace sul video.
Casi d'uso comuni
Richiesta
Richiesta HTTP
POST https://www.googleapis.com/youtube/v3/videos/rate
Autorizzazione
Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti (scopri di più su autenticazione e autorizzazione).
Ambito |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parametri
La tabella seguente elenca i parametri supportati da questa query. Tutti i parametri elencati sono parametri di query.
Parametri | ||
---|---|---|
Parametri obbligatori | ||
id |
string Il parametro id specifica l'ID video di YouTube del video che viene valutato o di cui è stata rimossa la classificazione. |
|
rating |
string Specifica la valutazione da registrare. I valori accettati sono:
|
Corpo della richiesta
Non fornire il corpo della richiesta quando chiami questo metodo.
Risposta
Se l'esito è positivo, questo metodo restituisce un codice di risposta HTTP 204
(No Content
).
Errori
La tabella seguente identifica i messaggi di errore che l'API potrebbe restituire in risposta a una chiamata a questo metodo. Per ulteriori dettagli, consulta la documentazione relativa ai messaggi di errore.
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
emailNotVerified |
L'utente deve verificare il proprio indirizzo email prima della valutazione. |
badRequest (400) |
invalidRating |
La richiesta conteneva un valore imprevisto per il parametro rating . |
badRequest (400) |
videoPurchaseRequired |
I video a noleggio possono essere valutati solo dagli utenti che li hanno noleggiati. |
forbidden (403) |
forbidden |
Il video che stai cercando di valutare non può essere valutato. La richiesta potrebbe non essere autorizzata in modo adeguato. |
forbidden (403) |
videoRatingDisabled |
Il proprietario del video che stai tentando di valutare ha disattivato le valutazioni del video in questione. |
notFound (404) |
videoNotFound |
Impossibile trovare il video che stai cercando di valutare. Verifica che il valore del parametro id della richiesta sia corretto. |
Prova.
Usa APIs Explorer per chiamare questa API e visualizzare la richiesta e la risposta dell'API.