Video-Vorschaubilder in benutzerdefinierten Anwendungen korrigieren

Wenn du die Vimeo-API in deinen benutzerdefinierten Anwendungen verwendest und/oder die URL deiner Video-Vorschaubilder zwischenspeicherst, werden deine Vorschaubilder möglicherweise nicht mehr im Video-Player angezeigt, insbesondere in Fällen, in denen deine Vorschaubild-URLs in einer Anwendung oder Website hartcodiert wurden. Das bedeutet, dass die Linkstruktur nicht automatisch aktualisiert wird.

Um die Vorschaubilder für diese Anwendungsfälle zu korrigieren, musst du einen API-Aufruf initiieren, um eine GET-Anfrage für das Vorschaubild eines Videos von den Vimeo-Servern einzuleiten. Wir empfehlen, dies regelmäßig zu implementieren, anstatt die URLs der Video-Vorschaubilder zwischenzuspeichern. Zudem empfiehlt es sich, mehrere Aufrufe auf einmal durchzuführen, da dies effizienter ist. 

Eine zusätzliche Dokumentation, wie du deine Vorschaubild-URLs über die Vimeo-API abrufen kannst, findest du auf unserer Entwickler-Website Vimeo-Entwickler: Ein bestimmtes Video-Vorschaubild abrufen.

Hier findest du eine schrittweise Anleitung zum Abrufen der URLs deiner Video-Vorschaubilder:

1. 1. Logge dich in dein Vimeo-Konto ein und gehe zu https://developer.vimeo.com/  
   2. Wenn du noch keine App hast, klicke auf Neue App.
      • Gib der App einen Namen und eine Beschreibung
      • Wähle Nein
      • Wähle App erstellen.
   3. Auf der Seite mit den App-Einstellungen musst du ein Zugriffstoken erstellen, um die Aufrufe an die API zu authentifizieren.
      • Wähle unter Authentifizierung > Allgemein Authentifiziert aus
      • Wähle unter Umfang Privat aus.
      • Klicke auf Generieren.
      • Kopiere das generierte Token und speichere es in einem Texteditor. Du wirst es in einem späteren Schritt benötigen.
   4. Stelle in einer API-Client-Anwendung (z. B. Postman) eine „GET“-Anfrage und gib die folgende URL ein:
      1. https://api.vimeo.com/me/videos
      2. Stelle sicher, dass das Token im Header deiner GET-Anfrage enthalten ist (https://developer.vimeo.com/api/authentication), da es für die Authentifizierung erforderlich ist. Wenn du Postman verwendest, gehe zum Tab „Authorization“, wähle „Bearer token“ in der Dropdown-Liste „Type“ und füge dein Token in das Token-Textfeld ein.
      3. Sende die Anfrage.
   5. Die Nutzdaten enthalten eine Vielzahl von Informationen über deine Videos. Du kannst zusätzliche Parameter verwenden, die unter Vimeo-Entwickler: Alle Vorschaubilder eines Videos abrufen aufgeführt sind, um die gewünschten Ergebnisse zu erzielen.
      • Zum Beispiel: https://api.vimeo.com/me/videos?fields=uri,name,pictures&per_page=100&page=1
        • Diese enthält deine Video-ID, den Titel des Videos, die URL des Vorschaubildes und die ersten 100 Videos. 
        • Die Vorschaubild-URL wird unter „Bilder“ für jedes Video aufgeführt.

In diesem Video-Tutorial findest du einen Überblick über den Prozess: URLs von Video-Vorschaubildern mit der Vimeo-API abrufen.