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 ה-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 ערכי המפתח החוקיים הם: default – התמונה הממוזערת שמוגדרת כברירת מחדל. ברירת המחדל של התמונה הממוזערת של סרטון – או משאב שמפנה לסרטון, כמו פריט בפלייליסט או תוצאת חיפוש – היא רוחב של 120 פיקסלים וגובה של 90 פיקסלים. ברירת המחדל לתמונה הממוזערת של ערוץ היא רוחב של 88 פיקסלים וגובה של 88 פיקסלים. medium – גרסה ברזולוציה גבוהה יותר של התמונה הממוזערת. עבור סרטון (או משאב שמפנה לסרטון), התמונה הזו ברוחב 320 פיקסלים ובגובה של 180 פיקסלים. עבור ערוץ, התמונה הזו ברוחב 240 פיקסלים וגובה של 240 פיקסלים. high – גרסה ברזולוציה גבוהה של התמונה הממוזערת. עבור סרטון (או משאב שמפנה לסרטון), התמונה הזו ברוחב 480 פיקסלים ובגובה של 360 פיקסלים. עבור ערוץ, התמונה הזו ברוחב 800 פיקסלים ובגובה של 800 פיקסלים. standard – גרסה ברזולוציה גבוהה עוד יותר של התמונה הממוזערת של התמונה ברזולוציה של high. התמונה הזו זמינה לסרטונים מסוימים ולמשאבים אחרים שמתייחסים לסרטונים, כמו פריטים בפלייליסט או תוצאות חיפוש. התמונה ברוחב 640 פיקסלים ובגובה של 480 פיקסלים. maxres – הגרסה ברזולוציה הגבוהה ביותר של התמונה הממוזערת. גודל התמונה הזה זמין לסרטונים מסוימים ולמשאבים אחרים הקשורים לסרטונים, כמו פריטים בפלייליסט או תוצאות חיפוש. התמונה ברוחב 1280 פיקסלים ובגובה של 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 מכיל מידע שמזהה את המשאב שנוסף לערוץ.