פרסום סרטונים ל-Facebook Page דרך ה-API
וידאו מגיע לעמוד Facebook דרך POST /{page-id}/videos, או עם file_url, כתובת ש-Meta מורידה בעצמה, או עם קובץ שהאפליקציה מעלה ל-Meta מראש. השדה title מציין את שם הסרטון, והשדה description הוא הטקסט ש-Meta עשויה להציג לצד הפוסט. לאחר מכן Meta מעבדת את הקובץ, ו-GET /{video-id}?fields=status מחזיר את video_status עם הערך processing עד שהוא נעשה ready.
easyCoexistence מפרסמת סרטונים לעמודי Facebook עם publish_facebook_post מ-Claude, מ-ChatGPT או מהקוד שלכם, מיד או מתוזמן עד 90 ימים קדימה.
קוד שגיאה כאשר Meta לא יכולה לשלוף את קובץ הווידאו מהכתובת שניתנה ב-file_url.
קוד שגיאה לקובץ וידאו קטן מדי להעלאה, ו-Meta מבקשת קובץ גדול יותר.
חלון הזמן עבור scheduled_publish_time בנקודת הקצה videos, הנמדד מהרגע שבו הסרטון מפורסם.
טווח הערכים של processing_progress, כלומר שיעור העיבוד שהושלם בסרטון, המדווח לצד video_status.
השרת להעלאת סרטונים לפי מסמך הסקירה של Meta על Video API, שמסמן את graph-video.facebook.com כמיושן להעלאות אלה.
המזהה שההעלאה מחזירה, שמועבר בנתיב /{page-id}/videos בשם fbuploader_video_file_chunk כדי לפרסם את הסרטון.
כיצד מפרסמים סרטון לעמוד?
עם POST /{page-id}/videos ואסימון גישה של ה-Facebook Page. הקובץ מגיע ל-Meta באחת משתי דרכים: file_url, כתובת נגישה של הסרטון ש-Meta מורידה בעצמה, או העלאה, שבה האפליקציה שולחת את הבייטים קודם. לא ניתן לשלב את file_url עם upload_phase, הפרמטר של ההעלאה המפוצלת, ולכן בקשה משתמשת באחת הדרכים בלבד.
| file_url | Uploaded file | |
|---|---|---|
| Where the video is | At a URL Meta can reach | On your own system |
| On /{page-id}/videos | file_url | fbuploader_video_file_chunk with the upload's handle |
| Before publishing | Nothing: Meta fetches the file | An upload session, then the bytes |
| If it fails | Error 389 when Meta cannot fetch it | Resume from the offset Meta reports |
איך ההעלאה פועלת לקובץ שאינו זמין ברשת?
המדריך של Meta לפרסום וידאו משתמש ב-Resumable Upload API. POST /{app-id}/uploads עם file_name, file_length ו-file_type פותח סשן, ו-POST /upload:{session-id} עם כותרת file_offset והבייטים מחזיר מזהה, שהוא הערך h. לאחר מכן הסרטון מפורסם עם POST /{page-id}/videos ו-fbuploader_video_file_chunk שמוגדר לאותו מזהה, לצד title ו-description. קריאות ההעלאה האלה נושאות אסימון גישה של משתמש.
- העלאה שנקטעה ממשיכה מהערך של
file_offsetש-GET /upload:{session-id} מחזיר. - במסמך videos מתועדת גם העלאה מפוצלת באותה נקודת קצה:
upload_phaseעם הערכים start, transfer ו-finish, וגםstart_offset,file_sizeו-video_file_chunk.
מה תפקידם של title ו-description?
title הוא כותרת הסרטון. description הוא, לפי ההגדרה של Meta, הטקסט שמתאר פוסט שעשוי להופיע בסטורי עליו, ולכן שם נכנס תוכן הפוסט. שניהם אופציונליים בנקודת הקצה videos. כאשר publish_facebook_post מקבל הודעה, הוא שולח אותה בתור השדה description ומשאיר את title ללא ערך.
איך יודעים שהסרטון מוכן?
Meta מעבדת סרטון אחרי שהגיע. GET /{video-id}?fields=status מחזיר video_status, שמציין processing בזמן ש-Meta עובדת, ready לאחר שהסרטון הועלה, קודד והתמונות הממוזערות שלו נוצרו, או error אם העיבוד נכשל, עם processing_progress שנותן את השיעור שהושלם מ-0 עד 100. Meta יכולה גם לדווח על סטטוס הפרסום דרך וובהוקים (Webhook) של Facebook Page בשדה videos, ש-easyCoexistence לא נרשמת אליהם.
כמה גדול וכמה ארוך יכול הסרטון להיות?
בתיעוד הייחוס של Page videos ובמדריך הפרסום של Meta לא מופיעים גודל מרבי או אורך מרבי לקובץ. הכלל היחיד שמוזכר הוא קוד שגיאה 382, לקובץ קטן מדי להעלאה. המדריכים של Meta ל-Reels ול-Stories קובעים משכים משלהם: בין 3 ל-90 שניות ל-Reel, ועד 60 שניות לסטורי וידאו. כאשר easyCoexistence מתזמנת סרטון, היא מעתיקה את הקובץ באותו רגע ומסרבת לקובץ שגדול מ-1 GB.
אילו הרשאות ומשימת Page נדרשות?
pages_manage_posts, pages_read_engagement ו-pages_show_list, עם אסימון גישה לעמוד מאדם שיכול לבצע את המשימה CREATE_CONTENT, לפי התיעוד של הסרטונים ומדריך הפרסום. מסמך הסקירה של Meta ל-Video API מנסח זאת בצורה מחמירה יותר: האדם צריך להיות מסוגל לבצע משימות ברמת מנהל בעמוד, או להחזיק בתפקיד Admin שניתן דרך Business Manager.
אילו קודי שגיאה יכולה להחזיר פרסום סרטון?
תיעוד הסרטונים של Meta מפרט אלה עבור POST /{page-id}/videos:
- 389: לא ניתן לשלוף את קובץ הסרטון מהכתובת.
- 382: הקובץ קטן מדי; נסו שוב עם קובץ גדול יותר.
- 6000: בעיה בהעלאת קובץ הסרטון; נסו שוב עם קובץ אחר.
- 6001: בעיה בהעלאת הסרטון; נסו שוב.
- 368: הפעולה סווגה כמתעללת, או שאינה מותרת בכל דרך אחרת.
- 100: פרמטר לא תקין; 200: שגיאת הרשאות; 190: אסימון גישה OAuth 2.0 לא תקין.
איך publish_facebook_post מפרסם סרטון?
הכלי מקבל video_url, קישור HTTPS ציבורי לקובץ, ואת message, ושולח אותם לנקודת הקצה /{page-id}/videos בתור השדות file_url ו-description, כך ש-Meta מורידה את הסרטון בעצמה. פוסט מכיל סרטון אחד, וקישור שנשלח לצדו נדחה, ולכן יש לכתוב את הכתובת בתוך השדה message. השדה post_id בתוצאה מכיל את המזהה ש-Meta החזירה, שבסרטון הוא המזהה של הסרטון עצמו.
איך מתזמנים פוסט עם סרטון?
נותנים ל-publish_facebook_post את scheduled_at בפורמט ISO 8601 עם אזור זמן, מדקה אחת עד 90 ימים קדימה. easyCoexistence מעתיקה את הסרטון כשהפוסט מתוזמן, ומפרסמת אותו לעמוד באותו זמן. list_scheduled_posts מציג אותו, update_scheduled_post מזיז אותו או משנה את הטקסט שלו, ו-cancel_scheduled_post עוצר אותו. השדה scheduled_publish_time של Meta בנקודת הקצה videos מאפשר בין 10 דקות ל-6 חודשים.
טעויות נפוצות
- הפניית file_url לדף שמנגן את הסרטון ולא לקובץ עצמו. Meta מורידה את הכתובת בעצמה, וכתובת שהיא לא יכולה לשלוף נכשלת עם קוד שגיאה 389.
- העלאה אל graph-video.facebook.com. מסמך הסקירה של Meta ל-Video API מסמן את השרת הזה כמיושן להעלאות סרטונים, ומבקש את graph.facebook.com.
- הכרזה על הסרטון לפני שהוא מוכן. בדקו את הסטטוס עד ש-video_status מציין ready, כי העיבוד ממשיך גם אחרי שקריאת הפרסום חוזרת.
- שליחת קישור יחד עם הסרטון. publish_facebook_post דוחה קישור לצד קובץ, ולכן יש לכתוב את הכתובת לתוך השדה message במקום זה.
הפלטפורמה שלכם יכולה לעשות זאת גם עם POST /channels/:id/posts ב-Partner API. US$ 9 עד US$ 0.75 לחיבור בחודש, שיורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים.
שאלות נפוצות
אפשר להעלות סרטון מהמחשב לעמוד Facebook דרך ה-API?
כן, דרך Resumable Upload API של Meta, שמחזיר מזהה עבור /{page-id}/videos, או דרך ההעלאה המפוצלת באותה נקודת קצה. publish_facebook_post לוקח במקום זאת כתובת HTTPS ציבורית, ולכן יש להעלות את הקובץ קודם לאחסון.
אפשר להעלות סרטון בלי שיופיע בפיד של העמוד?
כן. published שמוגדר ל-false מעכב את הפוסט, no_story מדכא את הסיפור בפיד ובציר הזמן, ו-secret מונע מהסרטון להופיע ב-Facebook ובחיפוש.
אפשר לפרסם סרטון אחד בכמה עמודים?
כן, באמצעות פרסום צולב (crossposting): סרטון שפורסם יכול לצאת לעמודים אחרים שהאדם מנהל בלי להעלות אותו שוב, ולכל עמוד יש מזהה סרטון משלו.
כמה עולה easyCoexistence לעמוד Facebook?
US$ 9 עד US$ 0.75 לחיבור בחודש, נקבע לפי מספר החיבורים הכולל שלכם, עם תקופת ניסיון של 3 ימים. כל Facebook Page הוא חיבור אחד.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-