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 لتحديد التعليق الذي تريد استرداد الردود له.