Comments: insert

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

التأثير على الحصة: إنّ استدعاء هذه الطريقة له تكلفة حصة قدرها 50 وحدة.

حالات الاستخدام الشائعة

طلب

طلب HTTP

POST https://www.googleapis.com/youtube/v3/comments

التفويض

ويتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (اقرأ المزيد عن المصادقة والتفويض).

النطاق
https://www.googleapis.com/auth/youtube.force-ssl

المعلَمات

يسرد الجدول التالي المعلمات التي يدعمها طلب البحث هذا. جميع المعلمات المدرجة هي معلمات طلب بحث.

المعلَمات
المعلّمات المطلوبة
part string
تحدّد المعلمة part الخصائص التي ستشملها استجابة واجهة برمجة التطبيقات. اضبط قيمة المَعلمة على snippet. يحتوي الجزء snippet على تكلفة حصة من وحدتين.

تحتوي القائمة التالية على أسماء part التي يمكنك تضمينها في قيمة المعلمة:
  • id
  • snippet

نص الطلب

قدِّم مورد تعليق في نص الطلب. بالنسبة إلى هذا المورد:

  • يجب تحديد قيمة للخصائص التالية:

    • snippet.textOriginal
    • snippet.parentId

  • يمكنك تعيين قيم للخصائص التالية:

    • snippet.textOriginal

الإجابة

إذا نجحت هذه الطريقة، فإنها تعرض مورد تعليق في نص الاستجابة.

الأخطاء

يحدد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على استدعاء لهذه الطريقة. يرجى الاطلاع على وثائق رسالة الخطأ لمزيد من التفاصيل.

نوع الخطأ تفاصيل الخطأ الوصف
badRequest (400) commentTextRequired يجب أن يحدد مورد comment الجاري إدراجه قيمة للسمة snippet.textOriginal. لا يمكن ترك التعليقات فارغة.
badRequest (400) commentTextTooLong يحتوي مورد comment الذي يتم إدراجه على عدد كبير جدًا من الأحرف في الخاصية snippet.textOriginal.
badRequest (400) invalidCustomEmoji يحتوي المورد comment الذي يتم إدراجه على رمز تعبيري مخصّص غير صالح.
badRequest (400) invalidCommentMetadata البيانات الوصفية للطلب غير صالحة.
badRequest (400) operationNotSupported لا يمكن لمستخدم واجهة برمجة التطبيقات إدراج تعليق ردًا على تعليق المستوى الأعلى الذي تم تحديده في الخاصية snippet.parentId. في مورد commentThread، تشير الخاصية snippet.canReply إلى ما إذا كان بإمكان المشاهد الحالي الرد على سلسلة المحادثات.
badRequest (400) parentCommentIsPrivate التعليق الرئيسي المحدد خاص. لا تتيح واجهة برمجة التطبيقات الردود على التعليقات الخاصة.
badRequest (400) parentIdMissing يجب ربط التعليق الذي يتم إدراجه بتعليق رئيسي. ومع ذلك، لم يحدّد المورد comment في نص طلب واجهة برمجة التطبيقات قيمةً للسمة snippet.parentId.
badRequest (400) processingFailure تعذّر على خادم واجهة برمجة التطبيقات معالجة الطلب بنجاح. على الرغم من أن هذا قد يكون خطأً مؤقتًا، فهو يشير عادةً إلى أن إدخال الطلب غير صالح. تحقَّق من بنية المورد comment في نص الطلب للتأكّد من صلاحيته.
forbidden (403) forbidden لا يمكن إنشاء التعليق لأن الأذونات غير كافية. قد يكون الطلب غير مصرح به بشكلٍ صحيح.
forbidden (403) ineligibleAccount يجب دمج حساب YouTube المستخدَم لتفويض طلب البيانات من واجهة برمجة التطبيقات مع حساب المستخدم على Google لإدراج تعليق أو سلسلة محادثات.
notFound (404) parentCommentNotFound تعذر العثور على التعليق الرئيسي المحدد. تحقّق من قيمة السمة snippet.parentId في نص الطلب للتأكّد من صحتها.

جرِّب هذه الميزة الآن.

يمكنك استخدام APIs Explorer لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.