Comments

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