משאב 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מכיל מידע שמזהה את המשאב שנוסף לערוץ. |