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

نص الطلب

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

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

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

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

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

الإجابة

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

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
badRequest (400) channelOrVideoIdMissing يجب ربط كل سلسلة محادثات بقناة أو فيديو.
  • إذا كان التعليق ينطبق على قناة، احرص على أن يقدّم المورد المحدّد في نص الطلب قيمة للسمة snippet.channelId. يظهر التعليق الذي ينطبق على قناة في علامة التبويب مناقشة في القناة.
  • إذا كان التعليق ينطبق على فيديو، احرص على أن يحدّد المورد قيمتَي السمتَين 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 لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.