LiveChatBans

یک منبع liveChatBan کاربر YouTube و چت زنده YouTube را که کاربر از شرکت در آن منع شده است، شناسایی می‌کند.

روش‌ها

«میانای برنامه‌سازی کاربردی» از روش‌های زیر برای منابع liveChatBans پشتیبانی می‌کند:

درج
کاربر خاصی را از شرکت در گپ مستقیم منع می‌کند. درخواست میانای برنامه‌سازی کاربردی باید توسط مالک کانال یا گرداننده گپ مستقیم مرتبط با ممنوعیت مجاز شود. اکنون امتحان کنید.
حذف
ممنوعیتی را که مانع از مشارکت کاربر خاصی در گپ مستقیم می‌شود برمی‌دارد و درنتیجه کاربر می‌تواند دوباره به گپ بپیوندد. درخواست API باید توسط مالک کانال یا یک مدیر گپ زنده مرتبط با ممنوعیت مجاز شود. اکنون امتحان کنید.

نمایش منبع

ساختار 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 (۵ دقیقه) است.
snippet.bannedUserDetails object
این شیء حاوی اطلاعاتی است که کاربر ممنوع‌شده را شناسایی می‌کند.
snippet.bannedUserDetails.channelId string
شناسه کانال YouTube کاربر ممنوع‌شده.