Einleitung
Der Videodatenendpunkt bietet eine schnelle Möglichkeit, spezifische Daten für ein bestimmtes Video abzurufen. Aktuelle Anfragen geben die Gesamtaufrufe für das Video zurück. In Zukunft können zusätzliche Daten zurückgegeben werden. Der Hauptanwendungsfall für diesen Endpunkt wäre die Bereitstellung von Informationen zu Allzeitansichten an Spieler auf stark frequentierten Seiten, auf denen große Mengen regelmäßiger Anfragen an die Analytics API wäre zu langsam.
Endpunkt
Der Endpunkt für Videodatenanfragen ist:
https://analytics.api.brightcove.com/v1/alltime/accounts/{account_id}/videos/{video_id}
Alle Anfragen sind GET.
Authentifizierung
Alle Anfragen an die Analytics API werden über den OAuth-Dienst von Brightcove authentifiziert.
Die Authentifizierung basiert auf einem Zugriffstoken, das in einem Authorization-Header übergeben wird:
Authorization: Bearer {your token}
Sie können Client-Anmeldeinformationen für die erhalten Analytics API und verwenden Sie diese, um temporäre Zugriffstoken abzurufen - siehe OAuth-Übersicht Für eine Erläuterung der verschiedenen Ansätze können Sie Client-Anmeldeinformationen und Zugriffstoken abrufen Verwalten von API-Anmeldeinformationen Informationen zum Abrufen von Client-Anmeldeinformationen über Studio
Antwort
Die Antwort auf eine Anfrage ist JSON in der Form:
{
"alltime_video_views": 103123
}
Mögliche Implementierung
So können Sie den Videodatenendpunkt verwenden, um Allzeitansichten für ein Video anzuzeigen, wenn es in einen Player geladen wird:
- Richten Sie das Caching ein, um Aufrufe nach Video-ID 5 bis 10 Minuten lang zu speichern.
- Erstellen Sie eine Logik auf Ihrem Server oder auf Ihren Seiten, um zuerst den Cache zu überprüfen, um festzustellen, ob die Alltime-Videoansichtsdaten für das aktuelle Video bereits vorhanden sind, und wenn ja, verwenden Sie sie.
- Wenn der Wert noch nicht im Cache gespeichert ist, stellen Sie eine Anforderung an den Videoinformationsendpunkt, um ihn abzurufen, und speichern Sie den Wert im Cache zusammen mit der Anzeige auf der Seite.
- Stellen Sie sicher, dass die Ausnahmebehandlung für den Fall eingerichtet wird, dass die Anforderung an den Videoinformationsendpunkt ein Timeout hat oder nicht erfolgreich ist. Möglicherweise werden die Videoaufrufe aller Zeiten einfach nicht angezeigt oder Sie verwenden den letzten Wert, den Sie haben.
