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