إزالة الحظر الذي يمنع مستخدمًا محددًا من المشاركة في محادثة مباشرة، ما يتيح للمستخدم إعادة الانضمام إلى المحادثة يجب أن يكون طلب البيانات من واجهة برمجة التطبيقات معتمَدًا من مالك القناة أو المشرف على المحادثة المباشرة المرتبطة بالحظر.
حالات الاستخدام الشائعة
الطلب
طلب HTTP
DELETE https://www.googleapis.com/youtube/v3/liveChat/bans
التفويض
يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات عن المصادقة والترخيص).
| النطاق |
|---|
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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.