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