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
Etag لهذا المورد.
id string
المعرّف الذي يستخدمه YouTube لتحديد سلسلة التعليقات بشكل فريد
snippet object
يحتوي الكائن snippet على التفاصيل الأساسية حول سلسلة التعليقات. ويتضمّن أيضًا تعليق المستوى الأعلى لسلسلة المحادثات، وهو مورد comment.
snippet.channelId string
قناة YouTube المرتبطة بالتعليقات في سلسلة المحادثات. (تحدّد السمة snippet.videoId الفيديو.)
  • إذا كانت التعليقات متعلقة بفيديو، فستحدد القيمة القناة التي حمّلت الفيديو. (تحدّد السمة snippet.videoId الفيديو.)
  • إذا كانت التعليقات تشير إلى القناة نفسها، لن يكون للسمة 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 لتحديد التعليق الذي تريد استرداد الردود عليه.