Fijar miniaturas de videos en las aplicaciones personalizadas

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 regularmente, en lugar de almacenar en caché las URL de las miniaturas de los videos. También recomendamos agrupar estas llamadas si es posible, lo que 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 Vimeo para desarrolladores: Obtener una miniatura de video específica.

A continuación, encuentra una guía paso a paso para recuperar las URL de las miniaturas de los videos:

1. 1. Accede a tu cuenta Vimeo y dirígete a https://developer.vimeo.com/  
   2. Si aún no tienes una aplicación, haz clic en Nueva aplicación.
      • Dale un nombre a la aplicación y brinda una descripción de ella.
      • Elige No.
      • Selecciona Crear aplicación.
   3. 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.
   4. En una aplicación cliente de la API (por ejemplo, Postman), haz una solicitud OBTENER e introduce la siguiente URL:
      1. https://api.vimeo.com/me/videos
      2. 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.
      3. Envía la solicitud.
   5. La carga incluirá mucha información sobre tus videos. Puedes utilizar parámetros adicionales que aparecen en Vimeo para desarrolladores: Obtén todas las miniaturas de un video para especificar los resultados que necesita.
      • Por ejemplo: https://api.vimeo.com/me/videos?fields=uri,name,pictures&per_page=100&page=1
        • Esto incluirá tu ID de video, el título del video, la URL en miniatura, e incluirá los 100 primeros videos. 
        • La URL de la miniatura aparecerá en imágenes para cada video.

Accede a un recorrido del proceso en este video tutorial: Recuperación de las URL de las miniaturas de los videos mediante la API de Vimeo.