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