Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Publicarea videoclipurilor pe o pagină Facebook prin API

Un videoclip ajunge pe o pagină Facebook prin POST /{page-id}/videos, fie cu file_url, un URL pe care Meta îl descarcă singură, fie cu un fișier pe care aplicația îl încarcă mai întâi la Meta. title denumește videoclipul, iar description este textul pe care Meta îl poate afișa împreună cu postarea. Apoi Meta procesează fișierul, iar GET /{video-id}?fields=status arată video_status ca processing până când devine ready.

easyCoexistence postează videoclipuri pe paginile Facebook cu publish_facebook_post, din Claude, ChatGPT sau din propriul cod, imediat sau programat cu până la 90 de zile înainte.

389

Cod de eroare când Meta nu poate prelua fișierul videoclipului de la URL-ul dat în file_url.

382

Cod de eroare pentru un fișier video prea mic pentru a fi încărcat; Meta cere un fișier mai mare.

10 min to 6 months

Fereastra pentru scheduled_publish_time pe edge-ul videos, numărată de la momentul în care videoclipul este publicat.

0 to 100

Intervalul pentru processing_progress, procentul din procesarea videoclipului realizat, raportat alături de video_status.

graph.facebook.com

Gazda pentru încărcarea videoclipurilor, conform prezentării Meta despre Video API, care marchează graph-video.facebook.com ca depreciată pentru acest scop.

h

Identificatorul fișierului returnat de o încărcare, transmis către /{page-id}/videos ca fbuploader_video_file_chunk pentru a publica videoclipul.

Cum se postează un videoclip pe o pagină?

Cu POST /{page-id}/videos și un token de acces al paginii. Fișierul ajunge la Meta în unul din două moduri: file_url, un URL accesibil al videoclipului pe care Meta îl preia singură, sau o încărcare, unde aplicația trimite mai întâi octeții. file_url nu poate fi combinat cu upload_phase, parametrul încărcării în bucăți, deci o cerere folosește un mod sau celălalt.

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

Cum funcționează încărcarea pentru un fișier care nu este online?

Ghidul Meta de publicare a videoclipurilor folosește Resumable Upload API. POST /{app-id}/uploads cu file_name, file_length și file_type deschide o sesiune, iar POST /upload:{session-id} cu antetul file_offset și octeții returnează un identificator, h. Videoclipul este apoi publicat cu POST /{page-id}/videos și fbuploader_video_file_chunk setat la acel identificator, alături de title și description. Aceste apeluri de încărcare folosesc un token de acces al utilizatorului.

  • O încărcare întreruptă reia de la file_offset returnat de GET /upload:{session-id}.
  • Referința videos documentează și o încărcare în bucăți pe același edge: upload_phase start, transfer și finish, cu start_offset, file_size și video_file_chunk.

Ce fac title și description?

title este titlul videoclipului. description este, în cuvintele Meta, textul care descrie o postare și care poate fi afișat într-o poveste despre aceasta, deci aici ajung cuvintele postării. Ambele sunt opționale pe edge-ul videos, iar publish_facebook_post trimite mesajul său ca description și lasă title nesetat.

Cum se știe când videoclipul este gata?

Meta procesează un videoclip după ce ajunge. GET /{video-id}?fields=status returnează video_status, care arată processing cât timp Meta lucrează, ready după ce videoclipul este încărcat, codat și are miniaturile, sau error dacă procesarea a eșuat, cu processing_progress care dă procentul realizat de la 0 la 100. Meta poate raporta și starea publicării prin webhook-urile paginii pe câmpul videos, la care easyCoexistence nu se abonează.

Cât de mare și cât de lung poate fi videoclipul?

Referința Page videos și ghidul Meta de publicare a videoclipurilor nu indică nicio dimensiune maximă a fișierului sau o durată maximă; regula de dimensiune pe care o numesc este eroarea 382, pentru un fișier prea mic pentru a fi încărcat. Ghidurile Meta pentru Reels și Stories stabilesc durate proprii: între 3 și 90 de secunde pentru un Reel și cel mult 60 pentru un videoclip de tip story. Când easyCoexistence programează un videoclip, copiază fișierul în acel moment și refuză unul mai mare de 1 GB.

