LiveChatBans: insert

يحظِر مستخدمًا معيّنًا من المشاركة في المحادثة المباشرة. يجب أن يكون طلب البيانات من واجهة برمجة التطبيقات مفوَّضًا من قِبل مالك القناة أو مشرف المحادثة المباشرة المرتبطة بالحظر.

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

الطلب

طلب HTTP

POST https://www.googleapis.com/youtube/v3/liveChat/bans

التفويض

يتطلب هذا الطلب تفويضًا بنطاق واحد على الأقل من النطاقات التالية. للاطّلاع على مزيد من المعلومات حول المصادقة والتفويض، اطّلِع على مقالة تنفيذ مصادقة OAuth 2.0.

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

المعلمات

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

المعلمات
المَعلمات المطلوبة
part string
تخدم المَعلمة part غرضَين في هذه العملية. ويحدِّد السمات التي ستضبطها عملية الكتابة بالإضافة إلى السمات التي تعرضها استجابة واجهة برمجة التطبيقات. اضبط قيمة المَعلمة على snippet.

نص الطلب

قدِّم مرجعًا لميزة "حظر المحادثة المباشرة" في نص الطلب. بالنسبة إلى هذا المرجع:

  • يجب تحديد قيمة للسمات التالية:

    • snippet.liveChatId
    • snippet.type
    • snippet.bannedUserDetails.channelId

  • يمكنك ضبط قيم لهذه السمات:

    • snippet.banDurationSeconds

الردّ

إذا كانت الاستجابة ناجحة، تعرض هذه الطريقة مورد liveChatBan في نص الاستجابة.

الأخطاء

يحدِّد الجدول التالي رسائل الخطأ التي يمكن أن تعرِضها واجهة برمجة التطبيقات استجابةً لطلب موجَّه إلى هذه الطريقة. لمزيد من التفاصيل، يُرجى الاطّلاع على YouTube Live Streaming API - Errors.

نوع الخطأ تفاصيل الخطأ الوصف
forbidden (403) insufficientPermissions لا تملك الأذونات اللازمة لحظر مستخدم من المحادثة المباشرة المحدّدة.
forbidden (403) liveChatBanInsertionNotAllowed لا يمكن إنشاء الحظر المحدّد. يمكن أن يحدث هذا الخطأ إذا كان الطلب يحاول حظر مالك المحادثة أو مشرف آخر.
invalidValue (400) invalidChannelId لا يمكن العثور على معرّف القناة المحدّد.
invalidValue (400) invalidLiveChatId القيمة snippet.liveChatId المحدّدة في الطلب غير صالحة. تحقَّق من مورد liveBroadcast المرتبط للتأكّد من أنّك تستخدم القيمة الصحيحة.
notFound (404) liveChatNotFound لا يمكن العثور على المحادثة المباشرة المحدّدة. تحقَّق من مورد liveBroadcast المرتبط للتأكّد من ضبط قيمة snippet.liveChatId الصحيحة.
notFound (404) liveChatUserNotFound لا يمكن العثور على مستخدم المحادثة المباشرة الذي تحاول حظره.
required (400) bannedUserChannelIdRequired يجب أن يحدّد مورد liveChatBan الذي تم إرساله في نص الطلب قيمة للسمة snippet.bannedUserDetails.channelId.
required (400) liveChatIdRequired يجب أن يحدّد مورد liveChatBan الذي تم إرساله في نص الطلب قيمة للسمة snippet.liveChatId.

جرّب الآن

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