GroupItems: insert

יצירת פריט קבוצתי

שליחת בקשה

בקשת HTTP

POST https://youtubeanalytics.googleapis.com/v2/groupItems

הרשאה

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

טווחים
https://www.googleapis.com/auth/yt-analytics.readonly עיון בדוחות YouTube Analytics עבור התוכן שלך ב-YouTube. ההיקף הזה מספק גישה למדדי פעילות המשתמשים, כמו מספר הצפיות וספירת הדירוגים.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly אתם יכולים לעיין בדוחות הכספיים של YouTube Analytics עבור התוכן שלכם ב-YouTube. היקף זה מספק גישה למדדי פעילות המשתמשים ולמדדי ההכנסות המשוערות וביצועי המודעות.
https://www.googleapis.com/auth/youtube ניהול חשבון YouTube שלך. ב-YouTube Analytics API, בעלי ערוצים משתמשים בהיקף זה כדי לנהל קבוצות ופריטי קבוצה ב-YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner הצגה וניהול של נכסי YouTube ותוכן משויך ב-YouTube. ב-YouTube Analytics API, בעלי תוכן משתמשים בהיקף זה כדי לנהל קבוצות ופריטי קבוצה ב-YouTube Analytics.

פרמטרים

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

פרמטרים
פרמטרים אופציונליים
onBehalfOfContentOwner string
אפשר להשתמש בפרמטר הזה רק בבקשה מורשית. הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן של YouTube שהם הבעלים והמנהלים של ערוצי YouTube רבים.

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

גוף הבקשה

בגוף הבקשה יש משאב itemItem. עבור המשאב הזה, עליך לציין ערך עבור המאפיינים הבאים.

  • groupId
  • resource.id

תשובה

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

אם הפריט שצוין בבקשה כבר נכלל בקבוצה לפני שליחת הבקשה, השיטה הזו מחזירה את קוד התגובה 204 מסוג HTTP (No Content).

שגיאות

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

סוג השגיאה פרטי השגיאה תיאור
forbidden (403) groupContainsMaximumNumberOfItems הקבוצה מכילה את המספר המקסימלי המותר של פריטים.

רוצה לנסות?

אפשר להשתמש ב-APIs Explorer כדי לקרוא ל-API הזה ולראות את בקשת ה-API ואת התשובה.