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 התג של המשאב הזה.
id	string המזהה שמשמש את YouTube לזיהוי ייחודי של שרשור התגובות.
snippet	object האובייקט snippet מכיל פרטים בסיסיים על שרשור התגובות. יש בו גם תגובה ברמה העליונה של השרשור, שהיא משאב מסוג comment.
snippet.channelId	string ערוץ YouTube המשויך לתגובות בשרשור. (הנכס snippet.videoId מזהה את הסרטון.) אם התגובות עוסקות בסרטון, הערך מזהה את הערוץ שהעלה את הסרטון. (הנכס snippet.videoId מזהה את הסרטון.) אם התגובות מתייחסות לערוץ עצמו, לנכס 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 כדי לזהות את התגובה שעבורה ברצונך לאחזר את התגובות.