لإنشاء رد على تعليق حالي. ملاحظة: لإنشاء تعليق في المستوى الأعلى، يمكنك استخدام طريقة 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 التي يمكنك تضمينها في قيمة المعلمة:
|
نص الطلب
قدِّم مورد تعليق في نص الطلب. بالنسبة إلى هذا المورد:
-
يجب تحديد قيمة للخصائص التالية:
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 لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.