Activities

התכונה 'מבזקי ערוץ' הוצאה משימוש ב-YouTube. השיטה 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
ערכי המפתח החוקיים הם:
  • 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 מכיל מידע שמזהה את המשאב שנוסף לערוץ.