Correction des vignettes vidéo dans les applications personnalisées – Centre d'aide

Si vous utilisez l'API Vimeo dans vos applications personnalisées et/ou si l'URL de vos vignettes vidéo est en cache, il se peut que vos vignettes n'apparaissent plus dans le player vidéo, en particulier dans les cas où les URL de vos vignettes ont été codées en dur dans une application ou un site, ce qui signifie que la structure des liens ne sera pas mise à jour automatiquement.

Si tel est le cas, pour corriger les vignettes, vous devrez appeler une API pour obtenir la vignette d'une vidéo à partir des serveurs Vimeo. Nous recommandons d'appliquer régulièrement cette méthode au lieu de mettre en cache les URL des vignettes des vidéos. Nous recommandons également si possible, de regrouper ces appels pour plus d'efficacité.

Vous trouverez une documentation avec plus d'informations sur la façon de récupérer les URL de vos vignettes via l'API Vimeo sur la page « Vimeo Developer : Obtenir une vignette de vidéo spécifique » (en anglais) de notre site développeur.

Voici un guide étape par étape pour récupérer les URL des vignettes de vos vidéos :

1. Connectez-vous à votre compte Vimeo sur https://developer.vimeo.com/
2. Si vous n'avez pas encore d'application, cliquez sur Nouvelle application.
  - Ajoutez un nom et une description à l'application
  - Choisissez Non
  - Sélectionnez Créer une application.
3. Sur la page des paramètres de l'application, vous devez créer un jeton d'accès pour authentifier les appels à l'API.
  - Sous Authentification > Général, sélectionnez Authentifié
  - Sous Cadres, sélectionnez Privé.
  - Cliquez sur Générer.
  - Copiez le jeton qui est généré et enregistrez-le dans un éditeur de texte. Vous en aurez besoin ultérieurement.
4. Dans une application client API (par exemple Postman), faites une requête « GET » (obtenir) et saisissez l'URL suivante :
  1. https://api.vimeo.com/me/videos
  2. Assurez-vous que le jeton est inclus dans l'entête de votre requête GET (https://developer.vimeo.com/api/authentication) car il vous sera nécessaire pour vous identifier. Si vous utilisez Postman, allez dans l'onglet Autorisation, puis sélectionnez « Bearer token » (jeton de porteur) dans la liste déroulante Type (genre), et collez votre jeton dans le champ du jeton.
  3. Envoyez la requête.
5. La charge utile comprendra de nombreuses informations sur vos vidéos. Vous pouvez utiliser les paramètres supplémentaires énumérés sur la page « Vimeo Developer: Obtenir toutes les vignettes d'une vidéo » (en anglais) pour spécifier les résultats dont vous avez besoin.
  - Par exemple : https://api.vimeo.com/me/videos?fields=uri,name,pictures&per_page=100&page=1
    - Cela inclura l'ID de votre vidéo, le titre de la vidéo, l'URL de la vignette, et listera les 100 premières vidéos.
    - L'URL de la vignette sera indiquée sous « images » pour chaque vidéo.

Vous trouverez une description détaillée du processus dans ce tutoriel vidéo : Récupérer les URL de vignettes de vidéos à l'aide de l'API Vimeo (en anglais).

Articles associés