Si usa la API de Vimeo en sus aplicaciones personalizadas y/o está almacenando en caché la URL de la miniatura de su video, es posible que sus miniaturas ya no aparezcan en el reproductor de video, particularmente en los casos en que las URL de su miniatura estaban codificadas en una aplicación o sitio que, por lo tanto, significa que la estructura del enlace no se actualizará automáticamente.
Para corregir miniaturas para estos casos de uso, deberá iniciar una llamada 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 miniaturas de video. También recomendamos agrupar estas llamadas en lotes si es posible, lo que será más eficiente.
Puede encontrar documentación adicional sobre cómo recuperar sus URL en miniatura a través de la API de Vimeo en nuestro sitio de desarrollo aquí .
Aquí hay una guía paso a paso sobre cómo recuperar las URL de las miniaturas de sus videos:
-
- Inicie sesión en su cuenta de Vimeo y vaya a https://developer.vimeo.com/
- Si aún no tiene una aplicación, haga clic en Nueva aplicación .
- Asigne un nombre a la aplicación, una descripción, elija No y, a continuación, seleccione Crear aplicación .
- En la página de configuración de la aplicación, debe crear un token de acceso para autenticar las llamadas a la API.
- En Autenticación > General, seleccione Autenticado
- En Ámbitos, seleccione Privado .
- Haz clic en Generar.
- Copie el token que se genera y guárdelo en un editor de texto. Lo necesitará en un paso posterior.
- En una aplicación de cliente API (p. ej., Postman), realice una solicitud «GET» e ingrese la siguiente URL:
- https://api.vimeo.com/me/videos
- Asegúrese de que el token esté incluido en el encabezado de su solicitud GET ( https://developer.vimeo.com/api/authentication ), ya que es necesario para la autenticación. Si usa Postman, vaya a la pestaña Autorización, luego seleccione «Token de portador» en el menú desplegable Tipo y pegue su token en el campo de texto del token.
- Envía la solicitud.
- La carga útil incluirá mucha información sobre tus videos. Puede utilizar los parámetros adicionales enumerados en nuestra página de desarrollador 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á su ID de video, el título del video, la URL de la miniatura e incluirá los primeros 100 videos en
- La URL de la miniatura aparecerá debajo de «imágenes» para cada video.
- Por ejemplo: https://api.vimeo.com/me/videos?fields=uri,name,pictures&per_page=100&page=1
Aquí hay un video tutorial de uno de nuestros ingenieros que explica este proceso.
