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