Publikowanie wideo na Stronie na Facebooku przez API
Wideo trafia do Strony na Facebooku przez POST /{page-id}/videos, z file_url, czyli adresem URL, który Meta pobiera samodzielnie, albo z plikiem, który aplikacja najpierw przesyła do Meta. title nazywa wideo, a description to tekst, który Meta może pokazać razem z postem. Następnie Meta przetwarza plik, a GET /{video-id}?fields=status zwraca video_status z wartością processing, aż przyjmie wartość ready.
easyCoexistence publikuje wideo na Stronach na Facebooku za pomocą publish_facebook_post z Claude, ChatGPT lub własnego kodu, od razu albo zaplanowane nawet na 90 dni naprzód.
Kod błędu, gdy Meta nie może pobrać pliku wideo spod adresu podanego w file_url.
Kod błędu dla pliku wideo za małego do przesłania; Meta prosi o większy plik.
Okno dla scheduled_publish_time na krawędzi videos, liczone od momentu opublikowania wideo.
Zakres processing_progress, czyli udziału zakończonego przetwarzania wideo, podawany obok video_status.
Host do przesyłania wideo według przeglądu Video API firmy Meta, który oznacza graph-video.facebook.com jako przestarzały do tych celów.
Uchwyt pliku zwracany przez przesyłanie; przekazuje się go do /{page-id}/videos jako fbuploader_video_file_chunk, aby opublikować wideo.
Jak opublikować wideo na Stronie?
Za pomocą POST /{page-id}/videos i tokenu dostępu Strony. Plik trafia do Meta na jeden z dwóch sposobów: file_url, czyli dostępny adres URL wideo, który Meta pobiera samodzielnie, albo przesłanie, w którym aplikacja najpierw wysyła bajty. file_url nie może być łączony z upload_phase, parametrem przesyłania fragmentami, więc żądanie używa jednego z tych sposobów.
| 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 |
Jak wygląda przesyłanie pliku, który nie jest dostępny online?
Przewodnik Meta po publikowaniu wideo korzysta z Resumable Upload API. POST /{app-id}/uploads z file_name, file_length i file_type otwiera sesję, a POST /upload:{session-id} z nagłówkiem file_offset i bajtami zwraca uchwyt h. Wideo jest następnie publikowane przez POST /{page-id}/videos z fbuploader_video_file_chunk ustawionym na ten uchwyt, obok title i description. Te wywołania przesyłania używają tokenu dostępu użytkownika.
- Przerwane przesyłanie wznawia się od
file_offset, który zwraca GET /upload:{session-id}. - Dokumentacja videos opisuje też przesyłanie fragmentami na tej samej krawędzi:
upload_phasestart, transfer i finish, zstart_offset,file_sizeivideo_file_chunk.
Do czego służą title i description?
title to tytuł wideo. description to, w słowach Meta, tekst opisujący post, który może zostać pokazany w relacji o nim, więc tam trafia treść posta. Oba pola są opcjonalne na krawędzi videos, a publish_facebook_post wysyła swoją wiadomość jako description i nie ustawia title.
Skąd wiadomo, że wideo jest gotowe?
Meta przetwarza wideo po jego dotarciu. GET /{video-id}?fields=status zwraca video_status, który ma wartość processing, dopóki Meta pracuje, ready, gdy wideo jest przesłane, zakodowane i ma miniatury, albo error, gdy przetwarzanie się nie powiodło. processing_progress podaje udział wykonanej pracy od 0 do 100. Meta może też zgłaszać status publikacji przez webhooki Strony w polu videos, z których easyCoexistence nie korzysta.
Jak duże i jak długie może być wideo?
Dokumentacja referencyjna videos ani przewodnik Meta po publikowaniu wideo nie podają maksymalnego rozmiaru pliku ani długości; wymienioną regułą rozmiaru jest błąd 382, dla pliku za małego do przesłania. Przewodniki Meta po Reels i Stories określają własne czasy trwania: od 3 do 90 sekund dla Reela i najwyżej 60 sekund dla relacji wideo. Gdy easyCoexistence planuje wideo, kopiuje plik w tym momencie i odrzuca plik większy niż 1 GB.
Jakie uprawnienia i zadanie Strony są potrzebne?
pages_manage_posts, pages_read_engagement i pages_show_list, z tokenem Strony od osoby, która może wykonać zadanie CREATE_CONTENT, zgodnie z dokumentacją videos i przewodnikiem po publikowaniu. Przegląd Video API firmy Meta formułuje to ściślej: osoba powinna móc wykonywać na Stronie zadania równoważne administratorowi albo mieć rolę Admin nadaną w Business Manager.
Jakie błędy może zwrócić publikacja wideo?
Dokumentacja referencyjna videos Meta wymienia te kody dla POST /{page-id}/videos:
- 389: nie udało się pobrać pliku wideo spod adresu URL.
- 382: plik wideo jest za mały; spróbuj ponownie z większym plikiem.
- 6000: problem z przesłaniem pliku wideo; spróbuj ponownie z innym plikiem.
- 6001: problem z przesłaniem wideo; spróbuj ponownie.
- 368: działanie uznano za nadużycie lub jest ono w inny sposób niedozwolone.
- 100: nieprawidłowy parametr; 200: błąd uprawnień; 190: nieprawidłowy token dostępu OAuth 2.0.
Jak publish_facebook_post publikuje wideo?
Przyjmuje video_url, czyli publiczny link HTTPS do pliku, oraz message, i wysyła je do /{page-id}/videos jako file_url i description, więc Meta sama pobiera wideo. Post może zawierać jedno wideo, a link wysłany razem z nim jest odrzucany, dlatego adres umieść w wiadomości. Pole post_id w wyniku zawiera identyfikator zwrócony przez Meta, który dla wideo jest jego własnym identyfikatorem.
Jak zaplanować publikację posta z wideo?
Podaj publish_facebook_post scheduled_at w formacie ISO 8601 z strefą czasową, od 1 minuty do 90 dni naprzód. easyCoexistence kopiuje wideo w chwili zaplanowania i publikuje je na Stronie o wyznaczonym czasie; list_scheduled_posts je wyświetla, update_scheduled_post przenosi je lub zmienia tekst, a cancel_scheduled_post je zatrzymuje. Pole scheduled_publish_time Meta na krawędzi videos dopuszcza od 10 minut do 6 miesięcy.
Typowe błędy
- Wskazanie file_url na stronę, która odtwarza wideo, zamiast na sam plik. Meta pobiera ten adres samodzielnie, a adres, którego nie może pobrać, kończy się błędem 389.
- Przesyłanie na graph-video.facebook.com. Przegląd Video API firmy Meta oznacza ten host jako przestarzały do przesyłania wideo i prosi o graph.facebook.com.
- Ogłaszanie wideo przed gotowością. Sprawdzaj status, aż video_status przyjmie wartość ready, bo przetwarzanie trwa także po tym, jak wywołanie publikacji zwróci odpowiedź.
- Wysyłanie linku razem z wideo. publish_facebook_post odrzuca link obok pliku; zamiast tego wpisz adres URL do wiadomości.
Twoja platforma może to samo zrobić przez POST /channels/:id/posts w Partner API. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, im więcej połączeń, tym taniej, z pierwszymi 3 dniami bezpłatnie.
Najczęściej zadawane pytania
Czy mogę przesłać wideo z komputera na Stronę na Facebooku przez API?
Tak, przez Resumable Upload API Meta, które zwraca uchwyt dla /{page-id}/videos, albo przez przesyłanie fragmentami na tej krawędzi. publish_facebook_post przyjmuje zamiast tego publiczny adres URL HTTPS, więc najpierw umieść plik na hostingu.
Czy wideo można przesłać tak, by nie pojawiło się w aktualnościach Strony?
Tak. published ustawione na false wstrzymuje post, no_story pomija historię w aktualnościach i osi czasu, a secret trzyma wideo poza Facebookiem i wyszukiwarką.
Czy jedno wideo można opublikować na kilku Stronach?
Tak, przez crossposting: opublikowane wideo może trafić na inne Strony, którymi osoba administruje, bez ponownego przesyłania, i otrzymuje własny identyfikator wideo na każdej Stronie.
Ile kosztuje easyCoexistence dla Strony na Facebooku?
Od US$ 9 do US$ 0,75 za połączenie miesięcznie, zależnie od łącznej liczby połączeń, z pierwszymi 3 dniami bezpłatnie. Każda Strona to jedno połączenie.
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