Videos über die API auf einer Facebook-Seite veröffentlichen
Ein Video erreicht eine Facebook-Seite über POST /{page-id}/videos, entweder mit file_url, einer URL, die Meta selbst herunterlädt, oder mit einer Datei, die die App zuvor an Meta hochlädt. title benennt das Video, description ist der Text, den Meta zusammen mit dem Beitrag anzeigen kann. Danach verarbeitet Meta die Datei, und GET /{video-id}?fields=status meldet video_status als processing, bis der Wert ready lautet.
easyCoexistence veröffentlicht Videos auf Facebook-Seiten mit publish_facebook_post aus Claude, ChatGPT oder Ihrem eigenen Code, sofort oder geplant bis zu 90 Tage im Voraus.
Fehlercode, wenn Meta die Videodatei über die in file_url angegebene URL nicht abrufen kann.
Fehlercode für eine Videodatei, die zu klein zum Hochladen ist; Meta verlangt eine größere Datei.
Zeitfenster für scheduled_publish_time am Edge videos, gerechnet ab dem Zeitpunkt der Veröffentlichung des Videos.
Wertebereich von processing_progress, des Anteils der abgeschlossenen Verarbeitung eines Videos, der neben video_status angegeben wird.
Host für Video-Uploads laut Metas Video-API-Übersicht, die graph-video.facebook.com dafür als veraltet kennzeichnet.
Das Dateihandle, das ein Upload zurückgibt und das als fbuploader_video_file_chunk an /{page-id}/videos übergeben wird, um das Video zu veröffentlichen.
Wie wird ein Video auf einer Seite veröffentlicht?
Mit POST /{page-id}/videos und einem Page-Token. Die Datei gelangt auf zwei Wegen zu Meta: über file_url, eine erreichbare URL des Videos, die Meta selbst abruft, oder über einen Upload, bei dem die App die Daten zuerst sendet. file_url lässt sich nicht mit upload_phase kombinieren, dem Parameter des Chunked-Uploads, sodass eine Anfrage nur einen der beiden Wege nutzt.
| file_url | Uploaded file | |
|---|---|---|
| Where the video is | At a URL Meta can reach | On your own system |
| On /{page-id}/videos | file_url | fbuploader_video_file_chunk with the upload's handle |
| Before publishing | Nothing: Meta fetches the file | An upload session, then the bytes |
| If it fails | Error 389 when Meta cannot fetch it | Resume from the offset Meta reports |
Wie funktioniert der Upload bei einer Datei, die nicht online ist?
Metas Leitfaden zur Videoveröffentlichung nutzt die Resumable Upload API. POST /{app-id}/uploads mit file_name, file_length und file_type öffnet eine Sitzung, und POST /upload:{session-id} mit einem file_offset-Header und den Daten liefert ein Handle, h, zurück. Das Video wird dann mit POST /{page-id}/videos veröffentlicht, wobei fbuploader_video_file_chunk auf dieses Handle gesetzt wird, zusammen mit title und description. Diese Upload-Aufrufe benötigen ein User-Token.
- Ein unterbrochener Upload wird ab dem
file_offsetfortgesetzt, den GET /upload:{session-id} zurückgibt. - Die Videoreferenz dokumentiert außerdem einen Chunked-Upload am selben Edge:
upload_phasestart, transfer und finish, mitstart_offset,file_sizeundvideo_file_chunk.
Wofür dienen title und description?
title ist der Titel des Videos. description ist laut Meta der Text, der einen Beitrag beschreibt und in einer Story dazu angezeigt werden kann, also der Ort für die Worte des Beitrags. Beides ist am Edge videos optional. publish_facebook_post sendet seine message als description und lässt title ungesetzt.
Woran erkennt man, dass das Video bereit ist?
Meta verarbeitet ein Video nach dem Eingang. GET /{video-id}?fields=status liefert video_status, der processing anzeigt, solange Meta arbeitet, ready, sobald das Video hochgeladen, kodiert und mit Vorschaubildern versehen ist, oder error, wenn die Verarbeitung fehlgeschlagen ist. processing_progress gibt dabei den erledigten Anteil von 0 bis 100 an. Meta kann den Veröffentlichungsstatus auch über Page-Webhooks im Feld videos melden, das easyCoexistence nicht abonniert.
Wie groß und wie lang darf das Video sein?
Die Referenz zu Page-Videos und Metas Leitfaden zur Videoveröffentlichung nennen keine maximale Dateigröße und keine Länge. Die Größenregel, die sie benennen, ist Fehler 382, für eine Datei, die zu klein zum Hochladen ist. Metas Leitfäden für Reels und Stories setzen eigene Dauern: 3 bis 90 Sekunden für ein Reel und höchstens 60 für eine Video-Story. Wenn easyCoexistence ein Video plant, kopiert es die Datei in dem Moment und lehnt eine Datei über 1 GB ab.
Welche Berechtigungen und Seitenaufgabe werden benötigt?
pages_manage_posts, pages_read_engagement und pages_show_list, mit einem Page-Token einer Person, die die Aufgabe CREATE_CONTENT ausführen kann, laut Videoreferenz und Veröffentlichungsleitfaden. Metas Video-API-Übersicht formuliert strenger: Die Person sollte administrative Aufgaben auf der Seite ausführen können oder eine über den Business Manager vergebene Admin-Rolle besitzen.
Welche Fehler kann ein Videobeitrag zurückgeben?
Metas Referenz zu Videos listet diese für POST /{page-id}/videos auf:
- 389: Videodatei kann von der URL nicht abgerufen werden.
- 382: die Videodatei ist zu klein; versuchen Sie es mit einer größeren Datei erneut.
- 6000: Problem beim Hochladen der Videodatei; versuchen Sie es mit einer anderen Datei erneut.
- 6001: Problem beim Hochladen des Videos; versuchen Sie es erneut.
- 368: die Aktion wurde als missbräuchlich eingestuft oder ist anderweitig nicht zulässig.
- 100: ungültiger Parameter; 200: Berechtigungsfehler; 190: ungültiges OAuth-2.0-Token.
Wie veröffentlicht publish_facebook_post ein Video?
Es nimmt video_url, einen öffentlichen HTTPS-Link zur Datei, und message entgegen und sendet beides als file_url und description an /{page-id}/videos, sodass Meta das Video selbst abruft. Ein Beitrag enthält ein Video, und ein Link neben dem Video wird abgelehnt. Schreiben Sie die URL daher in die message. Die post_id im Ergebnis enthält die von Meta zurückgegebene ID, die bei einem Video die eigene Video-ID ist.
Wie wird ein Videobeitrag geplant?
Geben Sie publish_facebook_post ein scheduled_at im ISO-8601-Format mit Zeitzone an, von 1 Minute bis 90 Tage im Voraus. easyCoexistence kopiert das Video beim Planen und veröffentlicht es zu diesem Zeitpunkt auf der Seite. list_scheduled_posts zeigt es an, update_scheduled_post verschiebt es oder ändert seinen Text, und cancel_scheduled_post bricht es ab. Metas eigenes scheduled_publish_time am Edge videos erlaubt 10 Minuten bis 6 Monate.
Häufige Fehler
- file_url auf eine Seite richten, die das Video abspielt statt auf die Datei. Meta lädt die Adresse selbst herunter, und eine nicht abrufbare Adresse schlägt mit Fehler 389 fehl.
- Upload an graph-video.facebook.com. Metas Video-API-Übersicht kennzeichnet diesen Host für Video-Uploads als veraltet und verlangt graph.facebook.com.
- Das Video vor seiner Bereitschaft ankündigen. Prüfen Sie den Status, bis video_status ready lautet, da die Verarbeitung nach der Rückgabe des Veröffentlichungsaufrufs weiterläuft.
- Einen Link zusammen mit dem Video senden. publish_facebook_post lehnt einen Link neben einer Datei ab; schreiben Sie die URL stattdessen in die message.
Ihre Plattform kann dasselbe mit POST /channels/:id/posts über die Partner API. US$ 9 bis US$ 0.75 pro Verbindung und Monat, die Staffel sinkt mit jeder weiteren Verbindung, und die ersten 3 Tage sind kostenlos.
Häufig gestellte Fragen
Kann ich ein Video von meinem Computer über die API auf eine Facebook-Seite hochladen?
Ja, über die Resumable Upload API von Meta, die ein Handle für /{page-id}/videos zurückgibt, oder über den Chunked-Upload an diesem Edge. publish_facebook_post nimmt stattdessen eine öffentliche HTTPS-URL, daher hosten Sie die Datei zuerst.
Kann ein Video hochgeladen werden, ohne im Feed der Seite zu erscheinen?
Ja. published auf false gesetzt hält den Beitrag zurück, no_story unterdrückt die Story im Feed und in der Chronik, und secret hält das Video von Facebook fern und aus der Suche heraus.
Kann ein Video auf mehreren Seiten veröffentlicht werden?
Ja, per Crossposting: Ein veröffentlichtes Video kann auf anderen Seiten erscheinen, die die Person verwaltet, ohne erneut hochgeladen zu werden, und erhält auf jeder Seite eine eigene Video-ID.
Was kostet easyCoexistence für eine Facebook-Seite?
US$ 9 bis US$ 0.75 pro Verbindung und Monat, abhängig von Ihrer Gesamtzahl an Verbindungen, mit den ersten 3 Tagen kostenlos. Jede Seite zählt als eine Verbindung.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am