Comments: insert

لإنشاء رد على تعليق حالي ملاحظة: لإنشاء تعليق من المستوى الأعلى، يمكنك استخدام الإجراء 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 التي يمكنك تضمينها في قيمة المَعلمة:
  • id
  • snippet

نص الطلب

وفِّر مرجعًا للتعليق في نص الطلب. بالنسبة لهذا المورد:

  • يجب تحديد قيمة لهذه السمات:

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