Groups: insert

יוצרים קבוצה ב-YouTube Analytics. אחרי שיוצרים קבוצה, צריך להשתמש בשיטה groupItems.insert כדי להוסיף פריטים לקבוצה.

שליחת בקשה

בקשת HTTP

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

הרשאה

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

טווחים
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.

גוף הבקשה

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

  • snippet.title
  • contentDetails.itemType

תשובה

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

שגיאות

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

רוצה לנסות?

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