LiveChatBans

Resource liveChatBan mengidentifikasi pengguna YouTube dan live chat YouTube tempat pengguna tersebut dilarang berpartisipasi.

Metode

API mendukung metode berikut untuk resource liveChatBans:

masukkan
Memblokir pengguna tertentu agar tidak dapat berpartisipasi dalam live chat. Permintaan API harus diotorisasi oleh pemilik channel atau moderator live chat yang terkait dengan pemblokiran. Coba sekarang.
hapus
Menghapus pemblokiran yang mencegah pengguna tertentu berkontribusi ke live chat, sehingga memungkinkan pengguna bergabung kembali ke chat. Permintaan API harus diotorisasi oleh pemilik channel atau moderator live chat yang terkait dengan pemblokiran. Coba sekarang.

Representasi resource

Struktur JSON berikut menunjukkan format resource liveChatBans:

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

Properti

Tabel berikut menentukan properti yang muncul di resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya adalah youtube#liveChatBan.
etag etag
Etag resource ini.
id string
ID yang ditetapkan YouTube untuk mengidentifikasi pemblokiran secara unik.
snippet object
Objek snippet mengidentifikasi pengguna yang diblokir dan berisi detail tentang pemblokiran.
snippet.liveChatId string
Live chat yang memberlakukan larangan tersebut. ID live chat yang terkait dengan siaran ditampilkan di properti snippet.liveChatId resource liveBroadcast.
snippet.type string
Jenis pemblokiran.

Nilai yang valid untuk properti ini adalah:
  • permanent
  • temporary
snippet.banDurationSeconds unsigned long
Durasi pemblokiran. Hanya tetapkan nilai untuk properti ini jika jenis pemblokirannya adalah temporary. Nilai defaultnya adalah 300 (5 menit).
snippet.bannedUserDetails object
Objek ini berisi informasi yang mengidentifikasi pengguna yang diblokir.
snippet.bannedUserDetails.channelId string
ID channel YouTube pengguna yang diblokir.