إزالة الحظر الذي يمنع مستخدمًا معيّنًا من المساهمة في المحادثة المباشرة، وبالتالي تمكين المستخدم من الانضمام مرة أخرى إلى المحادثة يجب أن يوافق مالك القناة أو مشرف المحادثة المباشرة المرتبطة بالحظر على طلب البيانات من واجهة برمجة التطبيقات.
حالات الاستخدام الشائعة
الطلب
طلب 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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.