משאב 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 סוג המשאבים שהקבוצה מכילה. הערכים החוקיים לנכס הזה הם:
|