Activities: insert

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

פרטים נוספים זמינים במרכז העזרה של 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 לא ניתן להשלים את הבקשה מכיוון שחרגת מהמכסה שלך.