Facebook Reels API: publikowanie Reels na Stronie
Facebook Reels API publikuje Reels na Stronie w trzech krokach: POST /{page-id}/video_reels z upload_phase start zwraca video_id, wideo trafia na rupload.facebook.com, a POST /{page-id}/video_reels z upload_phase finish i video_state PUBLISHED je publikuje. Specyfikacja Meta to wideo 9:16 o długości od 3 do 90 sekund, a Strona może opublikować przez API 30 Reels w ciągu 24 godzin.
easyCoexistence publikuje wideo na Stronie na Facebooku jako zwykłe posty wideo przez publish_facebook_post, z Claude, ChatGPT lub Twojego własnego kodu, obok tekstu, linków i zdjęć.
Reels opublikowane przez API na Stronę w ruchomym okresie 24 godzin, egzekwowane na POST /{page_id}/video_reels.
Długość Reels akceptowana przez Meta; Reels opublikowany jako relacja na Stronie nie może przekraczać 60 sekund.
Minimalna rozdzielczość Reels; Meta zaleca 1080 x 1920 pikseli przy proporcji 9 x 16.
Najdalej wysunięty scheduled_publish_time, jaki może ustawić Reels, co najmniej 10 minut naprzód, z video_state SCHEDULED.
Kod błędu dla Reels o długości, której Facebook nie obsługuje; Reels muszą trwać od 3 do 90 sekund.
Jak Reels API publikuje Reels?
W trzech krokach w dwóch hostach. Wywołania start i finish idą do edge video_reels Strony na graph.facebook.com, a samo wideo trafia na rupload.facebook.com, pod upload_url zwrócony przez wywołanie start. Sprawdzenie statusu ID wideo między uploadem a finish pokazuje, czy Meta ma cały plik i czy go przetworzyła.
Jakie wideo potrzebuje Reels?
Meta publikuje specyfikacje Reels w przewodniku Reels Publishing, a upload, który nie spełnia wymagań dotyczących proporcji, rozdzielczości, długości lub liczby klatek na sekundę, zostaje odrzucony z własnym kodem błędu. Reels przeznaczony jako relacja na Stronie musi też mieścić się w 60 sekundach.
Jak wideo jest wysyłane?
Żądaniem POST na upload_url na rupload.facebook.com, z tokenem Strony w nagłówku Authorization: OAuth. Plik na Twoim komputerze idzie jako treść żądania, z nagłówkiem offset ustawionym na 0 i file_size ustawionym na jego rozmiar w bajtach. Plik już dostępny w sieci wysyłasz zamiast tego w nagłówku file_url; Meta sama go pobiera, a udany upload zwraca success ustawione na true.
file_urlprzyjmuje adresy http lub https; adresy wymagające uwierzytelnienia nie są obsługiwane.- Host musi pozwolić agentowi użytkownika facebookexternalhit/1.1 pobrać plik, bo Meta odrzuca pliki na stronach, które to blokują w robots.txt.
- Pliki z sieci CDN Meta, na przykład adresy fbcdn, są odrzucane; Meta wskazuje crossposting, aby ponownie użyć wideo na innej Stronie.
# <UPLOAD_URL> is the upload_url the start call returned
curl -X POST "<UPLOAD_URL>" \
-H "Authorization: OAuth <PAGE_ACCESS_TOKEN>" \
-H "file_url: https://example.com/reel.mp4"Jak sprawdzić status Reels?
Żądaniem GET /{video-id}?fields=status na graph.facebook.com. Odpowiedź zawiera video_status, które przyjmuje wartości uploading, upload_complete, processing, ready, upload_failed, expired lub error, oraz po jednym obiekcie na fazę: uploading_phase z bytes_transfered, processing_phase z ewentualnym komunikatem błędu oraz publishing_phase z publish_status (draft, scheduled, published lub error) i publish_time. Status każdej fazy to not_started, in_progress, completed lub error.
Jak wznowić przerwany upload?
Wysyłając ponownie POST uploadu z nagłówkiem offset ustawionym na uploading_phase.bytes_transfered z wywołania statusu, czyli na bajty, które Meta już ma. Offset, którego Meta nie przyjmuje, zwraca OffsetInvalidError, treść niezgodna z długością pliku zwraca PartialRequestError, a gdy ponowny upload nie działa, Meta radzi zacząć od pierwszego kroku.
Co przyjmuje wywołanie finish?
video_id z wywołania start, upload_phase ustawione na finish oraz video_state ustawione na PUBLISHED, DRAFT lub SCHEDULED. description niesie tekst i obsługuje hashtagi. title oraz place dla Strony z lokalizacją, a także is_ai_generated, które ujawnia, że Reels został stworzony lub edytowany z pomocą AI, są opcjonalne. Zaplanowany Reels dodaje scheduled_publish_time, znacznik czasu UNIX więcej niż 10 minut i nie dalej niż 29 dni naprzód. Meta odpowiada success ustawionym na true.
Ile Reels Strona może opublikować przez API?
30 w ruchomym okresie 24 godzin. Meta egzekwuje limit na POST /{page_id}/video_reels przy publikacji i zaleca, aby same aplikacje też go egzekwowały, zwłaszcza te, które pozwalają ludziom planować posty na później. Zaproszenia współpracowników mają własny limit, 10 na Stronę w ciągu 24 godzin, a dokumentacja video_reels podaje błąd 613: wywołania tego API przekroczyły limit częstotliwości.
Jakie uprawnienia i zadanie na Stronie są potrzebne?
Token dostępu Strony od kogoś, kto może wykonać zadanie CREATE_CONTENT na Stronie, z uprawnieniami pages_show_list, pages_read_engagement i pages_manage_posts przyznanymi przez Facebook Login. Meta prosi też aplikacje, aby pokazywały użytkownikowi informację o tym, jak jego Reels są używane na Facebooku, wraz z opcjami kontroli, oraz aby oferowały tylko widownię Public, ponieważ publikacja na Stronie ma domyślnie zasięg publiczny.
Jakich błędów zwraca Reels API?
Kod 100 oznacza brak wymaganego parametru, na przykład upload_phase, a komunikat Meta wymienia brakujące. Cztery kolejne kody odrzucają wideo spoza specyfikacji:
- 1363040: proporcja nie jest obsługiwana; wideo musi mieścić się między 16x9 a 9x16.
- 1363127: rozdzielczość nie jest obsługiwana; minimum to 540 x 960 pikseli.
- 1363128: długość nie jest obsługiwana; Reels trwają od 3 do 90 sekund.
- 1363129: średnia liczba klatek na sekundę nie jest obsługiwana; Reels potrzebują od 24 do 60 klatek na sekundę.
Jak wylistować Reels Strony?
Żądaniem GET /{page-id}/video_reels, które zwraca opublikowane Reels Strony wraz z ich ID, czasem aktualizacji i opisami. since i until zawężają listę do dat podanych jako today, yesterday, znacznik czasu UNIX lub yyyy-mm-dd, przy czym until musi być późniejsze niż since. Dokumentacja feedu Meta wskazuje tę krawędź dla Reels opublikowanych na Stronie.
Jak publikować Reels przez easyCoexistence?
Dziś nie jako Reels. publish_facebook_post wysyła wideo do edge videos Strony jako zwykłe posty wideo, a easyCoexistence nie ma narzędzia do wywołań video_reels; tokeny Strony nie są wydawane, więc tych trzech kroków nie da się też wykonać z Twojego własnego kodu na jego połączeniu. Opublikuj film w Reels z Facebooka lub Meta Business Suite albo wrzuć wideo jako zwykły post wideo.
Typowe błędy
- Wysyłanie uploadu na graph.facebook.com. Wideo idzie na rupload.facebook.com z nagłówkiem Authorization: OAuth; tylko wywołania start, finish i status używają graph.facebook.com.
- Hostowanie pliku tam, gdzie Meta go nie pobierze. file_url za logowaniem, na stronie, której robots.txt blokuje facebookexternalhit/1.1, albo na fbcdn jest odrzucany.
- Zaczynanie od nowa po przerwanym uploadzie. Najpierw sprawdź status: uploading_phase.bytes_transfered to offset, od którego wznawiasz, a nowa sesja to ostateczność.
- Kolejkowanie ponad 30 Reels dla jednej Strony w ciągu dnia. Meta liczy Reels opublikowane przez API w ruchomym okresie 24 godzin, więc rozłóż zaplanowane równomiernie.
Nie ma narzędzia do Reels API, więc Reels publikuje się z Facebooka lub Meta Business Suite. US$ 9 do US$ 0.75 za połączenie miesięcznie, z każdym kolejnym połączeniem taniej, a pierwsze 3 dni są bezpłatne.
Najczęściej zadawane pytania
Czy przez API można opublikować Reels na profilu Facebooka lub w grupie?
Nie. Reels Publishing API Meta publikuje Reels tylko na Stronach Facebooka, a crossposting kieruje je wyłącznie na inne Strony.
Czy publish_facebook_post publikuje Reels?
Nie. Wysyła tekst, linki, zdjęcia i wideo na Stronę. Reels wymaga wywołań video_reels, których narzędzia easyCoexistence nie wykonują.
Jak sprawdzić Reels pod kątem dopasowań praw autorskich?
Odczytaj GET /{video-id}?fields=copyright_check_information z pages_read_engagement. Meta uruchamia sprawdzenie przy uploadzie, może to potrwać kilka minut, a dopasowania widzi tylko właściciel.
Czy inna Strona może opublikować mój Reels?
Tak, jako współpracownik. POST /{video-id}/collaborators z target_id ustawionym na ID ich Strony wysyła zaproszenie, a po jego przyjęciu Reels pojawia się także na ich Stronie.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w