Comments: markAsSpam

تم إيقاف هذه الطريقة نهائيًا ولم تعد متاحة.

التعبير عن رأي المتصل بضرورة الإبلاغ عن تعليق واحد أو أكثر كمحتوى غير مرغوب فيه.

تأثير الحصة: ينتج عن الاستدعاء إلى هذه الطريقة تكلفة حصة تبلغ 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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.