Comments: setModerationStatus

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

تأثير الحصة: عند إجراء استدعاء لهذه الطريقة، تكون تكلفة الحصة 50 وحدة.

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

الطلب

طلب HTTP

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

التفويض

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

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

المَعلمات

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

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

القيم المقبولة هي:
  • heldForReview – وضع علامة على تعليق بأنّه في انتظار المراجعة من قِبل المشرف
  • published – لمحو تعليق لعرضه بشكل علني.
  • rejected – لرفض تعليق باعتباره غير ملائم للعرض. يؤدي هذا الإجراء أيضًا إلى إخفاء كل الردود على التعليق المرفوض.
المَعلمات الاختيارية
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 لطلب البيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والردّ عليها.