تحظر هذه الإضافة مستخدمًا معيّنًا من المشاركة في المحادثة المباشرة. يجب أن يفوّض مالك القناة أو مشرف المحادثة المباشرة المرتبطة بالحظر طلب البيانات من واجهة برمجة التطبيقات.
حالات الاستخدام الشائعة
طلب
طلب 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. |
|
نص الطلب
قدِّم مورد liveChatBan في نص الطلب. بالنسبة إلى هذا المرجع:
-
يجب تحديد قيمة للسمات التالية:
snippet.liveChatId-
snippet.type: حدِّد أحد الخيارَين التاليَين:permanentأوtemporary 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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة.