משאב 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
}
}
נכסים
הטבלה הבאה מגדירה את המאפיינים שמופיעים במשאב הזה:
| נכסים | |
|---|---|
kind |
stringמזהה את סוג המשאב של ה-API. הערך יהיה youtube#group. |
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סוג המשאבים שהקבוצה מכילה. הערכים החוקיים לנכס הזה הם:
|