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

Facebook Reels API: publicarea Reel-urilor pe o pagină

Facebook Reels API publică un Reel pe o pagină în trei pași: POST /{page-id}/video_reels cu upload_phase start returnează un video_id, videoclipul se trimite la rupload.facebook.com, iar POST /{page-id}/video_reels cu upload_phase finish și video_state PUBLISHED îl postează. Specificația Meta cere un video 9:16 de 3 până la 90 de secunde, iar o pagină poate publica prin API 30 de Reel-uri în 24 de ore.

easyCoexistence postează videoclipuri pe o pagină de Facebook ca postări video obișnuite cu publish_facebook_post, din Claude, ChatGPT sau din propriul cod, alături de text, linkuri și fotografii.

30 a day

Reel-uri publicate prin API pe pagină într-o perioadă glisantă de 24 de ore, aplicată la POST /{page_id}/video_reels.

3 to 90 s

Durata Reel-urilor acceptată de Meta; un Reel publicat ca poveste pe o pagină nu poate depăși 60 de secunde.

540 x 960

Rezoluția minimă a Reel-ului; Meta recomandă 1080 x 1920 pixeli la un raport de aspect de 9 x 16.

29 days

Cel mai îndepărtat scheduled_publish_time pe care îl poate seta un Reel, de cel puțin 10 minute, cu video_state SCHEDULED.

1363128

Codul de eroare pentru un Reel a cărui durată Facebook nu o acceptă; Reel-urile trebuie să dureze între 3 și 90 de secunde.

Cum publică Facebook Reels API un Reel?

În trei pași, pe două gazde. Apelurile de start și finalizare merg la endpoint-ul video_reels al paginii de pe graph.facebook.com, în timp ce videoclipul propriu-zis merge la rupload.facebook.com, la upload_url returnat de apelul de start. O verificare a stării pe ID-ul videoclipului, între încărcare și finalizare, arată dacă Meta are fișierul complet și dacă l-a procesat.

1StartPOST /{page-id}/video_reels, upload_phase start: returns video_id and upload_url
2UploadPOST to rupload.facebook.com with the bytes or a file_url header
3CheckGET /{video-id}?fields=status until processing completes
4FinishPOST /{page-id}/video_reels, upload_phase finish, video_state PUBLISHED

Ce videoclip are nevoie un Reel?

Meta își publică specificațiile Reel-urilor în ghidul Reels Publishing, iar o încărcare care nu respectă raportul de aspect, rezoluția, durata sau rata de cadre este refuzată cu un cod de eroare propriu. Un Reel destinat unei povești pe pagină trebuie, de asemenea, să se încadreze în 60 de secunde.

File.mp4 recommended
Aspect ratio9 x 16
Resolution1080 x 1920 recommended, 540 x 960 at least
Frame rate24 to 60 fps, fixed, progressive scan
Duration3 to 90 seconds
VideoH.264 or H.265 (VP9 and AV1 also supported), 4:2:0, closed GOP of 2 to 5 s
AudioAAC Low Complexity, 48 kHz, stereo, 128 kbps or more

Cum se încarcă videoclipul?

Printr-un POST către upload_url de pe rupload.facebook.com, care trimite token-ul paginii în antetul Authorization: OAuth. Un fișier de pe calculator merge ca corpul cererii, cu antetul offset setat la 0 și file_size setat la dimensiunea lui în octeți. Un fișier deja online merge ca antetul file_url, iar Meta îl preia singură; o încărcare reușită returnează success cu valoarea true.

  • file_url acceptă adrese http sau https; adresele care cer autentificare nu sunt acceptate.
  • Gazda trebuie să permită agentului utilizator facebookexternalhit/1.1 să preia fișierul, deoarece Meta respinge fișierele de pe site-urile care îl blochează în robots.txt.
  • Fișierele de pe CDN-ul propriu al Meta, precum adresele fbcdn, sunt respinse; Meta indică spre crossposting pentru a refolosi un videoclip pe o altă pagină.
Uploading a hosted video
# <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"

Cum se verifică starea unui Reel?

Cu GET /{video-id}?fields=status pe graph.facebook.com. Răspunsul conține video_status, care poate fi uploading, upload_complete, processing, ready, upload_failed, expired sau error, și câte un obiect pentru fiecare fază: uploading_phase cu bytes_transfered, processing_phase cu eventualul mesaj de eroare și publishing_phase cu publish_status (draft, scheduled, published sau error) și publish_time. Starea fiecărei faze este not_started, in_progress, completed sau error.

Cum se reia o încărcare întreruptă?

Trimițând din nou POST-ul de încărcare, cu antetul offset setat la uploading_phase.bytes_transfered dintr-o verificare de stare, adică octeții pe care Meta îi are deja. Un offset neacceptat de Meta returnează OffsetInvalidError, un corp care nu corespunde lungimii fișierului returnează PartialRequestError, iar dacă o nouă încărcare nu funcționează, Meta recomandă să se înceapă din nou de la primul pas.

Ce primește apelul de finalizare?

