Agrega una calificación "me gusta" o "no me gusta" a un video o elimina la calificación de un video.
Impacto de la cuota: Una llamada a este método tiene un costo de cuota de 50 unidades.
NOTA: Esto no afecta el recuento oficial de “me gusta” y “no me gusta” del video.
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).
Permiso |
---|
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 el ID 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 |
Los videos en alquiler solo pueden ser evaluados por los usuarios que los alquilaron. |
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 de este. |
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ébala
Usa APIs Explorer para llamar a esta API y ver la solicitud y la respuesta a la API.