Activities

YouTube הוציא משימוש את תכונת מבזק הערוץ. השיטה 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 ערכי המפתח החוקיים הם: default – התמונה הממוזערת המוגדרת כברירת מחדל. התמונה הממוזערת המוגדרת כברירת מחדל של סרטון – או משאב שמפנה לסרטון, כמו פריט בפלייליסט או תוצאת חיפוש – היא ברוחב של 120 פיקסלים ובגובה של 90 פיקסלים. התמונה הממוזערת שמוגדרת כברירת מחדל לערוץ היא ברוחב 88 פיקסלים וגובה של 88 פיקסלים. medium – גרסה של התמונה הממוזערת ברזולוציה גבוהה יותר. לסרטון (או למקור מידע שמפנה לסרטון), רוחב התמונה הוא 320 פיקסלים וגובהה הוא 180 פיקסלים. כשמדובר בערוץ, התמונה הזו היא ברוחב של 240 פיקסלים ובגובה של 240 פיקסלים. high – גרסה של התמונה הממוזערת ברזולוציה גבוהה. לסרטון (או משאב שמפנה לסרטון), רוחב התמונה הוא 480 פיקסלים וגובהה הוא 360 פיקסלים. כשמדובר בערוץ, התמונה הזו היא ברוחב של 800 פיקסלים ובגובה של 800 פיקסלים. standard – גרסה ברזולוציה גבוהה עוד יותר של התמונה הממוזערת מזו של התמונה ברזולוציה של high. התמונה הזו זמינה לסרטונים מסוימים ולמקורות מידע אחרים שקשורים לסרטונים, כמו פריטים בפלייליסט או תוצאות חיפוש. רוחב התמונה הוא 640 פיקסלים וגובהה הוא 480 פיקסלים. maxres – הגרסה ברזולוציה הגבוהה ביותר של התמונה הממוזערת. גודל התמונה הזה זמין לסרטונים מסוימים ולמשאבים אחרים שמתייחסים לסרטונים, כמו פריטים בפלייליסט או תוצאות חיפוש. הרוחב של התמונה הזו הוא 1,280 פיקסלים וגובה של 720 פיקסלים.
snippet.thumbnails.(key).url	string כתובת ה-URL של התמונה.
snippet.thumbnails.(key).width	unsigned integer רוחב התמונה.
snippet.thumbnails.(key).height	unsigned integer גובה התמונה.
snippet.channelTitle	string שם הערוץ של הערוץ שאחראי לפעילות הזו
snippet.type	string סוג הפעילות שמתואר במשאב. הערכים החוקיים לנכס הזה הם: channelItem comment - (לא מוחזר כרגע) favorite like playlistItem promotedItem recommendation social subscription upload bulletin (הוצא משימוש)
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 הסיבה לכך שהמשאב מומלץ למשתמש. הערכים החוקיים לנכס הזה הם: videoFavorited videoLiked videoWatched
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 השם של הרשת החברתית. הערכים החוקיים לנכס הזה הם: facebook googlePlus twitter unspecified
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 מכיל מידע שמזהה את המשאב שנוסף לערוץ.