Facebook Reels API: Pag-publish ng Reels sa isang Page
Ang Facebook Reels API ay nagpa-publish ng Reel sa Page sa tatlong hakbang: ang POST /{page-id}/video_reels na may upload_phase na start ay nagbabalik ng video_id, ipinapadala ang video sa rupload.facebook.com, at ang POST /{page-id}/video_reels na may upload_phase na finish at video_state na PUBLISHED ay nagpo-post nito. Ang specification ng Meta ay 9:16 na video na 3 hanggang 90 segundo, at maaaring mag-publish ang isang Page ng 30 Reel sa pamamagitan ng API sa loob ng 24 na oras.
Nagpo-post ang easyCoexistence ng video sa isang Facebook Page bilang regular na video post gamit ang publish_facebook_post, mula sa Claude, ChatGPT o sarili mong code, kasama ng text, link at larawan.
Mga Reel na na-publish sa API kada Page sa loob ng 24 na oras na moving period, ipinatutupad sa POST /{page_id}/video_reels.
Haba ng Reel na tinatanggap ng Meta; ang Reel na ini-publish bilang story sa Page ay hindi maaaring lumampas sa 60 segundo.
Pinakamababang resolution ng Reel; inirerekomenda ng Meta ang 1080 x 1920 pixels sa 9 x 16 aspect ratio.
Pinakamalayong scheduled_publish_time na maitatakda sa Reel, hindi bababa sa 10 minuto mula ngayon, na may video_state SCHEDULED.
Error code para sa Reel na hindi suportado ang haba ng Facebook; dapat 3 hanggang 90 segundo ang Reels.
Paano nagpa-publish ng Reel ang Reels API?
Sa tatlong hakbang sa dalawang host. Ang start at finish call ay napupunta sa video_reels edge ng Page sa graph.facebook.com, habang ang mismong video ay napupunta sa rupload.facebook.com, sa upload_url na ibinabalik ng start call. Ang status check sa video ID, sa pagitan ng upload at finish, ay nagpapakita kung nakuha na ng Meta ang buong file at naproseso na ito.
Anong video ang kailangan ng Reel?
Inilalathala ng Meta ang kanilang Reels specifications sa Reels Publishing guide. Ang upload na hindi tumutugon sa aspect ratio, resolution, duration o frame rate ay tinatanggihan na may sariling error code. Ang Reel na para sa Page story ay dapat ding manatili sa loob ng 60 segundo.
Paano ina-upload ang video?
Sa pamamagitan ng POST sa upload_url sa rupload.facebook.com, na may dalang Page token sa header na Authorization: OAuth. Ang file na nasa iyong makina ay ipinapadala bilang request body, na may offset header na nakatakda sa 0 at file_size na nakatakda sa laki nito sa bytes. Ang file na nasa online na ay ipinapadala bilang file_url header; kukunin ito ng Meta, at ang matagumpay na upload ay nagbabalik ng success na true.
- Ang
file_urlay tumatanggap ng http o https na address; hindi suportado ang mga URL na nangangailangan ng authentication. - Dapat payagan ng host ang user agent na facebookexternalhit/1.1 na kunin ang file, dahil tinatanggihan ng Meta ang mga file sa site na hinaharangan ito sa robots.txt.
- Tinatanggihan ang mga file sa sariling CDN ng Meta, tulad ng fbcdn URL; itinuturo ng Meta ang crossposting para magamit muli ang video sa ibang Page.
# <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"Paano i-check ang status ng Reel?
Sa pamamagitan ng GET /{video-id}?fields=status sa graph.facebook.com. Ang sagot ay naglalaman ng video_status, na may halagang uploading, upload_complete, processing, ready, upload_failed, expired o error, at isang object para sa bawat phase: uploading_phase na may bytes_transfered, processing_phase na may anumang mensahe ng error, at publishing_phase na may publish_status (draft, scheduled, published o error) at publish_time. Ang sariling status ng bawat phase ay not_started, in_progress, completed o error.
Paano ipinagpapatuloy ang upload na naantala?
Sa pamamagitan ng pag-send muli ng upload POST na may offset header na nakatakda sa uploading_phase.bytes_transfered mula sa status check, ang mga bytes na mayroon na ang Meta. Ang offset na hindi tinatanggap ng Meta ay nagbabalik ng OffsetInvalidError, ang body na hindi tugma sa haba ng file ay nagbabalik ng PartialRequestError, at kapag hindi gumana ang muling pag-upload, ang payo ng Meta ay magsimula muli mula sa unang hakbang.
Ano ang kinukuha ng finish call?
Kinukuha nito ang video_id mula sa start call, na may upload_phase na finish at video_state na PUBLISHED, DRAFT o SCHEDULED. Ang description ang nagdadala ng text at sumusuporta sa hashtags. Opsyonal ang title, place para sa location Page, at is_ai_generated, na nagsasabing ginawa o na-edit gamit ang AI ang Reel. Para sa naka-schedule na Reel, idinaragdag ang scheduled_publish_time, isang UNIX timestamp na higit sa 10 minuto at hanggang 29 na araw ang layo. Sumasagot ang Meta ng success na true.
Ilang Reel ang maaaring i-publish ng isang Page sa pamamagitan ng API?
30 sa loob ng 24 na oras na moving period. Ipinatutupad ng Meta ang limit sa POST /{page_id}/video_reels kapag may nai-publish na Reel, at inirerekomenda nitong ipatupad din ito ng mga app, lalo na ang mga app na nagpapahintulot sa mga tao na mag-schedule ng post para sa susunod na panahon. May sariling limit ang collaborator invitations, 10 kada Page kada 24 na oras, at nakalista sa video_reels reference ang error 613, na nagsasabing lumampas na sa rate limit ang mga call sa API na ito.
Anong permission at Page task ang kailangan nito?
Page access token mula sa taong may kakayahang gawin ang CREATE_CONTENT task sa Page, na may pages_show_list, pages_read_engagement at pages_manage_posts na ibinigay sa pamamagitan ng Facebook Login. Hinihiling din ng Meta sa mga app na ipakita sa tao ang disclosure kung paano ginagamit ang kanilang Reels sa Facebook, kasama ang mga opsyon para kontrolin ito, at mag-alok lamang ng Public audience, dahil ang pag-publish sa Page ay may implicit na public scope.
Anong mga error ang ibinabalik ng Reels API?
Ang code 100 ay nangangahulugang kulang ang kinakailangang parameter, gaya ng upload_phase, at nakalista sa mensahe ng Meta ang mga kulang. Apat pang code ang tumatanggi sa video na lampas sa specifications:
- 1363040: hindi suportado ang aspect ratio; dapat nasa pagitan ng 16x9 at 9x16 ang mga video.
- 1363127: hindi suportado ang resolution; ang pinakamababa ay 540 x 960 pixels.
- 1363128: hindi suportado ang haba; 3 hanggang 90 segundo ang Reels.
- 1363129: hindi suportado ang average frame rate; kailangan ng Reels ang 24 hanggang 60 frames per second.
Paano i-list ang mga Reel ng isang Page?
Sa pamamagitan ng GET /{page-id}/video_reels, na nagbabalik ng mga nai-publish na Reel ng Page kasama ang kanilang ID, update time at description. Pinipili ng since at until ang listahan ayon sa petsang nakasulat bilang today, yesterday, UNIX timestamp o yyyy-mm-dd, at dapat mas huli ang until kaysa sa since. Tinuturo ng feed reference ng Meta ang edge na ito para sa mga Reel na nai-publish sa Page.
Paano mag-publish ng Reel sa pamamagitan ng easyCoexistence?
Hindi bilang Reel, sa ngayon. Ipinapadala ng publish_facebook_post ang mga video sa videos edge ng Page, bilang regular na video post, at walang tool ang easyCoexistence para sa video_reels calls; hindi ibinibigay ang mga Page token, kaya hindi rin tumatakbo ang tatlong hakbang mula sa sarili mong code sa koneksyon nito. I-publish ang Reel mula sa Facebook o Meta Business Suite, o i-post ang video bilang regular na video post.
Mga karaniwang pagkakamali
- Pagpapadala ng upload sa graph.facebook.com. Napupunta ang video sa rupload.facebook.com na may header na Authorization: OAuth; ang start, finish at status call lamang ang gumagamit ng graph.facebook.com.
- Pag-host ng file sa lugar na hindi makuha ng Meta. Tinatanggihan ang file_url na nasa likod ng login, sa site na hinaharangan ng robots.txt ang facebookexternalhit/1.1, o nasa fbcdn.
- Pagsisimula muli pagkatapos ng na-interrupt na upload. Basahin muna ang status: ang uploading_phase.bytes_transfered ang offset na ipagpapatuloy, at ang bagong session ang huling opsyon.
- Pagpila ng higit sa 30 Reel para sa isang Page sa isang araw. Binibilang ng Meta ang mga Reel na nai-publish sa API sa 24 na oras na moving period, kaya ikalat ang mga naka-schedule.
Walang tool ito para sa Reels API, kaya ang Reel ay pina-publish mula sa Facebook o Meta Business Suite. Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, na may free trial na unang 3 araw.
Mga madalas itanong
Maaari bang i-publish ang Reel sa Facebook profile o group sa pamamagitan ng API?
Hindi. Ang Reels Publishing API ng Meta ay nagpa-publish ng Reel sa mga Facebook Page lamang, at ang crossposting nito ay sa mga Page lamang.
Nagpa-publish ba ng Reel ang publish_facebook_post?
Hindi. Nagpo-post ito ng text, link, larawan at video sa Page. Ang Reel ay gumagamit ng video_reels calls, na hindi ginagawa ng mga tool ng easyCoexistence.
Paano ko tatingnan ang Reel para sa copyright match?
Basahin ang GET /{video-id}?fields=copyright_check_information gamit ang pages_read_engagement. Isinasagawa ng Meta ang check sa upload, maaaring abutin ng ilang minuto, at ang may-ari lamang ang nakakakita ng mga match.
Maaari bang i-publish din ng ibang Page ang Reel ko?
Oo, bilang collaborator. Ang POST /{video-id}/collaborators na may target_id na nakatakda sa ID ng kanilang Page ay nagpapadala ng imbitasyon, at kapag tinanggap nila ito, lalabas din ang Reel sa kanilang Page.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong