CommentThreads

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

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

שיטות

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