Ce permisiuni și ce sarcină de pagină sunt necesare?

pages_manage_posts, pages_read_engagement și pages_show_list, cu un token de acces al paginii de la cineva care poate îndeplini sarcina CREATE_CONTENT, conform referinței videos și ghidului de publicare. Prezentarea Meta a Video API formulează mai strict: persoana ar trebui să poată îndeplini sarcini echivalente celor de administrator pe pagină sau să dețină un rol de Admin acordat prin Business Manager.

Ce erori poate returna postarea unui videoclip?

Referința videos a Meta listează acestea pentru POST /{page-id}/videos:

  • 389: nu se poate prelua fișierul videoclipului de la URL.
  • 382: fișierul videoclipului este prea mic; încercați din nou cu un fișier mai mare.
  • 6000: o problemă la încărcarea fișierului videoclipului; încercați din nou cu alt fișier.
  • 6001: o problemă la încărcarea videoclipului; încercați din nou.
  • 368: acțiunea a fost considerată abuzivă sau este interzisă în alt mod.
  • 100: parametru invalid; 200: eroare de permisiuni; 190: token de acces OAuth 2.0 invalid.

Cum postează publish_facebook_post un videoclip?

Primește video_url, un link HTTPS public către fișier, și message, și le trimite către /{page-id}/videos ca file_url și description, astfel că Meta preia singură videoclipul. O postare conține un singur videoclip, iar un link trimis alături este refuzat, deci puneți URL-ul în mesaj. Rezultatul, post_id, conține identificatorul returnat de Meta, care pentru un videoclip este chiar identificatorul videoclipului.

Cum se programează o postare cu videoclip?

Dați lui publish_facebook_post un scheduled_at în ISO 8601 cu fus orar, de la 1 minut la 90 de zile înainte. easyCoexistence copiază videoclipul în momentul programării și îl publică pe pagină la acel moment; list_scheduled_posts îl arată, update_scheduled_post îl mută sau îi schimbă textul, iar cancel_scheduled_post îl oprește. scheduled_publish_time propriu al Meta, de pe edge-ul videos, permite de la 10 minute la 6 luni.

Greșeli frecvente

  • Trimiterea lui file_url către o pagină care redă videoclipul, nu către fișier. Meta descarcă singură adresa, iar una pe care nu o poate prelua eșuează cu eroarea 389.
  • Încărcarea pe graph-video.facebook.com. Prezentarea Meta a Video API marchează acest host ca depreciat pentru încărcarea videoclipurilor și cere graph.facebook.com.
  • Anunțarea videoclipului înainte ca acesta să fie gata. Verificați starea până când video_status arată ready, deoarece procesarea continuă după ce apelul de publicare revine.
  • Trimiterea unui link împreună cu videoclipul. publish_facebook_post refuză un link alături de un fișier; scrieți URL-ul în mesaj.
Faceți acest lucru cu EasyCoexistence

Platforma dumneavoastră poate face același lucru cu POST /channels/:id/posts din Partner API. De la US$ 9 până la US$ 0,75 per conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.

Întrebări frecvente

Pot încărca un videoclip de pe calculator pe o pagină Facebook prin API?

Da, prin Resumable Upload API al Meta, care returnează un identificator pentru /{page-id}/videos, sau prin încărcarea în bucăți de pe același edge. publish_facebook_post primește în schimb un URL HTTPS public, deci fișierul trebuie găzduit mai întâi.

Poate fi încărcat un videoclip fără să apară în fluxul paginii?

Da. published setat la false reține postarea, no_story suprimă povestea din flux și din cronologie, iar secret ține videoclipul departe de Facebook și de căutare.

Poate un videoclip să fie postat pe mai multe pagini?

Da, prin crosspostare: un videoclip publicat poate fi trimis pe alte pagini administrate de persoana respectivă fără a fi încărcat din nou, iar pe fiecare pagină primește propriul identificator de videoclip.

Cât costă easyCoexistence pentru o pagină Facebook?

De la US$ 9 până la US$ 0,75 per conexiune pe lună, stabilit după numărul total de conexiuni, cu primele 3 zile gratuite. Fiecare pagină reprezintă o conexiune.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la