משאב 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
}
}מאפיינים
בטבלה הבאה מפורטים המאפיינים שמופיעים במשאב הזה:
| מאפיינים | |
|---|---|
kind |
stringמזהה את סוג משאב ה-API. הערך יהיה youtube#group. |
etag |
etagה-Etag של המשאב הזה. |
id |
stringהמזהה שמשמש את YouTube לזיהוי ייחודי של הקבוצה. |
snippet |
objectהאובייקט snippet מכיל מידע בסיסי על הקבוצה, כולל השם והתאריך של היצירה שלה. |
snippet.publishedAt |
datetimeהתאריך והשעה שבהם הקבוצה נוצרה. הערך מצוין בפורמט ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ). |
snippet.title |
stringשם הקבוצה. הערך חייב להיות מחרוזת לא ריקה. |
contentDetails |
objectהאובייקט contentDetails מכיל מידע נוסף על הקבוצה, כמו מספר הפריטים שהיא מכילה וסוגם. |
contentDetails.itemCount |
unsigned longמספר הפריטים בקבוצה. |
contentDetails.itemType |
stringסוג המשאבים שהקבוצה מכילה. הערכים החוקיים למאפיין הזה הם:
|