Comments: setModerationStatus

يضبط هذا الإجراء حالة الإشراف على تعليق واحد أو أكثر. يجب أن يكون طلب بيانات من واجهة برمجة التطبيقات مأذونًا من قِبل مالك القناة أو الفيديو المرتبطَين بالتعليقات.

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

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

طلب

طلب HTTP

POST https://www.googleapis.com/youtube/v3/comments/setModerationStatus

التفويض

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

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

المعلمات

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

المعلمات
المعلمات المطلوبة
id string
تحدّد المَعلمة id قائمة قيم مفصولة بفاصلة تضم ما يصل إلى 50 معرّفًا للتعليقات التي تريد تعديل حالة الإشراف عليها.
moderationStatus string
تحدّد حالة الإشراف الجديدة للتعليقات المحدّدة.

القيم المقبولة هي:
  • heldForReview : يضع علامة على التعليق للإشارة إلى أنّه بانتظار مراجعة أحد المشرفين.
  • published : يسمح بعرض التعليق علنًا. لا يمكنك تغيير حالة الإشراف على تعليق مرفوض إلى published.
  • rejected : يرفض التعليق باعتباره غير ملائم للعرض. يؤدي هذا الإجراء أيضًا إلى إخفاء جميع الردود على التعليق المرفوض. لإزالة تعليق كتبه مستخدم آخر من قناتك أو الفيديو، اضبط حالة الإشراف عليه على rejected. لا يمكن استخدام طريقة comments.delete إلا من قِبل مؤلّف التعليق الأصلي.
المعلمات الاختيارية
banAuthor boolean
تتيح لك المَعلمة banAuthor الإشارة إلى أنّك تريد رفض أي تعليقات إضافية يكتبها مؤلّف التعليق تلقائيًا. اضبط قيمة المَعلمة على true لحظر المؤلّف.

لا تكون هذه المَعلمة صالحة إلا إذا تم ضبط المَعلمة moderationStatus أيضًا على rejected.

نص الطلب

لا تُدرِج نص طلب عند استدعاء هذه الطريقة.

الردّ

في حال نجاح هذه الطريقة، تعرض رمز استجابة HTTP 204 (No Content).

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
badRequest (400) banWithoutReject لا يمكن استخدام المَعلمة banAuthor إلا إذا كانت قيمة المَعلمة moderationStatus هي rejected.
badRequest (400) operationNotSupported لا تتوفّر إلا وظائف إشراف محدودة للتعليقات التي لا تستند إلى عرض Google+.
badRequest (400) processingFailure تعذّر على خادم واجهة برمجة التطبيقات معالجة الطلب بنجاح. على الرغم من أنّ هذا الخطأ قد يكون مؤقتًا، يشير عادةً إلى أنّ الإدخال في الطلب غير صالح. يتم عرض هذا الخطأ أيضًا عند محاولة الإشراف على تعليق سبق أن حذفه المعلِّق الأصلي.
forbidden (403) forbidden لا يمكن ضبط حالة الإشراف على تعليق واحد أو أكثر بسبب عدم توفّر أذونات كافية. قد لا يكون الطلب مأذونًا. يتم عرض هذا الخطأ أيضًا عند محاولة الإشراف على تعليق محذوف أو معرّف تعليق غير صالح.
notFound (404) commentNotFound لا يمكن العثور على تعليق واحد أو أكثر من التعليقات التي يحاول الطلب تعديلها. تحقَّق من قيم المَعلمة id في الطلب للتأكّد من أنّها صحيحة.

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

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