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