Komponenten
Host-URLs
https://graph-video.facebook.com– Wird ausschließlich zur Veröffentlichung von Videos auf Seiten und in Gruppen verwendet.https://graph.facebook.com– Wird für alles andere verwendet (Erstellen von Umfragen, Abrufen von Insights usw.).
Upload-Protokolle
Die API unterstützt Protokolle für wiederaufnehmbare und nicht wiederaufnehmbare Uploads. Das Protokoll für wiederaufnehmbare Uploads wird für das sequenzielle Hochladen von Video-Chunks verwendet, während mit dem Protokoll für nicht wiederaufnehmbare Uploads vollständige Videos hochgeladen werden. Wir empfehlen die Verwendung des Protokolls für wiederaufnehmbare Uploads, da es größere Videodateien unterstützt und dir einen effizienteren Umgang mit Verbindungsunterbrechungen ermöglicht.
Ressourcen
Die API verwendet die folgenden Nodes.
Videos
Der Video-Node ist die Hauptressource der API. Wenn du ein vorhandenes Video hochlädst, generiert die API eine Videoentität und veröffentlicht diese auf einer Seite oder in einer Gruppe, je nachdem, welchen Node du zu Beginn des Veröffentlichungsprozesses als Ziel festlegst. Videos müssen auf einem Ziel-Node veröffentlicht werden.
Seiten
Videos können in einer Gruppe veröffentlicht werden, wenn die App über die entsprechenden Berechtigungen und Features verfügt. Außerdem muss der App-Benutzer die Entsprechung von Admin-Aufgaben auf der Seite ausführen können oder über den Business Manager eine Admin-Rolle für die Seite erhalten haben.
Gruppen
Videos können in einer Gruppe veröffentlicht werden, wenn die App über die entsprechenden Berechtigungen und Features verfügt und der App-Benutzer ein Administrator der Gruppe ist.
Crossposting-Videos
Videos, die bereits veröffentlicht wurden, können auch auf anderen Seiten veröffentlicht werden, die vom App-Benutzer verwaltet werden. Sie müssen dafür nicht neu hochgeladen werden. Insights zu Crossposting-Videos können als aggregierte Werte (z. B. die Summe aller Aufrufe für alle Seiten) oder nach Seite aufgeschlüsselt zurückgegeben werden.
Slideshows
Mit der API kannst du aus einer Collection von Bildern, die auf einem öffentlichen Server gehostet werden, ein Slideshow-Video generieren.
Umfragen
Mit der API kannst du Umfragen zu veröffentlichten Videos erstellen und ihre Ergebnisse abrufen.
Werbeanzeigen
Veröffentlichte Videos können zusammen mit dem Anzeigengestaltungs-Endpunkt der Marketing API zur Erstellung von Video Ads verwendet werden.
Insights
Du kannst zu allen veröffentlichten Videos Insights abrufen. Insights zu Crossposting-Videos können als aggregierte Werte oder nach Seite aufgeschlüsselt zurückgegeben werden.
Webhooks
Für Videos, die auf Seiten veröffentlicht werden, kannst du Benachrichtigungen über Änderungen des Veröffentlichungsstatus eines Videos und Interaktionen von Betrachtern in Echtzeit erhalten. Hierzu musst du Seiten-Webhooks einrichten. Richte einen Rückruf ein und abonniere dann die Felder feed und videos des Seitenthemas, um Benachrichtigungen zu erhalten. Beachte, dass für Videos, die als secret oder no_story hochgeladen werden, keine Benachrichtigungen gesendet werden.
Rechteverwaltung
Für Videos, die auf einer Seite veröffentlicht werden, kannst du die Rights Management API verwenden, um Copyright-Regeln zu erstellen und anzuwenden. Somit kannst du andere veröffentlichte Videos entdecken, die möglicherweise Regeln verletzen, und diese melden.
Anforderungen
Berechtigungen
Um auf einer Seite zu veröffentlichen, muss der App-Benutzer deiner App die Berechtigungen pages_show_list, pages_read_engagement und pages_manage_posts gewähren.
Um in einer Gruppe zu veröffentlichen, muss der App-Benutzer deiner App die Berechtigung publish_to_groups gewähren.
Features
Für die Veröffentlichung auf einer Seite sind keine Features erforderlich. Zum Veröffentlichen in einer Gruppe muss deine App muss für das Feature Groups API zugelassen werden.
Admin-Rolle
Der App-Benutzer muss auf der Zielseite die Entsprechung von ADMIN-Aufgaben ausführen können oder ein Administrator der Zielgruppe sein.
App Review
Für alle Berechtigungen und Features ist ein App Review erforderlich.
So funktioniert‘s
Der allgemeine Ablauf zum Veröffentlichen eines Videos auf einer Seite oder in einer Gruppe sieht folgendermaßen aus:
- Abrufen eines Zugriffsschlüssels und entsprechender Berechtigungen vom App-Benutzer
- Abrufen einer Liste mit Seiten oder Gruppen, für die der App-Benutzer die Entsprechung von Admin-Aufgaben ausführen kann
- Bereitstellen einer Möglichkeit für den App-Benutzer, die Seite oder Gruppe auszuwählen, auf bzw. in der das Video erscheinen soll
- Bereitstellen einer Möglichkeit für den App-Benutzer, ein zu veröffentlichendes Video auszuwählen
- Aufteilen des Videos in kleinere Chunks
- Initiieren einer Upload-Sitzung und Hochladen der einzelnen Chunks
- Beenden der Upload-Sitzung