Si usas la API de Vimeo en tus aplicaciones personalizadas o estás almacenando en caché la URL de tus miniaturas de videos, es posible que estas ya no aparezcan en el reproductor de video, en especial en los casos en los que las URL de tus miniaturas estaban codificadas de manera no flexible en una aplicación o sitio, lo que significa que la estructura de los enlaces no se actualizará automáticamente.
Para fijar las miniaturas para estos casos de uso, tendrás que iniciar una llamada a la API para OBTENER la miniatura de un video de los servidores de Vimeo. Recomendamos implementar esto con regularidad en lugar de almacenar en caché las URL de las miniaturas de los videos. También recomendamos, si es posible, realizar estas llamadas por lotes, ya que de este modo el proceso será más eficiente.
Puedes encontrar documentación adicional sobre cómo recuperar tus URL de miniaturas a través de la API de Vimeo en nuestro sitio de desarrollo aquí.
Aquí tienes una guía paso a paso para recuperar las URL de las miniaturas de tus videos:
-
- Accede a tu cuenta Vimeo y dirígete a https://developer.vimeo.com/
-
Si aún no tienes una aplicación, haz clic en Nueva aplicación.
- Ingresa un nombre para la aplicación, una descripción, elige No, y luego selecciona Crear aplicación.
-
En la página de configuración de la aplicación, tienes que crear un token de acceso para autenticar las llamadas a la API.
- En Autenticación > General, selecciona Autenticado
- En Alcance, selecciona Privado.
- Haz clic en Generar.
- Copia el token que se genera y guárdalo en un editor de texto. Lo necesitarás en un paso posterior.
-
En una aplicación cliente de la API (por ejemplo, Postman), haz una solicitud OBTENER e introduce la siguiente URL:
- https://api.vimeo.com/me/videos
- Asegúrate de que el token esté incluido en el encabezado de tu solicitud OBTENER (https://developer.vimeo.com/api/authentication) ya que es necesario para la autenticación. Si usas Postman, ve a la pestaña Autorización, luego selecciona Token de portador en las opciones desplegables de Tipo, y pega tu token en el campo de texto del token.
- Envía la solicitud.
-
La carga incluirá mucha información sobre tus videos. Puedes usar los parámetros adicionales que aparecen en nuestra página para desarrolladores para especificar los resultados que necesitas.
-
Por ejemplo: https://api.vimeo.com/me/videos?fields=uri,name,pictures&per_page=100&page=1
- Esto incluirá la ID de tu video, el título del video, la URL de la miniatura, e incluirá los 100 primeros videos en
- La URL de la miniatura aparecerá en imágenes para cada video.
-
Por ejemplo: https://api.vimeo.com/me/videos?fields=uri,name,pictures&per_page=100&page=1
Aquí encontrarás un video tutorial de uno de nuestros ingenieros que explica este proceso.