Comments

يحتوي مورد comment على معلومات حول تعليق واحد على YouTube. يمكن أن يمثّل مورد comment تعليقًا حول فيديو أو قناة. بالإضافة إلى ذلك، يمكن أن يكون التعليق تعليقًا رئيسيًا أو ردًا على تعليق رئيسي.

الطُرق

تتيح واجهة برمجة التطبيقات الطرق التالية لموارد comments:

list

تعرض هذه الطريقة قائمة بالتعليقات التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات. التجربة الآن

إدراج

إنشاء ردّ على تعليق حالي ملاحظة: لإنشاء تعليق على المستوى الأعلى، استخدِم الطريقة commentThreads.insert. جرِّب ذلك الآن.

تعديل

تعديل تعليق التجربة الآن

حذف

لحذف تعليق التجربة الآن

setModerationStatus

تضبط هذه الطريقة حالة الإشراف على تعليق واحد أو أكثر. يجب أن يوافق مالك القناة أو الفيديو المرتبطَين بالتعليقات على طلب واجهة برمجة التطبيقات. التجربة الآن

تمثيل الموارد

تعرض بنية 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 تمثّل هذه السمة علامة 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 في جميع الحالات الأخرى، بما في ذلك إذا قدّم المستخدم تقييمًا سلبيًا للتعليق أو لم يقيّم التعليق. القيم الصالحة لهذه السمة هي: like none
snippet.likeCount	unsigned integer تمثّل هذه السمة إجمالي عدد تسجيلات الإعجاب (التقييمات الإيجابية) التي تلقّاها التعليق.
snippet.moderationStatus	string تمثّل هذه السمة حالة الإشراف على التعليق. لا يتم عرض هذه السمة إلا إذا كان طلب البيانات من واجهة برمجة التطبيقات مصرحًا به من قِبل مالك القناة أو الفيديو الذي تم نشر التعليقات المطلوبة عليه. بالإضافة إلى ذلك، لا يتم ضبط هذه السمة إذا كان طلب واجهة برمجة التطبيقات يستخدم مَعلمة الفلتر id. القيم الصالحة لهذه السمة هي: heldForReview likelySpam published rejected
snippet.publishedAt	datetime تمثّل هذه السمة تاريخ ووقت نشر التعليق في الأصل. يتم تحديد القيمة بالتنسيق ISO 8601.
snippet.updatedAt	datetime تمثّل هذه السمة تاريخ ووقت إجراء التعديل الأخير على التعليق. يتم تحديد القيمة بالتنسيق ISO 8601.