إنشاء تعليق جديد في المستوى الأعلى. لإضافة رد على تعليق حالي، استخدم طريقة 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 التي يمكنك تضمينها في قيمة المعلمة:
|
نص الطلب
قدِّم مورد ThreadThread في نص الطلب. بالنسبة إلى هذا المورد:
-
يجب تحديد قيمة للخصائص التالية:
snippet.channelId
snippet.topLevelComment.snippet.textOriginal
-
يمكنك تعيين قيم للخصائص التالية:
snippet.channelId
snippet.videoId
snippet.topLevelComment.snippet.textOriginal
الإجابة
إذا نجحت هذه الطريقة، فإنها تعرض مورد ThreadThread في نص الاستجابة.
الأخطاء
يحدد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على استدعاء لهذه الطريقة. يرجى الاطلاع على وثائق رسالة الخطأ لمزيد من التفاصيل.
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
badRequest (400) |
channelOrVideoIdMissing |
يجب ربط كل سلسلة محادثات بقناة أو فيديو.
|
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 لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.