משאב activity מכיל מידע על פעולה שבוצעה על ידי ערוץ או משתמש מסוימים ב-YouTube. הפעולות שמדווחות בפיד הפעילות כוללות דירוג סרטון, שיתוף סרטון, סימון סרטון כמועדף, העלאת סרטון וכו'. כל משאב activity מזהה את סוג הפעולה, את הערוץ שמשויך לפעולה ואת המשאבים שמשויכים לפעולה, כמו הסרטון שקיבל דירוג או הועלה.
Methods
ה-API תומך בשיטות הבאות למשאבי activities:
- list
- מחזירה רשימה של אירועים של פעילות בערוץ שתואמים לקריטריונים של הבקשה. לדוגמה, אפשר לאחזר אירועים שמשויכים לערוץ מסוים או לערוץ של המשתמש עצמו. כדאי לנסות עכשיו.
ייצוג משאבים
מבנה ה-JSON הבא מציג את הפורמט של משאב activities:
{
"kind": "youtube#activity",
"etag": etag,
"id": string,
"snippet": {
"publishedAt": datetime,
"channelId": string,
"title": string,
"description": string,
"thumbnails": {
(key): {
"url": string,
"width": unsigned integer,
"height": unsigned integer
}
},
"channelTitle": string,
"type": string,
"groupId": string
},
"contentDetails": {
"upload": {
"videoId": string
},
"like": {
"resourceId": {
"kind": string,
"videoId": string,
}
},
"favorite": {
"resourceId": {
"kind": string,
"videoId": string,
}
},
"comment": {
"resourceId": {
"kind": string,
"videoId": string,
"channelId": string,
}
},
"subscription": {
"resourceId": {
"kind": string,
"channelId": string,
}
},
"playlistItem": {
"resourceId": {
"kind": string,
"videoId": string,
},
"playlistId": string,
"playlistItemId": string
},
"recommendation": {
"resourceId": {
"kind": string,
"videoId": string,
"channelId": string,
},
"reason": string,
"seedResourceId": {
"kind": string,
"videoId": string,
"channelId": string,
"playlistId": string
}
},
"social": {
"type": string,
"resourceId": {
"kind": string,
"videoId": string,
"channelId": string,
"playlistId": string
},
"author": string,
"referenceUrl": string,
"imageUrl": string
},
"channelItem": {
"resourceId": {
}
},
}
}מאפיינים
בטבלה הבאה מוגדרים המאפיינים שמופיעים במשאב הזה:
| מאפיינים | |
|---|---|
kind |
stringמזהה את סוג משאב ה-API. הערך יהיה youtube#activity. |
etag |
etagה-Etag של מקור המידע הזה. |
id |
stringהמזהה שמשמש את YouTube לזיהוי ייחודי של הפעילות. |
snippet |
objectהאובייקט snippet מכיל פרטים בסיסיים על הפעילות, כולל סוג הפעילות ומזהה הקבוצה. |
snippet.publishedAt |
datetimeהתאריך והשעה שבהם התרחשה הפעילות. הערך מצוין בפורמט ISO 8601. |
snippet.channelId |
stringהמזהה שמשמש את YouTube לזיהוי ייחודי של הערוץ שמשויך לפעילות. |
snippet.title |
stringהשם של המשאב שמשויך בעיקר לפעילות. |
snippet.description |
stringתיאור המשאב שמשויך בעיקר לפעילות. |
snippet.thumbnails |
objectמפה של תמונות ממוזערות שמשויכות למשאב שמשויך בעיקר לפעילות. לכל אובייקט במפה, המפתח הוא השם של התמונה הממוזערת, והערך הוא אובייקט שמכיל מידע נוסף על התמונה הממוזערת. |
snippet.thumbnails.(key) |
objectהערכים התקפים של המפתח הם:
|
snippet.thumbnails.(key).url |
stringכתובת ה-URL של התמונה. |
snippet.thumbnails.(key).width |
unsigned integerרוחב התמונה. |
snippet.thumbnails.(key).height |
unsigned integerגובה התמונה. |
snippet.channelTitle |
stringשם הערוץ שאחראי לפעילות הזו |
snippet.type |
stringסוג הפעילות שהמשאב מתאר. הערכים התקינים של המאפיין הזה הם:
|
snippet.groupId |
stringמזהה הקבוצה שמשויך לפעילות. מזהה קבוצה מזהה אירועי משתמש שמשויכים לאותו משתמש ולאותו משאב. לדוגמה, אם משתמש מדרג סרטון ומסמן את אותו סרטון כמועדף, לרשומות של האירועים האלה יהיה אותו מזהה קבוצה בפיד הפעילות של המשתמש. בממשק המשתמש, אפשר לקבץ אירועים עם אותו ערך של groupId כדי להימנע מחזרות. |
contentDetails |
objectהאובייקט contentDetails מכיל מידע על התוכן שמשויך לפעילות. לדוגמה, אם הערך של snippet.type הוא videoRated, התוכן של האובייקט contentDetails מזהה את הסרטון שסווג. |
contentDetails.upload |
objectאובייקט upload מכיל מידע על הסרטון שהועלה. המאפיין הזה מופיע רק אם הערך של snippet.type הוא upload. |
contentDetails.upload.videoId |
stringהמזהה שמשמש את YouTube לזיהוי ייחודי של הסרטון שהועלה. |
contentDetails.like |
objectהאובייקט like מכיל מידע על משאב שקיבל דירוג חיובי (למשל לייק). המאפיין הזה מופיע רק אם הערך של snippet.type הוא like. |
contentDetails.like.resourceId |
objectהאובייקט resourceId מכיל מידע שמזהה את המשאב שסווג. |
contentDetails.like.resourceId.kind |
stringסוג משאב ה-API. |
contentDetails.like.resourceId.videoId |
stringהמזהה שמשמש את YouTube לזיהוי ייחודי של הסרטון, אם המשאב שסווג הוא סרטון. המאפיין הזה מופיע רק אם הערך של resourceId.kind הוא youtube#video. |
contentDetails.favorite |
objectהאובייקט favorite מכיל מידע על סרטון שסומן כסרטון מועדף. המאפיין הזה מופיע רק אם הערך של snippet.type הוא favorite. |
contentDetails.favorite.resourceId |
objectהאובייקט resourceId מכיל מידע שמזהה את המשאב שסומן כמועדף. |
contentDetails.favorite.resourceId.kind |
stringסוג משאב ה-API. |
contentDetails.favorite.resourceId.videoId |
stringהמזהה שמשמש את YouTube לזיהוי ייחודי של הסרטון המועדף. המאפיין הזה מופיע רק אם הערך של resourceId.kind הוא youtube#video.הערה: בשלב הזה, השיטה activities.list לא מחזירה משאבים לתגובות חדשות. |
contentDetails.comment |
objectהאובייקט comment מכיל מידע על משאב שהתקבלה לגביו תגובה. המאפיין הזה מופיע רק אם הערך של snippet.type הוא comment. |
contentDetails.comment.resourceId |
objectהאובייקט resourceId מכיל מידע שמזהה את המשאב שמשויך לתגובה. |
contentDetails.comment.resourceId.kind |
stringסוג משאב ה-API. |
contentDetails.comment.resourceId.videoId |
stringהמזהה שמשמש את YouTube לזיהוי ייחודי של הסרטון שמשויך לתגובה. המאפיין הזה מופיע רק אם הערך של resourceId.kind הוא youtube#video. |
contentDetails.comment.resourceId.channelId |
stringהמזהה שמשמש את YouTube לזיהוי ייחודי של הערוץ שמשויך לתגובה. המאפיין הזה מופיע רק אם הערך של resourceId.kind הוא youtube#channel. |
contentDetails.subscription |
objectהאובייקט subscription מכיל מידע על ערוץ שהמשתמש נרשם אליו. המאפיין הזה מופיע רק אם הערך של snippet.type הוא subscription. |
contentDetails.subscription.resourceId |
objectהאובייקט resourceId מכיל מידע שמזהה את המשאב שהמשתמש נרשם אליו. |
contentDetails.subscription.resourceId.kind |
stringסוג משאב ה-API. |
contentDetails.subscription.resourceId.channelId |
stringהמזהה שמשמש את YouTube לזיהוי ייחודי של הערוץ שהמשתמש נרשם אליו. המאפיין הזה מופיע רק אם הערך של resourceId.kind הוא youtube#channel. |
contentDetails.playlistItem |
objectהאובייקט playlistItem מכיל מידע על פריט חדש בפלייליסט. המאפיין הזה מופיע רק אם הערך של snippet.type הוא playlistItem. |
contentDetails.playlistItem.resourceId |
objectהאובייקט resourceId מכיל מידע שמזהה את המשאב שנוסף לפלייליסט. |
contentDetails.playlistItem.resourceId.kind |
stringסוג משאב ה-API. |
contentDetails.playlistItem.resourceId.videoId |
stringהמזהה שמשמש את YouTube לזיהוי ייחודי של הסרטון שנוסף לפלייליסט. המאפיין הזה מופיע רק אם הערך של resourceId.kind הוא youtube#video. |
contentDetails.playlistItem.playlistId |
stringהערך שמשמש את YouTube לזיהוי ייחודי של הפלייליסט. |
contentDetails.playlistItem.playlistItemId |
stringהערך שמשמש את YouTube לזיהוי ייחודי של הפריט בפלייליסט. |
contentDetails.recommendation |
objectהאובייקט recommendation מכיל מידע על משאב מומלץ. המאפיין הזה מופיע רק אם הערך של snippet.type הוא recommendation. |
contentDetails.recommendation.resourceId |
objectהאובייקט resourceId מכיל מידע שמזהה את המשאב המומלץ. |
contentDetails.recommendation.resourceId.kind |
stringסוג משאב ה-API. |
contentDetails.recommendation.resourceId.videoId |
stringהמזהה שמשמש את YouTube לזיהוי ייחודי של הסרטון, אם המשאב המומלץ הוא סרטון. המאפיין הזה מופיע רק אם הערך של resourceId.kind הוא youtube#video. |
contentDetails.recommendation.resourceId.channelId |
stringהמזהה שמשמש את YouTube לזיהוי ייחודי של הערוץ, אם המשאב המומלץ הוא ערוץ. המאפיין הזה מופיע רק אם הערך של resourceId.kind הוא youtube#channel. |
contentDetails.recommendation.reason |
stringהסיבה לכך שהמשאב מומלץ למשתמש. הערכים התקינים של המאפיין הזה הם:
|
contentDetails.recommendation.seedResourceId |
objectהאובייקט seedResourceId מכיל מידע על המשאב שגרם להמלצה. |
contentDetails.recommendation.seedResourceId.kind |
stringסוג משאב ה-API. |
contentDetails.recommendation.seedResourceId.videoId |
stringהמזהה שבו YouTube משתמש כדי לזהות את הסרטון באופן ייחודי, אם ההמלצה נוצרה בעקבות סרטון מסוים. המאפיין הזה מופיע רק אם הערך של seedResourceId.kind הוא youtube#video. |
contentDetails.recommendation.seedResourceId.channelId |
stringהמזהה שמשמש את YouTube לזיהוי ייחודי של הערוץ, אם ההמלצה נוצרה בגלל ערוץ מסוים. המאפיין הזה מופיע רק אם הערך של seedResourceId.kind הוא youtube#channel. |
contentDetails.recommendation.seedResourceId.playlistId |
stringהמזהה שמשמש את YouTube לזיהוי ייחודי של הפלייליסט, אם ההמלצה נוצרה בגלל פלייליסט מסוים. המאפיין הזה מופיע רק אם הערך של seedResourceId.kind הוא youtube#playlist. |
contentDetails.social |
objectהאובייקט social מכיל פרטים על פוסט ברשת חברתית. המאפיין הזה מופיע רק אם הערך של snippet.type הוא social. |
contentDetails.social.type |
stringהשם של הרשת החברתית. הערכים התקינים של המאפיין הזה הם:
|
contentDetails.social.resourceId |
objectהאובייקט resourceId כולל מידע שמזהה את המקור שמשויך לפוסט ברשת החברתית. |
contentDetails.social.resourceId.kind |
stringסוג משאב ה-API. |
contentDetails.social.resourceId.videoId |
stringהמזהה ש-YouTube משתמש בו כדי לזהות באופן ייחודי את הסרטון שמוצג בפוסט ברשת חברתית, אם הפוסט מתייחס לסרטון. המאפיין הזה יופיע רק אם הערך של המאפיין social.resourceId.kind הוא youtube#video. |
contentDetails.social.resourceId.channelId |
stringהמזהה שמשמש את YouTube לזיהוי ייחודי של הערוץ שמוצג בפוסט ברשת חברתית, אם הפוסט מתייחס לערוץ. המאפיין הזה יופיע רק אם הערך של המאפיין social.resourceId.kind הוא youtube#channel. |
contentDetails.social.resourceId.playlistId |
stringהמזהה שמשמש את YouTube לזיהוי ייחודי של הפלייליסט שמוצג בפוסט ברשת החברתית, אם הפוסט מתייחס לפלייליסט. המאפיין הזה יופיע רק אם הערך של המאפיין social.resourceId.kind הוא youtube#playlist. |
contentDetails.social.author |
stringהמחבר של הפוסט ברשת החברתית. |
contentDetails.social.referenceUrl |
stringכתובת ה-URL של הפוסט ברשת החברתית. |
contentDetails.social.imageUrl |
stringתמונה של יוצר הפוסט. |
contentDetails.channelItem |
objectהאובייקט channelItem מכיל פרטים על משאב שנוסף לערוץ. המאפיין הזה מופיע רק אם הערך של snippet.type הוא channelItem. |
contentDetails.channelItem.resourceId |
objectהאובייקט resourceId מכיל מידע שמזהה את המשאב שנוסף לערוץ. |