Groups

משאב group מייצג קבוצה של YouTube Analytics, שהיא אוסף מותאם אישית של עד 500 ערוצים, סרטונים, פלייליסטים או נכסים.

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

קבוצה ב-Analytics יכולה להכיל רק משאבים שהעליתם או הבעתם עליהם בעלות, או משאבים שמקושרים לערוץ שאתם מנהלים. כתוצאה מכך, בעלי ערוצים יכולים ליצור קבוצות של סרטונים ופלייליסטים. בעלי תוכן יכולים ליצור קבוצות של סרטונים, פלייליסטים, ערוצים או נכסים.

שיטות

ה-API תומך בשיטות הבאות למשאבי groups:

list

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

insert

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

עדכון

שינוי המטא-נתונים של קבוצה. נכון לעכשיו, הנכס היחיד שאפשר לעדכן הוא שם הקבוצה. (משתמשים בgroupItems.insert ובgroupItems.delete כדי להוסיף ולהסיר פריטים קבוצתיים.) רוצים לנסות?

מחיקה

מחיקת קבוצה. כדאי לנסות עכשיו.

ייצוג משאבים

במבנה ה-JSON הבא מוצג הפורמט של משאב groups:

{
  "kind": "youtube#group",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "title": string
  },
  "contentDetails": {
    "itemCount": unsigned long,
    "itemType": string
  }
}

מאפיינים

בטבלה הבאה מפורטים המאפיינים שמופיעים במשאב הזה: