Videos: rate

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 influye en 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).

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 el ID de video de YouTube del video que se está calificando o cuya calificación se está eliminando.
rating string
Especifica la calificación que se va a registrar.

Los valores aceptables son los siguientes:
  • dislike: registra que al usuario autenticado no le gustó el video.
  • like: registra que al usuario autenticado le gustó el video.
  • none: elimina cualquier calificación que el usuario autenticado haya establecido previamente para el video.

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 la calificación.
badRequest (400) invalidRating La solicitud contenía un valor inesperado para el parámetro rating.
badRequest (400) videoPurchaseRequired Sólo los usuarios que han alquilado los videos en alquiler pueden calificarlos.
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 ha inhabilitado las calificaciones para 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ébalo

Usa APIs Explorer para llamar a esta API y ver la solicitud y la respuesta a la API.