CommentThreads

يحتوي مورد commentThread على معلومات حول سلسلة التعليقات في YouTube التي تتألف من تعليق وردود من المستوى الأعلى، إن توفّرت، على ذلك التعليق. يمثّل المرجع commentThread التعليقات المنشورة على فيديو معيّن.

يكون كل من التعليق ذي المستوى الأعلى والردود عبارة عن موارد comment مضمّنة في المورد commentThread. لا يحتوي المورد commentThread بالضرورة على جميع الردود على تعليق معيّن، ويجب استخدام الإجراء comments.list إذا أردت استرداد كل الردود على تعليق معيّن. لا تتوفّر ردود على بعض التعليقات.

الطُرق

تتيح واجهة برمجة التطبيقات استخدام الطرق التالية لموارد commentThreads:

list
عرض قائمة بسلاسل التعليقات التي تتطابق مع معلَمات طلب البيانات من واجهة برمجة التطبيقات. التجربة الآن
إدراج
إنشاء تعليق جديد ذي مستوى أعلى لإضافة رد على تعليق حالي، استخدِم طريقة 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
علامة هذا المرجع.
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 لتحديد التعليق الذي تريد استرداد الردود له.