video_id din apelul de start, upload_phase setat la finish și video_state setat la PUBLISHED, DRAFT sau SCHEDULED. description conține textul și acceptă hashtag-uri. title, place pentru o pagină cu locație și is_ai_generated, care anunță că Reel-ul a fost creat sau editat cu AI, sunt opționale. Un Reel programat adaugă scheduled_publish_time, un marcaj de timp UNIX cu mai mult de 10 minute și cel mult 29 de zile în viitor. Meta răspunde cu success setat la true.

Câte Reel-uri poate publica o pagină prin API?

30 într-o perioadă glisantă de 24 de ore. Meta aplică limita la POST /{page_id}/video_reels când un Reel este publicat și recomandă ca aplicațiile să o aplice și ele, mai ales cele care lasă oamenii să programeze postările. Invitațiile de colaborare au o limită proprie, de 10 pe pagină la 24 de ore, iar referința video_reels listează eroarea 613, apelurile către acest API au depășit limita de rată.

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

Un token de acces al paginii, de la cineva care poate îndeplini sarcina CREATE_CONTENT pe pagină, cu pages_show_list, pages_read_engagement și pages_manage_posts acordate prin Facebook Login. Meta cere, de asemenea, aplicațiilor să îi arate persoanei o notificare despre modul în care îi sunt folosite Reel-urile pe Facebook, cu opțiuni de control, și să ofere doar audiența Public, deoarece publicarea pe o pagină are implicit un domeniu public.

Ce erori returnează Reels API?

Codul 100 înseamnă că lipsește un parametru obligatoriu, precum upload_phase, iar mesajul Meta enumeră parametrii lipsă. Alte patru coduri resping un videoclip care nu respectă specificațiile:

  • 1363040: raportul de aspect nu este acceptat; videoclipurile trebuie să fie între 16x9 și 9x16.
  • 1363127: rezoluția nu este acceptată; minimul este de 540 x 960 pixeli.
  • 1363128: durata nu este acceptată; Reel-urile durează între 3 și 90 de secunde.
  • 1363129: rata medie de cadre nu este acceptată; Reel-urile necesită între 24 și 60 de cadre pe secundă.

Cum se listează Reel-urile unei pagini?

Cu GET /{page-id}/video_reels, care returnează Reel-urile publicate ale paginii, cu ID-urile, datele ultimei actualizări și descrierile lor. since și until restrâng lista la date exprimate ca today, yesterday, un marcaj de timp UNIX sau yyyy-mm-dd, cu until ulterior lui since. Referința Meta pentru feed indică acest endpoint pentru Reel-urile publicate pe o pagină.

Cum se publică un Reel prin easyCoexistence?

Nu ca Reel, în prezent. publish_facebook_post trimite videoclipurile către endpoint-ul videos al paginii, ca postări video obișnuite, iar easyCoexistence nu are un instrument pentru apelurile video_reels; token-urile paginii nu sunt oferite, așa că cei trei pași nu pot fi rulați nici din propriul cod pe conexiunea sa. Publicați Reel-ul de pe Facebook sau din Meta Business Suite, ori postați videoclipul ca postare video obișnuită.

Greșeli frecvente

  • Trimiterea încărcării către graph.facebook.com. Videoclipul merge la rupload.facebook.com cu antetul Authorization: OAuth; doar apelurile de start, finalizare și verificare a stării folosesc graph.facebook.com.
  • Găzduirea fișierului unde Meta nu îl poate prelua. Un file_url din spatele unei autentificări, pe un site al cărui robots.txt blochează facebookexternalhit/1.1, sau pe fbcdn, este respins.
  • Începerea de la capăt după o încărcare întreruptă. Verificați mai întâi starea: uploading_phase.bytes_transfered este offsetul de la care se reia, iar o sesiune nouă este ultima soluție.
  • Punerea în coadă a peste 30 de Reel-uri pentru o pagină într-o zi. Meta numără Reel-urile publicate prin API pe o perioadă glisantă de 24 de ore, așa că distribuiți cele programate.
Faceți acest lucru cu EasyCoexistence

Nu are un instrument pentru Reels API, așa că un Reel se publică de pe Facebook sau din Meta Business Suite. De la US$ 9 la US$ 0.75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu perioadă de probă gratuită de 3 zile.

Întrebări frecvente

Poate fi publicat un Reel pe un profil sau grup Facebook prin API?

Nu. API-ul de publicare Reels al Meta publică Reel-uri doar pe paginile Facebook și le face crossposting doar către alte pagini.

Publică publish_facebook_post Reel-uri?

Nu. Trimite text, linkuri, fotografii și videoclipuri pe pagină. Un Reel folosește apelurile video_reels, pe care instrumentele easyCoexistence nu le fac.

Cum verific un Reel pentru potriviri de drepturi de autor?

Citiți GET /{video-id}?fields=copyright_check_information cu pages_read_engagement. Meta rulează verificarea la încărcare, care poate dura câteva minute, iar potrivirile sunt vizibile doar proprietarului.

Poate o altă pagină să publice și Reel-ul meu?

Da, ca primul colaborator. POST /{video-id}/collaborators cu target_id setat la ID-ul paginii lor trimite o invitație, iar după ce o acceptă, Reel-ul apare și pe pagina lor.

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