CommentThreads

یک منبع commentThread حاوی اطلاعاتی در مورد یک موضوع نظر YouTube است که شامل یک نظر سطح بالا است و در صورت وجود، به آن نظر پاسخ می دهد. منبع commentThread نظرات یک ویدیو را نشان می دهد.

هر دو نظر سطح بالا و پاسخ ها در واقع منابع comment هستند که در منبع commentThread تو در تو قرار گرفته اند. منبع commentThread لزوماً شامل همه پاسخ‌های یک نظر نیست و اگر می‌خواهید همه پاسخ‌ها را برای یک نظر خاص بازیابی کنید، باید از روش comments.list استفاده کنید. برخی از نظرات پاسخی ندارند.

مواد و روش ها

API از روش های زیر برای منابع commentThreads پشتیبانی می کند:

list

فهرستی از رشته‌های نظر را برمی‌گرداند که با پارامترهای درخواست API مطابقت دارند. الآن امتحانش کن .

insert

یک نظر سطح بالای جدید ایجاد می کند. برای افزودن پاسخ به نظر موجود، به جای آن از روش 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 کانال یوتیوب که با نظرات موجود در موضوع مرتبط است. ویژگی 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 برای شناسایی نظری که می‌خواهید برای آن پاسخ‌ها را بازیابی کنید، استفاده کنید.