CommentThreads

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

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

روش‌ها

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

فهرست

فهرستی از رشته‌های نظر را که با پارامترهای درخواست 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 نوع منبع «میانای برنامه‌سازی کاربردی» را مشخص می‌کند. مقدار 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 برای شناسایی نظری که می‌خواهید پاسخ‌های آن را بازیابی کنید استفاده کنید.