لتعديل تعليق.
التأثير على الحصة: إنّ استدعاء هذه الطريقة له تكلفة حصة قدرها 50 وحدة.
حالات الاستخدام الشائعة
طلب
طلب HTTP
PUT https://www.googleapis.com/youtube/v3/comments
التفويض
ويتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (اقرأ المزيد عن المصادقة والتفويض).
النطاق |
---|
https://www.googleapis.com/auth/youtube.force-ssl |
المعلَمات
يسرد الجدول التالي المعلمات التي يدعمها طلب البحث هذا. جميع المعلمات المدرجة هي معلمات طلب بحث.
المعلَمات | ||
---|---|---|
المعلّمات المطلوبة | ||
part |
string تحدّد المعلمة part الخصائص التي ستشملها استجابة واجهة برمجة التطبيقات. يجب تضمين الجزء snippet على الأقل في قيمة المعلّمة لأنّ هذا الجزء يحتوي على كل المواقع الإلكترونية التي يمكن لطلب واجهة برمجة التطبيقات تعديلها.تحتوي القائمة التالية على أسماء part التي يمكنك تضمينها في قيمة المعلّمة:
|
نص الطلب
قدِّم مورد تعليق في نص الطلب. بالنسبة إلى هذا المورد:
-
يمكنك تعيين قيم للخصائص التالية:
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 لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.