Activities: insert

תכונת לוח המודעות של הערוץ הוצאה משימוש ב-YouTube, והשיטה הזו כבר לא נתמכת.

פרטים נוספים זמינים במרכז העזרה של YouTube.

פרסום הודעה לכלל העובדים בערוץ ספציפי. (המשתמש ששולח את הבקשה צריך להיות מורשה לפעול בשם הערוץ).

הערה: למרות שמקור activity יכול להכיל מידע על פעולות כמו דירוג סרטון על ידי משתמש או סימון סרטון כמועדף, צריך להשתמש בשיטות אחרות של API כדי ליצור את מקורות activity האלה. לדוגמה, כדי לדרג סרטון משתמשים בשיטה videos.rate() של ה-API, וכדי לסמן סרטון כמועדף משתמשים בשיטה playlistItems.insert().

השפעה על המכסה: לשיחה לשיטה הזו יש עלות מכסה של 50 יחידות.

בקשה

בקשת HTTP

POST https://www.googleapis.com/youtube/v3/activities

אישור

כדי לבצע את הבקשה הזו, צריך להעניק הרשאה עם לפחות אחת מההיקפים הבאים (מידע נוסף על אימות והרשאה).

היקף
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

פרמטרים

בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים שמופיעים ברשימה הם פרמטרים של שאילתה.

פרמטרים
פרמטרים נדרשים
part string
הפרמטר part משמש לשתי מטרות בפעולה הזו. הוא מציין את המאפיינים שפעולת הכתיבה תגדיר, וגם את המאפיינים שתגובת ה-API תכלול.

הרשימה הבאה מכילה את השמות של part שאפשר לכלול בערך הפרמטר:
  • contentDetails
  • id
  • snippet

גוף הבקשה

מציינים משאב פעילות בגוף הבקשה. למשאב הזה:

  • חובה לציין ערך למאפיינים האלה:

    • snippet.description

  • אפשר להגדיר ערכים למאפיינים הבאים:

    • snippet.description
    • contentDetails.bulletin.resourceId

תשובה

אם הפעולה בוצעה ללא שגיאות, השיטה הזו מחזירה משאב פעילות בגוף התגובה.

שגיאות

בטבלה הבאה מפורטות הודעות השגיאה שה-API יכול להחזיר בתגובה לקריאה של השיטה הזו. אפשר לקרוא פרטים נוספים במסמכים בנושא הודעות שגיאה.

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) bulletinTextRequired בבקשה צריך להשתמש במאפיין description של אובייקט snippet כדי לספק את הטקסט של הפוסט בלוח המודעות.
badRequest (400) invalidMetadata הנכס kind לא תואם לסוג המזהה שצוין.
forbidden (403) forbidden הבקשה לא אושרה כראוי.
notFound (404) playlistNotFound המערכת של YouTube לא מצליחה למצוא את הסרטון שאתם מנסים לשייך לפוסט בעדכון. בודקים את הערך של המאפיין contentDetails.bulletinPosted.playlistId.
notFound (404) videoNotFound המערכת של YouTube לא מצליחה למצוא את הסרטון שאתם מנסים לשייך לפוסט בעדכון. בודקים את הערך של המאפיין contentDetails.bulletinPosted.videoId.
userRateLimitExceeded (403) rateLimitExceeded לא ניתן להשלים את הבקשה כי חרגת מהמכסה.