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 כדי לזהות את התגובה שעבורה רוצים לאחזר תשובות.