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
علامة 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.