activities.list
עדיין לא מחזירים מבזקי ערוץ,
השיטה activities.insert
לא
למשך זמן ארוך יותר. פרטים נוספים זמינים
מרכז העזרה של YouTube
משאב activity
מכיל מידע על פעולה שבוצעה ב-YouTube על ידי ערוץ או משתמש מסוים. הפעולות שמדווחות בפידים של פעילויות כוללות דירוג סרטון, שיתוף סרטון, סימון סרטון כמועדף, העלאת סרטון וכן הלאה. כל משאב activity
מזהה את סוג הפעולה, את הערוץ המשויך לפעולה ואת המשאבים המשויכים לפעולה, כמו הסרטון דורג או הועלה.
שיטות
ה-API תומך ב-methods הבאות למשאבים של activities
:
- list
- מחזירה רשימה של אירועי פעילות בערוץ שתואמים לקריטריונים של הבקשה. לדוגמה, תוכלו לאחזר אירועים שמשויכים לערוץ מסוים או לערוץ של המשתמש עצמו. כדאי לנסות עכשיו.
השיטה activities.insert
כבר לא נתמכת.
ייצוג משאבים
במבנה הבא של 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 מכיל מידע שמזהה את המשאב שנוסף לערוץ. |