התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

Facebook Reels API: פרסום Reels לעמוד

Facebook Reels API מפרסם Reel לעמוד בשלושה שלבים: POST /{page-id}/video_reels עם upload_phase שמוגדר ל-start מחזיר video_id, הוידאו נשלח אל rupload.facebook.com, ו-POST /{page-id}/video_reels עם upload_phase שמוגדר ל-finish ו-video_state שמוגדר ל-PUBLISHED מפרסם אותו. המפרט של Meta הוא וידאו בפרופורציה 9:16 באורך 3 עד 90 שניות, ועמוד יכול לפרסם 30 Reels דרך ה-API ב-24 שעות.

easyCoexistence מפרסם סרטונים בעמוד Facebook כפוסטי וידאו רגילים עם publish_facebook_post, מ-Claude, מ-ChatGPT או מהקוד שלכם, לצד טקסט, קישורים ותמונות.

30 a day

הקריאה POST /{page_id}/video_reels אוכפת מגבלה של Reels שפורסמו דרך ה-API לכל עמוד בתוך 24 שעות נעות.

3 to 90 s

אורך ה-Reel ש-Meta מקבלת; Reel שמפורסם כסטורי בעמוד לא יכול לעלות על 60 שניות.

540 x 960

רזולוציה מינימלית; Meta ממליצה על 1080 x 1920 פיקסלים ביחס תצוגה 9 x 16 אנכי.

29 days

הזמן הרחוק ביותר שאפשר לקבוע ל-Reel דרך scheduled_publish_time עם video_state SCHEDULED, ולפחות 10 דקות קדימה.

1363128

קוד שגיאה ל-Reel שאורכו לא נתמך ב-Facebook; Reels חייבים להיות באורך של 3 עד 90 שניות.

מהם השלבים שבהם ה-Reels API מפרסם?

בשלושה שלבים, על פני שני שרתים. קריאות ה-start וה-finish נשלחות לנקודת הקצה video_reels של העמוד ב-graph.facebook.com, ואילו הוידאו עצמו נשלח אל rupload.facebook.com, אל upload_url שקריאת ה-start מחזירה. בדיקת סטטוס לפי מזהה הוידאו בין ההעלאה לסיום מראה אם Meta קיבלה את הקובץ כולו ועיבדה אותו.

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

אילו מפרטים הוידאו צריך לעמוד בהם?

Meta מפרסמת את מפרטי ה-Reels במדריך Reels Publishing, והעלאה שלא עומדת בהם ביחס תצוגה, ברזולוציה, באורך או בקצב פריימים נדחית עם קוד שגיאה משלה. Reel שמיועד לסטורי של עמוד צריך להישאר גם הוא עד 60 שניות.

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

איך מעלים את הוידאו?

בבקשת POST אל upload_url בכתובת rupload.facebook.com, עם אסימון העמוד בכותרת Authorization: OAuth. קובץ שנמצא אצלכם נשלח כגוף הבקשה, עם הכותרת offset שמוגדרת ל-0 וכותרת file_size עם גודלו בבייטים. קובץ שכבר נמצא ברשת נשלח במקום זאת בכותרת file_url, ו-Meta שולפת אותו בעצמה. העלאה מוצלחת מחזירה success עם הערך true, וזה הסימן להצלחה.

  • file_url מקבל כתובות http או https; כתובות שדורשות אימות אינן נתמכות.
  • השרת חייב לאפשר לסוכן המשתמש facebookexternalhit/1.1 לשלוף את הקובץ, כי Meta דוחה קבצים מאתר שחוסם אותו ב-robots.txt, כלומר בהגדרה של חסימה.
  • קבצים שנמצאים ב-CDN של Meta, כגון כתובות fbcdn, נדחים; Meta מפנה לפרסום צולב (crossposting) כדי לעשות שימוש חוזר בוידאו בעמוד אחר.
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"

איך בודקים את סטטוס הפרסום?

בקריאת GET /{video-id}?fields=status ב-graph.facebook.com. התשובה כוללת את video_status, שמקבל את הערכים uploading, upload_complete, processing, ready, upload_failed, expired או error, ואובייקט לכל שלב: uploading_phase עם bytes_transfered, processing_phase עם הודעת שגיאה אם יש, ו-publishing_phase עם publish_status (draft, scheduled, published או error) ו-publish_time. סטטוס כל שלב עצמו מקבל not_started, in_progress, completed או error, כפי שמופיע בשדה status של כל שלב.

איך ממשיכים העלאה שנקטעה?

על ידי שליחת בקשת ההעלאה שוב, עם הכותרת offset שמוגדרת לערך uploading_phase.bytes_transfered מבדיקת סטטוס, כלומר הבייטים ש-Meta כבר קיבלה. offset שאינו מתקבל על ידי Meta מחזיר OffsetInvalidError, וגוף בקשה שאורכו לא תואם לאורך הקובץ מחזיר PartialRequestError. כשהעלאה נוספת לא עובדת, Meta ממליצה להתחיל מחדש מהשלב הראשון.

מה קריאת הסיום מקבלת?

את video_id מקריאת ה-start, upload_phase שמוגדר ל-finish ו-video_state שמוגדר ל-PUBLISHED, DRAFT או SCHEDULED. description מכיל את הטקסט ותומך בהאשטגים. title ו-place, עבור עמוד עם מיקום, ו-is_ai_generated, שמציין שה-Reel נוצר או נערך בעזרת AI, הם אופציונליים. Reel מתוזמן מוסיף scheduled_publish_time, חותמת זמן UNIX שהיא יותר מ-10 דקות ועד 29 ימים קדימה, ו-Meta משיבה success שערכו אמת.

