Video-Vorschaubilder in benutzerdefinierten Anwendungen korrigieren – Acme Technology Solutions Hilfezentrum

Wenn du die ZenVideo-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 ZenVideo-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 ZenVideo-API abrufen kannst, findest du auf unserer Entwickler-Website ZenVideo-Entwickler: Ein bestimmtes Video-Vorschaubild abrufen.

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

1. Logge dich in dein ZenVideo-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 ZenVideo-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 ZenVideo-API abrufen.