Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

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.

389

Kod błędu, gdy Meta nie może pobrać pliku wideo spod adresu podanego w file_url.

382

Kod błędu dla pliku wideo za małego do przesłania; Meta prosi o większy plik.

10 min to 6 months

Okno dla scheduled_publish_time na krawędzi videos, liczone od momentu opublikowania wideo.

0 to 100

Zakres processing_progress, czyli udziału zakończonego przetwarzania wideo, podawany obok video_status.

graph.facebook.com

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.

h

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_urlUploaded file
Where the video isAt a URL Meta can reachOn your own system
On /{page-id}/videosfile_urlfbuploader_video_file_chunk with the upload's handle
Before publishingNothing: Meta fetches the fileAn upload session, then the bytes
If it failsError 389 when Meta cannot fetch itResume 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_phase start, transfer i finish, z start_offset, file_size i video_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.
Z EasyCoexistence zrobisz to

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