מה המכסה לפרסום Reels דרך ה-API בעמוד?

עד 30 Reels בתקופה נעה של 24 שעות. Meta אוכפת את המכסה בקריאה ל-POST /{page_id}/video_reels בעת פרסום Reel, וממליצה שאפליקציות יאכפו אותה גם הן, במיוחד אפליקציות שמאפשרות לאנשים לתזמן פוסטים לעתיד. להזמנות שותפים יש מכסה משלהן, 10 לעמוד ב-24 שעות, ובמסמך video_reels מופיעה שגיאה 613, קריאות ל-API הזה חרגו ממגבלת הקצב.

אילו הרשאות ומשימת עמוד נדרשות?

אסימון גישה לעמוד, מאדם שיכול לבצע את המשימה CREATE_CONTENT בעמוד, עם pages_show_list, pages_read_engagement ו-pages_manage_posts שניתנו דרך Facebook Login. Meta מבקשת גם מאפליקציות להציג לאדם גילוי נאות על אופן השימוש ב-Reels ב-Facebook, עם אפשרויות לשליטה בו, ולהציע רק את קהל היעד Public, שכן פרסום לעמוד כולל היקף ציבורי מובלע.

אילו שגיאות ה-Reels API מחזיר?

קוד 100 פירושו שפרמטר חובה חסר, כגון upload_phase, והודעת Meta מפרטת את החסרים. ארבעה קודים נוספים דוחים וידאו שחורג מהמפרטים:

  • 1363040: יחס התצוגה אינו נתמך; הוידאו צריך להיות בין 16x9 ל-9x16 בתצוגה אופקית או אנכית.
  • 1363127: הרזולוציה אינה נתמכת; המינימום הוא 540 x 960 פיקסלים.
  • 1363128: האורך אינו נתמך; Reels צריכים להיות באורך של 3 עד 90 שניות.
  • 1363129: קצב הפריימים הממוצע אינו נתמך; Reels צריכים להיות בין 24 ל-60 פריימים לשנייה.

איך מציגים את ה-Reels של עמוד?

בקריאת GET /{page-id}/video_reels, שמחזירה את ה-Reels שפורסמו בעמוד עם המזהים שלהם, זמני העדכון והתיאורים. since ו-until מצמצמים את הרשימה לתאריכים שניתנים כ-today, yesterday, חותמת UNIX או yyyy-mm-dd, כאשר until מאוחר מ-since. ההפניה של Meta לפיד מצביעה על נקודת הקצה הזו עבור ה-Reels שפורסמו בעמוד.

איך מפרסמים Reel דרך easyCoexistence, באילו שלבים?

לא כ-Reel, כיום. publish_facebook_post שולח סרטונים לנקודת הקצה videos של העמוד, כפוסטי וידאו רגילים, ול-easyCoexistence אין כלי לקריאות video_reels; אסימוני עמוד אינם נמסרים, ולכן גם את שלושת השלבים אי אפשר להריץ מהקוד שלכם דרך החיבור שלו. מפרסמים את ה-Reel מ-Facebook או מ-Meta Business Suite, או מפרסמים את הסרטון כפוסט וידאו רגיל.

טעויות נפוצות

  • שליחת ההעלאה אל graph.facebook.com. הוידאו נשלח אל rupload.facebook.com עם הכותרת Authorization: OAuth, ורק שלוש הקריאות האחרות הולכות לשרת הגרף.
  • אירוח הקובץ במקום ש-Meta לא יכולה לשלוף אותו. file_url מאחורי התחברות, באתר שה-robots.txt שלו חוסם את facebookexternalhit/1.1, או ב-fbcdn נדחה.
  • התחלה מחדש אחרי העלאה שנקטעה. קודם קראו את הסטטוס: uploading_phase.bytes_transfered הוא ה-offset שממנו ממשיכים, והתחלת סשן חדש היא המוצא האחרון.
  • תזמון יותר מ-30 Reels לעמוד אחד ביום. Meta סופרת Reels שפורסמו דרך ה-API בתקופה נעה של 24 שעות, ולכן פזרו את המתוזמנים לאורך הזמן.
עושים את זה עם EasyCoexistence

אין לו כלי ל-Reels API, ולכן Reel מפורסם מ-Facebook או מ-Meta Business Suite. החל מ-US$ 9 לחיבור בחודש, שיורד עד US$ 0.75 ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים בחינם.

שאלות נפוצות

האם ה-API מאפשר לפרסם Reels לפרופיל אישי או לקבוצה?

לא. Reels Publishing API של Meta מפרסם Reels רק לעמודים ב-Facebook, ופרסום צולב שלהם אפשרי רק לעמודים.

לפרסם Reels: האם publish_facebook_post עושה את זה?

לא. הוא מפרסם טקסט, קישורים, תמונות וסרטונים לעמוד. Reel דורש את קריאות video_reels, שהכלים של easyCoexistence אינם מבצעים.

איך בודקים Reel מול התאמות לזכויות יוצרים?

קוראים את GET /{video-id}?fields=copyright_check_information עם pages_read_engagement. Meta מריצה את הבדיקה בזמן ההעלאה, והיא יכולה להימשך כמה דקות, ורק הבעלים רואה את ההתאמות.

האם עמוד אחר יכול לפרסם גם את ה-Reel שלי?

כן, כשותף. POST /{video-id}/collaborators עם target_id שמוגדר למזהה העמוד שלהם שולח הזמנה, וברגע שהם מאשרים, ה-Reel מופיע גם בעמוד שלהם.

המשיכו לקרוא

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-