يحتوي مورد comment
على معلومات حول تعليق واحد على YouTube. يمكن أن يمثّل مورد comment
تعليقًا حول فيديو أو قناة. بالإضافة إلى ذلك، يمكن أن يكون التعليق تعليقًا من مستوى أعلى أو ردًا على تعليق من المستوى الأعلى.
الطُرق
تتيح واجهة برمجة التطبيقات استخدام الطرق التالية لموارد comments
:
- list
- عرض قائمة بالتعليقات التي تطابق معلَمات طلب البيانات من واجهة برمجة التطبيقات. التجربة الآن
- إدراج
- لإنشاء رد على تعليق حالي ملاحظة: لإنشاء تعليق من المستوى الأعلى، يمكنك استخدام الإجراء
commentThreads.insert
. التجربة الآن - تعديل
- لتعديل تعليق. التجربة الآن
- حذف
- حذف تعليق. التجربة الآن
- setModerationStatus
- لضبط حالة الإشراف على تعليق واحد أو أكثر. يجب أن يكون طلب البيانات من واجهة برمجة التطبيقات مصرّحًا به من مالك القناة أو الفيديو المرتبط بالتعليقات. التجربة الآن
- markAsSpam
- ملاحظة: تم إيقاف هذه الطريقة نهائيًا ولم تعُد متاحة.
- التعبير عن رأي المتصل بأنّه يجب الإبلاغ عن تعليق واحد أو أكثر كمحتوى غير مرغوب فيه.
تمثيل الموارد
تعرض بنية JSON التالية تنسيق مورد comments
:
{ "kind": "youtube#comment", "etag": etag, "id": string, "snippet": { "authorDisplayName": string, "authorProfileImageUrl": string, "authorChannelUrl": string, "authorChannelId": { "value": string }, "channelId": string, "textDisplay": string, "textOriginal": string, "parentId": string, "canRate": boolean, "viewerRating": string, "likeCount": unsigned integer, "moderationStatus": string, "publishedAt": datetime, "updatedAt": datetime } }
أماكن إقامة
يحدد الجدول التالي الخصائص التي تظهر في هذا المورد:
أماكن إقامة | |
---|---|
kind |
string يحدّد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#comment . |
etag |
etag علامة هذا المرجع. |
id |
string المعرّف الذي تستخدمه منصة YouTube لتحديد التعليق بشكل فريد |
snippet |
object يحتوي العنصر snippet على تفاصيل أساسية حول التعليق. |
snippet.authorDisplayName |
string الاسم المعروض للمستخدم الذي نشر التعليق. |
snippet.authorProfileImageUrl |
string تشير هذه السمة إلى عنوان URL للصورة الرمزية للمستخدم الذي نشر التعليق. |
snippet.authorChannelUrl |
string تشير هذه السمة إلى عنوان URL الخاص بالقناة الخاصة بمؤلف التعليق على YouTube، في حال توفّرها. |
snippet.authorChannelId |
object يضم هذا العنصر معلومات حول القناة الخاصة بمؤلف التعليق على YouTube، في حال توفّرها. |
snippet.authorChannelId.value |
string تمثّل هذه السمة معرّف القناة الخاصة بمؤلف التعليق على YouTube، في حال توفّرها. |
snippet.channelId |
string معرّف قناة YouTube المرتبطة بالتعليق |
snippet.textDisplay |
string نص التعليق: ويمكن استرداد النص بتنسيق نص عادي أو بتنسيق HTML. (تتيح كلتا الطريقتين comments.list وcommentThreads.list استخدام المَعلمة textFormat التي تحدّد تنسيق النص المُختار.)قد يختلف النص العادي أيضًا عن نص التعليق الأصلي. على سبيل المثال، قد يستبدل روابط الفيديوهات بعناوين الفيديوهات. |
snippet.textOriginal |
string النص الأصلي الأولي للتعليق كما تم نشره في البداية أو آخر تعديل له. لا يتم عرض النص الأصلي للمستخدم الذي تمت المصادقة عليه إلا إذا كان مؤلف التعليق. |
snippet.parentId |
string المعرّف الفريد للتعليق الرئيسي. يتم ضبط هذه السمة فقط إذا تم إرسال التعليق كرد على تعليق آخر. |
snippet.canRate |
boolean يحدد هذا الخيار ما إذا كان المشاهد الحالي يمكنه تقييم التعليق. |
snippet.viewerRating |
string تشير هذه السمة إلى التقييم الذي قدّمه المشاهد لهذا التعليق. لا تحدّد هذه السمة تقييمات " dislike "، ولكنّ هذا السلوك عرضة للتغيير. وفي الوقت الحالي، تكون قيمة السمة like إذا قيّم المستخدم التعليق بشكل إيجابي. وتبلغ القيمة none في جميع الحالات الأخرى، بما في ذلك المستخدم الذي أعطى التعليق تقييمًا سلبيًا أو لم يقيّمه.القيم الصالحة لهذه السمة هي:
|
snippet.likeCount |
unsigned integer إجمالي عدد المعجبين (التقييمات الإيجابية) بالتعليق |
snippet.moderationStatus |
string حالة الإشراف على التعليق يتم عرض هذه السمة فقط إذا كان طلب البيانات من واجهة برمجة التطبيقات معتمَدًا من مالك القناة أو من الفيديو الذي تم تقديم التعليقات المطلوبة عليه. ولا يتم ضبط هذه السمة أيضًا إذا كان طلب البيانات من واجهة برمجة التطبيقات يستخدم مَعلمة الفلتر id .في ما يلي القيم الصالحة لهذا الموقع:
|
snippet.publishedAt |
datetime تاريخ ووقت نشر التعليق بشكل طبيعي ويتم تحديد القيمة بتنسيق ISO 8601. |
snippet.updatedAt |
datetime تمثّل هذه السمة تاريخ ووقت آخر تعديل على التعليق. ويتم تحديد القيمة بتنسيق ISO 8601. |