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