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 لطلب البيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة.