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