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