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