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