يزيل هذا الطلب حظرًا يمنع مستخدمًا معيّنًا من المساهمة في محادثة مباشرة، ما يتيح له الانضمام إلى المحادثة مجددًا. يجب أن يكون طلب بيانات من واجهة برمجة التطبيقات مأذونًا به من قِبل مالك القناة أو مشرف المحادثة المباشرة المرتبطة بالحظر.
حالات الاستخدام الشائعة
طلب
طلب HTTP
DELETE 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 |
المعلمات
يعرض الجدول التالي المعلمات التي يتيحها طلب البحث هذا. وجميع المعلمات المدرَجة هي معلمات طلب بحث.
| المعلمات | ||
|---|---|---|
| المعلمات المطلوبة | ||
id |
stringتحدّد المَعلمة id حظر المحادثة المطلوب إزالته. وتحدّد القيمة بشكلٍ فريد كلاً من الحظر والمحادثة. |
|
نص الطلب
يجب عدم تقديم نص طلب عند استدعاء هذه الطريقة.
الردّ
في حال نجاح هذه الطريقة، تعرض رمز حالة HTTP 204 No Content.
الأخطاء
يعرض الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على طلب استدعاء هذه الطريقة. لمزيد من التفاصيل، يُرجى الاطّلاع على رسالة الخطأ.
| نوع الخطأ | تفاصيل الخطأ | الوصف |
|---|---|---|
forbidden (403) |
forbidden |
لا يمكن إزالة الحظر المحدّد. يمكن أن يظهر هذا الخطأ إذا كان الطلب مأذونًا به من قِبل مشرف واحد يحاول إزالة حظر مفروض على مشرف آخر. |
forbidden (403) |
insufficientPermissions |
ليست لديك الأذونات اللازمة لإزالة الحظر المحدّد. |
invalidValue (400) |
invalidLiveChatBanId |
تحدّد المَعلمة id قيمة غير صالحة. |
notFound (404) |
liveChatBanNotFound |
تعذّر العثور على الحظر المحدّد. |
جرِّبها الآن.
استخدِم APIs Explorer لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب بيانات من واجهة برمجة التطبيقات والردّ عليها.