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,
    "imageUrl": string
  }
}

الخصائص

يحدّد الجدول التالي السمات التي تظهر في هذا المرجع:

الخصائص
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.
snippet.imageUrl string
تمثّل هذه السمة عنوان URL للصورة أو صورة GIF متحرّكة المُرفَق بالتعليق، إذا كان ذلك منطبقًا. لا تظهر هذه السمة إلا عندما يتضمّن التعليق صورة أو صورة GIF. يتم عرض عنوان URL كرابط موقَّع بمدة بقاء (TTL) تبلغ ست ساعات، وتنتهي صلاحيته بعد ست ساعات من استرجاعه.