LiveChatBans
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zasób liveChatBan
identyfikuje użytkownika YouTube i czat na żywo w YouTube, w którym użytkownik został zablokowany.
Metody
Interfejs API obsługuje te metody dotyczące zasobów liveChatBans
:
- insert
- Zabrania konkretnemu użytkownikowi udziału w czacie na żywo. Żądanie wywołania interfejsu API musi zostać autoryzowane przez właściciela kanału lub moderatora czatu na żywo powiązanego z zablokowaniem.
Wypróbuj teraz
- usuń
- Odblokowuje użytkownika, który został wcześniej zablokowany i nie mógł korzystać z czatu na żywo, dzięki czemu może on ponownie dołączyć do czatu. Żądanie wywołania interfejsu API musi zostać autoryzowane przez właściciela kanału lub moderatora czatu na żywo powiązanego z zablokowaniem.
Wypróbuj teraz
Właściwości
Właściwości występujące w tym zasobie są opisane w tabeli poniżej:
Właściwości |
kind |
string Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#liveChatBan . |
etag |
etag Etag tego zasobu. |
id |
string Identyfikator przypisany przez YouTube do jednoznacznego zidentyfikowania zablokowanego konta. |
snippet |
object Obiekt snippet identyfikuje zablokowanego użytkownika i zawiera szczegółowe informacje o blokadzie. |
snippet.liveChatId |
string Czat na żywo, którego dotyczy blokada. Identyfikator czatu na żywo powiązany z transmisją jest zwracany w właściwości snippet.liveChatId zasobu liveBroadcast . |
snippet.type |
string Typ zakazu.
Dozwolone wartości tej właściwości to:
|
snippet.banDurationSeconds |
unsigned long Czas trwania blokady. Ustaw wartość tej właściwości tylko wtedy, gdy typ zakazu to temporary . Wartość domyślna to 300 (5 minut). |
snippet.bannedUserDetails |
object Ten obiekt zawiera informacje, które identyfikują zablokowanego użytkownika. |
snippet.bannedUserDetails.channelId |
string Identyfikator kanału YouTube zablokowanego użytkownika. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-06-06 UTC.
[null,null,["Ostatnia aktualizacja: 2025-06-06 UTC."],[[["\u003cp\u003eA \u003ccode\u003eliveChatBan\u003c/code\u003e resource identifies a YouTube user who is banned from a specific YouTube live chat.\u003c/p\u003e\n"],["\u003cp\u003eThe API allows channel owners or moderators to insert a \u003ccode\u003eliveChatBan\u003c/code\u003e to ban a user or delete one to remove the ban.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003eliveChatBan\u003c/code\u003e can be either permanent or temporary, and the duration of a temporary ban can be specified in seconds.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eliveChatBan\u003c/code\u003e resource's \u003ccode\u003esnippet\u003c/code\u003e object includes the ID of the live chat, the type of ban, the ban duration (if temporary), and details of the banned user.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eliveChatBan\u003c/code\u003e resource has properties such as \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eetag\u003c/code\u003e, and \u003ccode\u003eid\u003c/code\u003e, which provide general information about the resource, such as the resource type, its ETag, and the ban's unique ID.\u003c/p\u003e\n"]]],["The `liveChatBan` resource manages user bans in YouTube live chats. Key actions include: inserting a ban (`insert`) to prevent a user from participating, and deleting a ban (`delete`) to allow a user to rejoin. The resource identifies the banned user, the live chat, ban type (`permanent` or `temporary`), and ban duration in seconds. The resource properties include `kind`, `etag`, and `id`. Authorization from the channel owner or a moderator is required for both inserting and deleting.\n"],null,["# LiveChatBans\n\nA **liveChatBan** resource identifies a YouTube user and a YouTube live chat that the user is banned from participating in.\n\nMethods\n-------\n\nThe API supports the following methods for `liveChatBans` resources:\n\n[insert](/youtube/v3/live/docs/liveChatBans/insert)\n: Bans a specific user from participating in the live chat. The API request must be authorized by the channel owner or a moderator of the live chat associated with the ban.\n [Try it now](/youtube/v3/live/docs/liveChatBans/insert#try-it).\n\n[delete](/youtube/v3/live/docs/liveChatBans/delete)\n: Removes a ban that prevents a specific user from contributing to a live chat, thereby enabling the user to rejoin the chat. The API request must be authorized by the channel owner or a moderator of the live chat associated with the ban.\n [Try it now](/youtube/v3/live/docs/liveChatBans/delete#try-it).\n\nResource representation\n-----------------------\n\nThe following JSON structure shows the format of a `liveChatBans` resource: \n\n```carbon\n{\n \"#kind\": \"youtube#liveChatBan\",\n \"#etag\": etag,\n \"#id\": string,\n \"#snippet\": {\n \"#snippet.liveChatId\": string,\n \"#snippet.type\": string,\n \"#snippet.banDurationSeconds\": unsigned long,\n \"#snippet.bannedUserDetails\": {\n \"#snippet.bannedUserDetails.channelId\": string\n }\n }\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|---------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#liveChatBan`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube assigns to uniquely identify the ban. |\n| `snippet` | `object` The `snippet` object identifies the banned user and contains details about the ban. |\n| snippet.`liveChatId` | `string` The live chat to which the ban applies. The live chat ID associated with a broadcast is returned in the `liveBroadcast` resource's `snippet.liveChatId` property. |\n| snippet.`type` | `string` The type of ban. Valid values for this property are: - `permanent` - `temporary` |\n| snippet.`banDurationSeconds` | `unsigned long` The duration of the ban. Only set a value for this property if the ban's type is `temporary`. The default value is `300` (5 minutes). |\n| snippet.`bannedUserDetails` | `object` This object contains information that identifies the banned user. |\n| snippet.bannedUserDetails.`channelId` | `string` The banned user's YouTube channel ID. |"]]