Groups

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

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

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

שיטות

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

list

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

הוספה

יצירת קבוצה של 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
  }
}

נכסים

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