Agrega una calificación "me gusta" o "no me gusta" a un video o elimina la calificación de un video.
Impacto en la cuota: Una llamada a este método tiene un costo de cuota de 50 unidades.
Casos de uso habituales
Solicitud
Solicitud HTTP
POST https://www.googleapis.com/youtube/v3/videos/rate
Autorización
Esta solicitud requiere autorización con al menos uno de los siguientes alcances (obtén más información acerca de la autenticación y autorización).
Alcance |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parámetros
En la siguiente tabla, se enumeran los parámetros que admite esta consulta. Todos los parámetros mencionados son parámetros de consulta.
Parámetros | ||
---|---|---|
Parámetros obligatorios | ||
id |
string El parámetro id especifica la identificación de video de YouTube del video que se está calificando o cuya calificación se está quitando. |
|
rating |
string Especifica la calificación que se registrará. Los valores aceptables son los siguientes:
|
Cuerpo de la solicitud
No proporciones un cuerpo de solicitud cuando invoques este método.
Respuesta
Si se aplica correctamente, este método muestra un código de respuesta HTTP 204
(No Content
).
Errores
En la siguiente tabla se identifican los mensajes de error que la API podría mostrar en respuesta a una llamada a este método. Consulta la documentación sobre mensajes de error para obtener más información.
Tipo de error | Detalle del error | Descripción |
---|---|---|
badRequest (400) |
emailNotVerified |
El usuario debe verificar su dirección de correo electrónico antes de calificar. |
badRequest (400) |
invalidRating |
La solicitud contenía un valor inesperado para el parámetro rating . |
badRequest (400) |
videoPurchaseRequired |
Solo los usuarios que los alquilaron pueden calificar los videos de alquiler. |
forbidden (403) |
forbidden |
El video que intentas calificar no se puede clasificar. Puede que la solicitud no esté debidamente autorizada. |
forbidden (403) |
videoRatingDisabled |
El propietario del video que intentas calificar inhabilitó las calificaciones para ese video. |
notFound (404) |
videoNotFound |
El video que intentas calificar no se puede encontrar. Comprueba el valor del parámetro id de la solicitud para asegurarte de que sea correcto. |
Pruébela.
Usa APIs Explorer para llamar a esta API y ver la solicitud y la respuesta de la API.