LiveChatBans

يحدِّد مرجع liveChatBan مستخدمًا على YouTube ومحادثة مباشرة على YouTube تم حظر المستخدم من المشاركة فيها.

الطُرق

تتيح واجهة برمجة التطبيقات الطرق التالية لموارد liveChatBans:

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

تمثيل الموارد

تعرض بنية JSON التالية تنسيق مورد liveChatBans:

{
  "kind": "youtube#liveChatBan",
  "etag": etag,
  "id": string,
  "snippet": {
    "liveChatId": string,
    "type": string,
    "banDurationSeconds": unsigned long,
    "bannedUserDetails": {
      "channelId": string
    }
  }
}

الخصائص

يحدِّد الجدول التالي السمات التي تظهر في هذا المرجع:

الخصائص
kind string
تُحدِّد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#liveChatBan.
etag etag
رقم تعريف Etag لهذا المرجع.
id string
المعرّف الذي تحدّده YouTube لتحديد الحظر بشكل فريد
snippet object
يحدِّد عنصر snippet المستخدم المحظور ويحتوي على تفاصيل عن الحظر.
snippet.liveChatId string
المحادثة المباشرة التي ينطبق عليها الحظر يتم عرض معرّف المحادثة المباشرة المرتبط بالبث في سمة snippet.liveChatId لمصدر liveBroadcast.
snippet.type string
نوع الحظر.

في ما يلي القيم الصالحة لهذه السمة:
  • permanent
  • temporary
snippet.banDurationSeconds unsigned long
مدّة الحظر لا تضبط قيمة لهذه السمة إلا إذا كان نوع الحظر هو temporary. القيمة التلقائية هي 300 (5 دقائق).
snippet.bannedUserDetails object
يحتوي هذا العنصر على معلومات تحدّد المستخدم المحظور.
snippet.bannedUserDetails.channelId string
معرّف قناة المستخدم المحظور على YouTube.