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