# פרסום סרטון ב-YouTube, ב-Instagram, ב-Facebook וב-Threads

כתובת URL קנונית: https://sosoapi.ai/he/docs/video-publishing

העלו את הסרטון פעם אחת, ואז הכינו פוסט לכל יעד. המדריך מכסה בדיקות מדיה, אפשרויות פלטפורמה, פרטיות YouTube ובדיקה אם הפוסט פורסם. חוזה הפרסום נבדק ב-20 באוקטובר 2026.

## 1. הכינו נכס סרטון מוכן אחד

העלו סרטון מקומי או ייבאו URL ציבורי של סרטון לסביבת העבודה. בדקו את ההעלאה או הייבוא עד ready, ואז השתמשו ב-asset_id הרשום וב-asset_url הקנוני בפוסט.

SosoAPI בודק את ה-container, המשך, הממדים והמקודדים האמיתיים של הסרטון במקומות שבהם הפלטפורמה דורשת זאת. שם קובץ, סוג MIME שסופק על ידי הקורא או תצוגה מקדימה ניתנת לניגון אינם מספיקים לקביעת התאמה. בדקו את הזכויות שלכם לסרטון ולאודיו וכל גילוי נדרש לפני התזמון.

- שמרו את נכסי הסרטון ותמונת השער המקוריים באותה סביבת עבודה מורשית.

- בדקו התאמת טיוטה מלאה לחשבון המדויק ולפורמט המיועד.

- אם ההכנה נכשלת, בדקו את הסטטוס הקיים שלה; אין להתחיל ייבואים כפולים רק כי תגובה איטית.

## 2. בחרו את פורמט הסרטון של היעד

בחרו את הפורמט והאפשרויות שחשבון היעד תומך בהם. אפשר להשתמש שוב בנכס מוכן, אבל כל פלטפורמה דורשת provider_payload משלה.

אפשרויות פרסום סרטונים

| יעד | בחירת provider_payload | בדיקה לפני תזמון |

| --- | --- | --- |

| Instagram | platform: instagram; ‏VIDEO, ‏REELS או STORY_VIDEO לפי הצורך. | חשבון מקצועי ויכולות שנצפו; Stories דורשים התאמת Business. אפשרויות ייחודיות ל-Reels חייבות להישאר ב-Reels. |

| דף Facebook | platform: facebook; ‏VIDEO, ‏REELS או STORY_VIDEO לפי הצורך. | זהות הדף, הרשאת פרסום ומשימת CREATE_CONTENT; אפשרויות מדיה ופורמט נתמכות. |

| Threads | platform: threads; VIDEO. | חשבון מתאים לפרסום וסרטון מוכן; קבצים מצורפים לטקסט בלבד אינם חלים על מטען VIDEO. |

| ערוץ YouTube | platform: youtube; VIDEO. | כותרת, קטגוריה, פרטיות ומצב ביטול מפורשים; הרשאת ניהול לתזמון מקורי. |

## 3. תזמנו סרטון YouTube שנבדק

השתמשו בעזר השרת מתיעוד ה-API. החליפו asset_id במספר השלם החיובי הרשום ואת asset_url ב-URL הקנוני שלו. בחרו את מזהה החשבון האמיתי של הערוץ ואת מועד הפרסום העתידי.

הדוגמה מבקשת פרסום ציבורי במועד הנבחר. אשרו את רמת הנראות הזו עם המשתמש לפני ההרצה. הגדירו contains_synthetic_media בהתאם לסרטון; false הוא רק דוגמה. UNSCHEDULE_KEEP_PRIVATE מבקש מ-YouTube לשמור תזמון מקורי שטרם פורסם כפרטי אם הוא מבוטל.

```
await sosoPost("/studio-api/scheduled-posts/create", {
  "workspace_id": "<workspace-uuid>",
  "social_account_id": "<youtube-channel-account-uuid>",
  "caption": null,
  "hashtags": [],
  "media": [
    {
      "kind": "video",
      "asset_id": "<ready-video-asset-id>",
      "url": "<canonical-video-asset-url>"
    }
  ],
  "provider_payload": {
    "platform": "youtube",
    "publish_options": {
      "post_type": "VIDEO",
      "title": "A reviewed product walkthrough",
      "description": "Our team introduces the product in one short walkthrough.",
      "category_id": "24",
      "privacy_status": "public",
      "cancellation_mode": "UNSCHEDULE_KEEP_PRIVATE",
      "contains_synthetic_media": false
    }
  },
  "scheduled_at": "<future-ISO-8601-instant-with-offset>",
  "display_timezone": "Asia/Hong_Kong",
  "idempotency_key": "<stable-key-for-this-one-video-intent>"
});
```

- [תיעוד API הפרסום](https://sosoapi.ai/he/docs/publishing-api-reference)

## 4. ציינו במפורש פרטיות, Shorts ומגבלות ספק

השתמשו ב-post_type VIDEO ל-YouTube. אפשר להגדיר surface_expectation: SHORT, אבל YouTube עדיין מחליט אם ההעלאה עומדת בתנאים ל-Short. שם קובץ או כיוון אנכי לבדם אינם מוכיחים זאת.

הרשאת העלאה והרשאת ניהול תזמונים מקוריים נפרדות. בדקו אם הערוץ תומך ביכולות אופציונליות כמו תמונות ממוזערות; הזמינות יכולה להיות לא ידועה. תיעוד ההעלאה של Google מסביר דרישות הרשאה ומטא-נתונים, ו-SosoAPI בודק גם את השדות הנתמכים שלו ואת החשבון המחובר.

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

- [Google: תיעוד YouTube videos.insert](https://developers.google.com/youtube/data/reference/rest/v3/videos/insert)

- [מטריצת יכולות חשבון ופורמט](https://sosoapi.ai/he/docs/publishing-capabilities)

## 5. אמתו את התוצאה הסופית של אותו פוסט

שמרו את מזהה Scheduled Post ובדקו את המסירה והתוצאה הסופית שלו. פתחו את קישור הספק כשהוא זמין. scheduled או publishing פירושם שהתוצאה הסופית עדיין ממתינה.

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

בדקו את דרישות כל יעד כשמשתמשים שוב בסרטון בכמה פלטפורמות. הדוגמאות מציגות פורמטי בקשות; הן אינן רצות או מפרסמות סרטון מהעמוד הזה.

- [תהליך בדיקה עם הסוכן שלכם](https://sosoapi.ai/he/docs/claude-code-codex-social-publishing)

- [תיעוד API הפרסום](https://sosoapi.ai/he/docs/publishing-api-reference)