Facebook Reels API: objavljivanje Reel-ova na stranicu
Facebook Reels API objavljuje Reel na stranicu u tri koraka: POST /{page-id}/video_reels sa upload_phase start vraća video_id, video se šalje na rupload.facebook.com, a POST /{page-id}/video_reels sa upload_phase finish i video_state PUBLISHED objavljuje ga. Meta-ova specifikacija je video 9:16 dužine od 3 do 90 sekundi, a stranica može kroz API da objavi 30 Reel-ova u 24 sata.
easyCoexistence objavljuje video na Facebook stranicu kao obične video objave pomoću publish_facebook_post, iz Claude-a, ChatGPT-a ili vašeg koda, uz tekst, linkove i fotografije.
Reel-ovi objavljeni kroz API po stranici u pokretnom periodu od 24 sata, sprovedeno na POST /{page_id}/video_reels.
Trajanje Reel-a koje Meta prihvata; Reel objavljen kao priča na stranici ne može biti duži od 60 sekundi.
Minimalna rezolucija Reel-a; Meta preporučuje 1080 x 1920 piksela pri odnosu stranica 9 x 16.
Najdalje unapred koje scheduled_publish_time može postaviti za Reel, uz najmanje 10 minuta unapred, sa video_state SCHEDULED.
Kod greške za Reel čije trajanje Facebook ne podržava; Reel-ovi moraju trajati od 3 do 90 sekundi.
Kako Reels API objavljuje Reel?
U tri koraka na dva hosta. Pozivi start i finish idu na video_reels edge stranice na graph.facebook.com, dok sam video ide na rupload.facebook.com, na upload_url koji vraća poziv start. Provera statusa ID-ja videa između upload-a i finish-a pokazuje da li je Meta dobila ceo fajl i da li ga je obradila.
Kakav video Reel treba?
Meta objavljuje specifikacije za Reel-ove u vodiču Reels Publishing, a upload koji ne ispuni uslove za odnos stranica, rezoluciju, trajanje ili broj sličica u sekundi biva odbijen sa sopstvenim kodom greške. Reel namenjen priči na stranici mora da ostane u okviru 60 sekundi.
Kako se video otprema?
POST zahtevom na upload_url na rupload.facebook.com, uz token stranice u zaglavlju Authorization: OAuth. Fajl na vašem računaru ide kao telo zahteva, sa zaglavljem offset postavljenim na 0 i file_size postavljenim na veličinu u bajtovima. Fajl koji je već na internetu ide umesto toga kao zaglavlje file_url, a Meta ga sama preuzima; uspešan upload vraća success postavljen na true.
file_urlprihvata http i https adrese; URL-ovi koji traže autentifikaciju nisu podržani.- Host mora dozvoliti korisničkom agentu facebookexternalhit/1.1 da preuzme fajl, jer Meta odbija fajlove sa sajtova koji to blokiraju u robots.txt.
- Fajlovi na Meta-inom sopstvenom CDN-u, poput fbcdn URL-ova, se odbijaju; Meta preporučuje crossposting za ponovnu upotrebu videa na drugoj stranici.
# <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"Kako se proverava status Reel-a?
GET zahtevom na /{video-id}?fields=status na graph.facebook.com. Odgovor sadrži video_status, koji glasi uploading, upload_complete, processing, ready, upload_failed, expired ili error, i po jedan objekat za svaku fazu: uploading_phase sa bytes_transfered, processing_phase sa eventualnom porukom o grešci i publishing_phase sa publish_status (draft, scheduled, published ili error) i publish_time. Sopstveni status svake faze je not_started, in_progress, completed ili error.
Kako se prekinuti upload nastavlja?
Ponovnim slanjem upload POST-a sa zaglavljem offset postavljenim na uploading_phase.bytes_transfered iz provere statusa, odnosno na bajtove koje Meta već ima. Offset koji Meta ne prihvata vraća OffsetInvalidError, telo koje se ne poklapa sa dužinom fajla vraća PartialRequestError, a kada ponovni upload ne uspe, Metin savet je da se krene ispočetka od prvog koraka.
Šta uzima poziv finish?
video_id iz poziva start, upload_phase postavljen na finish i video_state postavljen na PUBLISHED, DRAFT ili SCHEDULED. description nosi tekst i podržava heštege. title, place za stranicu sa lokacijom i is_ai_generated, koje označava da je Reel napravljen ili izmenjen uz pomoć AI, su opcioni. Zakazan Reel dodaje scheduled_publish_time, UNIX vremenski žig koji je više od 10 minuta i najviše 29 dana unapred. Meta odgovara sa success postavljen na true.
Koliko Reel-ova stranica može da objavi kroz API?
30 u pokretnom periodu od 24 sata. Meta sprovodi limit na POST /{page_id}/video_reels kada se Reel objavi i preporučuje da ga aplikacije same sprovode, naročito one koje dozvoljavaju zakazivanje objava. Pozivnice saradnika imaju sopstveni limit, 10 po stranici u 24 sata, a referenca za video_reels navodi grešku 613, pozivi ovom API-ju su premašili ograničenje učestalosti.
Koje dozvole i zadatak stranice su potrebni?
Token pristupa stranici od nekoga ko može da izvrši zadatak CREATE_CONTENT na stranici, uz dozvole pages_show_list, pages_read_engagement i pages_manage_posts odobrene kroz Facebook Login. Meta takođe traži da aplikacije prikažu osobi obaveštenje o tome kako se njeni Reel-ovi koriste na Facebooku, sa opcijama za kontrolu, i da ponude samo javnu publiku (Public), jer objavljivanje na stranicu ima podrazumevani javni obim.
Koje greške vraća Reels API?
Kod 100 znači da nedostaje obavezan parametar, na primer upload_phase, a Metina poruka navodi koji nedostaju. Još četiri koda odbijaju video koji ne ispunjava specifikacije:
- 1363040: odnos stranica nije podržan; video mora biti između 16x9 i 9x16.
- 1363127: rezolucija nije podržana; minimum je 540 x 960 piksela.
- 1363128: trajanje nije podržano; Reel-ovi traju od 3 do 90 sekundi.
- 1363129: prosečan broj sličica u sekundi nije podržan; Reel-ovima treba od 24 do 60 sličica u sekundi.
Kako se listaju Reel-ovi stranice?
GET zahtevom na /{page-id}/video_reels, koji vraća objavljene Reel-ove stranice sa njihovim ID-jevima, vremenima ažuriranja i opisima. since i until sužavaju listu na datume zadate kao today, yesterday, UNIX vremenski žig ili yyyy-mm-dd, pri čemu until mora biti kasnije od since. Metina referenca za feed upućuje na ovaj edge za Reel-ove objavljene na stranicu.
Kako se Reel objavljuje preko easyCoexistence?
Ne kao Reel, za sada. publish_facebook_post šalje video na edge videos stranice, kao obične video objave, a easyCoexistence nema alat za pozive video_reels; tokeni stranica se ne izdaju, pa se ta tri koraka ne mogu izvršiti ni iz vašeg koda na njegovoj vezi. Reel objavite sa Facebook-a ili Meta Business Suite, ili video objavite kao običnu video objavu.
Česte greške
- Slanje uploada na graph.facebook.com. Video ide na rupload.facebook.com sa zaglavljem Authorization: OAuth; samo pozivi start, finish i status koriste graph.facebook.com.
- Smeštanje fajla tamo gde ga Meta ne može preuzeti. file_url iza prijave, na sajtu čiji robots.txt blokira facebookexternalhit/1.1 ili na fbcdn bude odbijen.
- Krenuti ispočetka posle prekinutog upload-a. Prvo pročitajte status: uploading_phase.bytes_transfered je offset od kog se nastavlja, a nova sesija je poslednje rešenje.
- Zakazivanje više od 30 Reel-ova za jednu stranicu u danu. Meta broji Reel-ove objavljene kroz API u pokretnom periodu od 24 sata, pa zakazane objave raspoređujte.
Nema alat za Reels API, pa se Reel objavljuje sa Facebook-a ili Meta Business Suite. Od US$ 9 do US$ 0,75 po vezi mesečno, a cena pada kako dodajete veze, uz besplatni probni period od 3 dana.
Često postavljana pitanja
Može li se Reel objaviti na Facebook profilu ili grupi kroz API?
Ne. Metin Reels Publishing API objavljuje Reel-ove na Facebook stranice, a crossposting ih šalje samo na stranice.
Da li publish_facebook_post objavljuje Reel-ove?
Ne. Objavljuje tekst, linkove, fotografije i video na stranicu. Reel traži pozive video_reels, koje alati easyCoexistence ne izvršavaju.
Kako se proverava Reel za podudaranja sa autorskim pravima?
Pročitajte GET /{video-id}?fields=copyright_check_information uz pages_read_engagement. Meta proverava pri uploadu, što može da traje nekoliko minuta, a podudaranja vidi samo vlasnik.
Može li i druga stranica da objavi moj Reel?
Da, kao saradnik. POST /{video-id}/collaborators sa target_id postavljenim na ID njihove stranice šalje pozivnicu, a kad je prihvate, Reel se pojavljuje i na njihovoj stranici.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na