CommentThreads: insert

يؤدي هذا الإجراء إلى إنشاء تعليق جديد على المستوى الأعلى. لإضافة ردّ على تعليق حالي، استخدِم طريقة comments.insert بدلاً من ذلك.

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

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

طلب

طلب HTTP

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

التفويض

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

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

المعلمات

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

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

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

نص الطلب

قدِّم مورد commentThread في نص الطلب.

بالنسبة إلى هذا المورد، يجب تحديد قيمة للخصائص التالية:

  • snippet.channelId
  • snippet.videoId
  • snippet.topLevelComment.snippet.textOriginal

الردّ

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

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
badRequest (400) channelOrVideoIdMissing يجب ربط كل سلسلة تعليقات بفيديو. تأكَّد من أنّ المورد يحدّد قيمًا للسمتَين snippet.channelId وsnippet.videoId. يظهر تعليق على فيديو في صفحة المشاهدة الخاصة بالفيديو.
badRequest (400) commentTextRequired يجب أن يحدّد مورد comment الذي يتم إدراجه قيمة للسمة snippet.topLevelComment.snippet.textOriginal. لا يمكن أن تكون التعليقات فارغة.
badRequest (400) commentTextTooLong يحتوي مورد comment الذي يتم إدراجه على عدد كبير جدًا من الأحرف في السمة snippet.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata بيانات الطلب الوصفية غير صالحة.
badRequest (400) processingFailure تعذّر على خادم واجهة برمجة التطبيقات معالجة الطلب بنجاح. على الرغم من أنّ هذا الخطأ قد يكون مؤقتًا، يشير عادةً إلى أنّ الإدخال في الطلب غير صالح. تحقَّق من بنية مورد commentThread في نص الطلب للتأكّد من أنّه صالح.
forbidden (403) forbidden تعذّر إنشاء سلسلة التعليقات بسبب عدم توفّر أذونات كافية. قد لا يكون الطلب مُصرّحًا به بشكل صحيح.
forbidden (403) ineligibleAccount يجب دمج حساب YouTube المستخدَم لتفويض طلب بيانات من واجهة برمجة التطبيقات مع حساب Google للمستخدم لإدراج تعليق أو سلسلة تعليقات.
notFound (404) channelNotFound تعذّر العثور على القناة المحدّدة. تحقَّق من قيمة السمة snippet.channelId للتأكّد من أنّها صحيحة.
notFound (404) videoNotFound تعذّر العثور على الفيديو المحدّد. تحقَّق من قيمة السمة snippet.videoId للتأكّد من أنّها صحيحة.

جرِّبها الآن.

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