يعبّر عن رأي المتصل بضرورة وضع علامة على تعليق واحد أو أكثر كمحتوى غير مرغوب فيه.
تأثير الحصة: تحتوي إحدى المكالمات إلى هذه الطريقة على تكلفة حصة تبلغ 50 وحدة.
حالات الاستخدام الشائعة
الطلب
طلب HTTP
POST https://www.googleapis.com/youtube/v3/comments/markAsSpam
التفويض
يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات عن المصادقة والترخيص).
| النطاق |
|---|
https://www.googleapis.com/auth/youtube.force-ssl |
المَعلمات
يسرد الجدول التالي المعلَمات التي يتيحها طلب البحث هذا. كلّ المَعلمات المدرَجة هي مَعلمات طلب بحث.
| المَعلمات | ||
|---|---|---|
| المَعلمات المطلوبة | ||
id |
stringتحدّد المَعلمة id قائمة بأرقام تعريف التعليقات مفصولة بفواصل يعتقد المتصل أنّه يجب تصنيفها كرسائل غير مرغوب فيها. |
|
نص الطلب
لا تقدِّم نص طلب عند استدعاء هذه الطريقة.
الإجابة
في حال نجاحها، تعرض هذه الطريقة رمز استجابة HTTP 204 (No Content).
الأخطاء
يحدّد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات استجابةً لطلب بيانات إلى هذه الطريقة. يُرجى الاطّلاع على وثائق رسالة الخطأ للحصول على مزيد من التفاصيل.
| نوع الخطأ | تفاصيل الخطأ | الوصف |
|---|---|---|
badRequest (400) |
operationNotSupported |
لا يمكن وضع علامة على التعليقات غير المستندة إلى Google+ كغير مرغوب فيها. |
badRequest (400) |
processingFailure |
تعذّر على خادم واجهة برمجة التطبيقات معالجة الطلب بنجاح. وعلى الرغم من أن هذا الخطأ قد يكون عابرًا، إلا أنه يشير عادةً إلى أن ما تم إدخاله في الطلب غير صالح. |
forbidden (403) |
forbidden |
تعذّر وضع علامة على تعليق واحد أو أكثر كمحتوى غير مرغوب فيه بسبب عدم كفاية الأذونات. قد يكون الطلب غير مفوَّض بشكل صحيح. |
notFound (404) |
commentNotFound |
يتعذّر العثور على تعليق واحد أو أكثر من التعليقات التي يحاول الطلب تعديلها. افحص القيم في معلمة id للطلب للتأكد من صحتها. |
تجربة
يمكنك استخدام APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.