CommentThreads

משאב commentThread מכיל מידע על שרשור תגובות ב-YouTube, שמורכב מתגובה ברמה העליונה לתגובה באותה תגובה, אם יש כאלה. משאב commentThread מייצג תגובות בסרטון.

גם התגובה ברמה העליונה וגם התשובות הן comment משאבים שמוצבים בתוך המשאב commentThread. המשאב commentThread לא בהכרח כולל את כל התשובות לתגובה. צריך להשתמש בשיטה comments.list אם רוצים לאחזר את כל התשובות לתגובה מסוימת. בחלק מהתגובות אין תשובות.

שיטות

ה-API תומך ב-methods הבאות למשאבים של commentThreads:

list

מחזירה רשימה של שרשורי תגובות שתואמים לפרמטרים של בקשת ה-API. כדאי לנסות עכשיו.

הוספה

יצירת תגובה חדשה ברמה העליונה. כדי להוסיף תשובה לתגובה קיימת, יש להשתמש בשיטה comments.insert. רוצים לנסות עכשיו?

ייצוג משאבים

במבנה ה-JSON מוצג הפורמט של משאב commentThreads:

{
  "kind": "youtube#commentThread",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "videoId": string,
    "topLevelComment": comments Resource,
    "canReply": boolean,
    "totalReplyCount": unsigned integer,
    "isPublic": boolean
  },
  "replies": {
    "comments": [
      comments Resource
    ]
  }
}

מאפיינים

בטבלה הבאה מוגדרים המאפיינים שמופיעים במשאב הזה:

מאפיינים
kind	string מזהה את הסוג של משאב ה-API. הערך יהיה youtube#commentThread.
etag	etag ה-Etag של משאב זה.
id	string המזהה שמשמש את YouTube לזיהוי ייחודי של שרשור התגובות.
snippet	object האובייקט snippet מכיל פרטים בסיסיים על שרשור התגובות. הוא מכיל גם את התגובה ברמה העליונה של השרשור, שהיא משאב comment.
snippet.channelId	string ערוץ YouTube שמשויך לתגובות בשרשור. המאפיין snippet.videoId מזהה את הסרטון.
snippet.videoId	string מזהה הסרטון שאליו מתייחסות התגובות.
snippet.topLevelComment	object התגובה ברמה העליונה של השרשור. ערך הנכס הוא משאב comment.
snippet.canReply	boolean ההגדרה הזו מציינת אם הצופה הנוכחי יכול להשיב לשרשור.
snippet.totalReplyCount	unsigned integer המספר הכולל של תשובות שנשלחו בתגובה לתגובה ברמה העליונה.
snippet.isPublic	boolean ההגדרה הזו מציינת אם השרשור, כולל כל התגובות והתשובות לתגובות, גלוי לכל משתמשי YouTube.
replies	object האובייקט replies הוא מאגר שמכיל רשימה של תשובות לתגובה, אם יש כזו. המאפיין replies.comments מייצג את רשימת התגובות עצמה.
replies.comments[]	list רשימה של תשובה אחת או יותר לתגובה ברמה העליונה. כל פריט ברשימה הוא משאב מסוג comment. הרשימה מכילה מספר מוגבל של תשובות. אם מספר הפריטים ברשימה שווה לערך של הנכס snippet.totalReplyCount, רשימת התשובות היא רק קבוצת משנה מתוך מספר התשובות הכולל שזמינות לתגובה ברמה העליונה. כדי לאחזר את כל התשובות לתגובה ברמה העליונה, צריך להפעיל את השיטה comments.list ולהשתמש בפרמטר הבקשה parentId כדי לזהות את התגובה שעבורה רוצים לאחזר תשובות.