Comments: update

يعدّل تعليقًا.

تأثير الحصة: تبلغ تكلفة الحصة لطلب هذه الطريقة 50 وحدة.

حالات الاستخدام الشائعة

طلب

طلب HTTP

PUT https://www.googleapis.com/youtube/v3/comments

التفويض

يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات عن المصادقة والتفويض).

النطاق
https://www.googleapis.com/auth/youtube.force-ssl

المعلمات

يعرض الجدول التالي المعلمات التي يتيحها طلب البحث هذا. وجميع المعلمات المدرَجة هي معلمات طلب بحث.

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

تحتوي القائمة التالية على أسماء part التي يمكنك تضمينها في قيمة المَعلمة:
  • id
  • snippet

نص الطلب

يُرجى تقديم مصدر تعليق في نص الطلب. بالنسبة إلى هذا المصدر:

  • يمكنك ضبط قيم الخصائص التالية:

    • snippet.textOriginal

الردّ

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

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
badRequest (400) commentTextTooLong يحتوي مصدر comment الذي يتم تعديله على عدد كبير جدًا من الأحرف في السمة snippet.textOriginal.
badRequest (400) invalidCommentMetadata بيانات الطلب الوصفية غير صالحة.
badRequest (400) operationNotSupported لا يمكن تعديل سوى التعليقات المستندة إلى Google+‎.
badRequest (400) processingFailure تعذّر على خادم واجهة برمجة التطبيقات معالجة الطلب بنجاح. على الرغم من أنّ هذا الخطأ قد يكون مؤقتًا، يشير عادةً إلى أنّ الإدخال في الطلب غير صالح. يُرجى التحقّق من بنية مصدر comment في نص الطلب للتأكّد من أنّه صالح.
forbidden (403) forbidden تعذّر تعديل التعليق بسبب عدم توفّر أذونات كافية. قد لا يكون الطلب مأذونًا بشكل صحيح.
forbidden (403) ineligibleAccount يجب دمج حساب YouTube المستخدَم لتفويض طلب بيانات من واجهة برمجة التطبيقات مع حساب Google الخاص بالمستخدم لتعديل تعليق أو سلسلة تعليقات.
notFound (404) commentNotFound تعذّر العثور على التعليق المحدّد. يُرجى التحقّق من قيمة السمة id في نص الطلب للتأكّد من أنّها صحيحة.

جرِّبها الآن.

استخدِم APIs Explorer لطلب واجهة برمجة التطبيقات هذه والاطّلاع على طلب بيانات من واجهة برمجة التطبيقات والاستجابة.