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

פוסטי קרוסלה ב-Instagram דרך ה-API

ה-API של Instagram מפרסם קרוסלה כפוסט אחד של עד 20 תמונות וסרטונים לפי מדריך הפרסום של Meta, אף שמדריך השגיאות עדיין מציין 10. לכל פריט נוצר מיכל משלו עם is_carousel_item שערכו true, ואז מיכל CAROUSEL מפנה אליהם בשדה children ונושא את הכיתוב. פרסום המיכל הזה מפרסם את כולם יחד, ונחשב כפוסט אחד מתוך 100 הפוסטים שמותר לפרסם דרך ה-API בחלון מתגלגל של 24 שעות.

easyCoexistence מפרסם קרוסלות של 2 עד 10 תמונות וסרטונים עם publish_instagram_post, מ-Claude, מ-ChatGPT או מהקוד שלכם: קריאה אחת עם הפריטים והכיתוב מפרסמת את הפוסט, והיא מסתיימת בעצמה בזמן שסרטון עדיין מעובד.

Up to 20

התמונות והסרטונים שקרוסלה יכולה להכיל לפי מדריך הפרסום של Meta ולפי פרמטר children.

2207028

תת-קוד תחת קוד 100, שההודעה שלו עדיין אומרת שקרוסלה צריכה 2 עד 10 פריטים.

1 post

כמה נספרת קרוסלה מול המגבלה של 100 פוסטים שמפורסמים דרך ה-API בחלון של 24 שעות.

1:1

החיתוך ברירת המחדל לתמונות בקרוסלה, שכולן עוקבות אחרי יחס הגובה-רוחב של התמונה הראשונה.

0

תובנות ש-Meta מחזירה לכל תמונה וסרטון שנמצאים בתוך קרוסלה.

איך מפרסמים קרוסלה?

בשלושה שלבים, הכול דרך POST /<IG_ID>/media וקריאת פרסום אחת.

  • פריטים: יוצרים מיכל לכל תמונה (image_url) או סרטון (media_type עם הערך VIDEO ועם video_url), עם is_carousel_item שערכו true וללא כיתוב.
  • קרוסלה: יוצרים מיכל עם media_type שערכו CAROUSEL, עם children שמכיל את מזהי מיכלי הפריטים מופרדים בפסיקים, וגם את הכיתוב.
  • פרסום: POST /<IG_ID>/media_publish עם creation_id שהערך שלו הוא המזהה של מיכל הקרוסלה.

כמה פריטים יכולה קרוסלה להכיל?

עד 20. מדריך הפרסום של Meta והפרמטר children של POST /<IG_ID>/media שניהם מציבים את המגבלה על 20 תמונות, סרטונים או שילוב של השניים. מדריך השגיאות עדיין מנסח את זה בצורה הישנה: ההודעה לקוד 100, תת-קוד 2207028, אומרת שקרוסלה צריכה לפחות 2 ולא יותר מ-10 פריטים, כך ש-2 עד 10 היא הכמות שכל חלק בתיעוד של Meta מקבל. פריטים יכולים להיות תמונות או סרטונים, אבל לא Reel: פריט בקרוסלה הוא תמונה או סרטון תמיד.

איך חותכים את תמונות הקרוסלה?

לתמונה הראשונה. כל תמונה בקרוסלה נחתכת ליחס הגובה-רוחב של התמונה הראשונה, וברירת המחדל היא ריבוע 1:1. כל תמונה עדיין חייבת לעמוד בכללים הרגילים: JPEG, עד 8 MB, ביחס בין 4:5 ל-1.91:1. שימו ראשונה את התמונה שהצורה שלה רצויה, או הפכו את כולן לאותה צורה לפני הפרסום.

מה שייך לקרוסלה ומה לכל פריט?

רוב ההגדרות ברמת הפוסט נמצאות במיכל הקרוסלה, לא בפריטים.

  • כיתוב: במיכל הקרוסלה בלבד. פריטים לא מקבלים כיתוב.
  • מיקום: במיכל הקרוסלה בלבד.
  • תווית AI: is_ai_generated שייך למיכל הקרוסלה, והגדרתו בפריט מחזירה שגיאה.
  • טקסט חלופי: נתמך בפריטי תמונה, עד 1,000 תווים לכל אחד.

איך קוראים קרוסלה?

כאובייקט מדיה אחד עם media_type שערכו CAROUSEL_ALBUM. GET /<IG_MEDIA_ID>/children מציג את התמונות והסרטונים שבתוכו, אם כי חלק מהשדות, כמו permalink, לא עובדים על הפריטים. מספרי התגובות והלייקים של הקרוסלה לא כוללים את הפריטים שלה, ו-Meta לא מחזירה תובנות לפריטים הבודדים, רק לפוסט הקרוסלה.

איך קרוסלה נספרת מול המגבלות?

כפוסט אחד. חשבון יכול לפרסם 100 פוסטים דרך ה-API בחלון מתגלגל של 24 שעות, וקרוסלה משתמשת באחד מהם, לא משנה כמה פריטים יש בה. עם זאת כל פריט הוא עדיין מיכל, וחשבון יכול ליצור 400 מיכלים בחלון מתגלגל של 24 שעות, כך שרצף של קרוסלות בנות עשרה פריטים מגיע לתקרה הזו לפני תקרת הפרסום.

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

  • הכנסת כיתוב לפריט. כיתוב לא נתמך בפריטי קרוסלה, לכן הגדירו אותו פעם אחת במיכל הקרוסלה.
  • הוספת Reel כפריט. פריטי קרוסלה הם מיכלי תמונה או סרטון, ו-Reel לא יכול להופיע בקרוסלה.
  • ערבוב של תמונות לאורך ולרוחב בלי לבדוק את הראשונה. כל תמונה לוקחת את יחס הגובה-רוחב של התמונה הראשונה.
  • ציפייה לתובנות לכל שקף. Meta לא מחזירה כלום למדיה שבתוך קרוסלה, רק לפוסט.
עושים את זה עם EasyCoexistence

אפשר לתזמן קרוסלות גם מהתור שלה. מ-US$ 9 ועד US$ 0.75 לחיבור בחודש, והמחיר יורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים.

שאלות נפוצות

אפשר לתזמן קרוסלה של Instagram דרך ה-API?

כן, דרך תור, כי Meta מפרסמת קרוסלה כשמפרסמים את המיכל שלה. publish_instagram_post של easyCoexistence מקבל scheduled_at, מ-1 דקה עד 90 ימים קדימה, לקרוסלות של 2 עד 10 פריטים.

אפשר לסמן קרוסלה כשנוצרה ב-AI?

כן, עם is_ai_generated במיכל הקרוסלה. הגדרתו בפריט מחזירה שגיאה.

אפשר לכלול Reel בקרוסלה?

לא. Reel מפורסם תמיד לבד, ופריטי קרוסלה הם מיכלי תמונה או סרטון רגילים.

מה משמעות שגיאה 2207028 בקרוסלה?

ההודעה של Meta לקוד הזה אומרת שקרוסלה צריכה לפחות 2 ולא יותר מ-10 פריטים. כמות בין 2 ל-10 עונה גם על ההודעה הזו וגם על המגבלה של 20 במדריך הפרסום, אז התאימו את הפריטים וצרו שוב את מיכל הקרוסלה.

המשיכו לקרוא

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

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

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

נבדק ב-