LiveChatBans

Um recurso liveChatBan identifica um usuário do YouTube e um chat ao vivo do YouTube em que o usuário é banido.

Métodos

A API é compatível com os seguintes métodos para recursos liveChatBans:

inserir
Bane um usuário específico da participação no chat ao vivo. A solicitação da API precisa ser autorizada pelo proprietário do canal ou por um moderador do chat ao vivo associado à proibição. Faça um teste agora.
delete
Remove uma proibição que impede que um usuário específico contribua para um chat ao vivo, permitindo que ele entre no chat novamente. A solicitação da API precisa ser autorizada pelo proprietário do canal ou por um moderador do chat ao vivo associado à proibição. Faça um teste agora.

Representação de recurso

A estrutura JSON a seguir mostra o formato de um recurso liveChatBans:

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

Propriedades

A tabela a seguir define as propriedades que aparecem neste recurso:

Propriedades
kind string
Identifica o tipo do recurso da API. O valor será youtube#liveChatBan.
etag etag
A ETag deste recurso.
id string
O ID que o YouTube atribui para identificar a proibição de forma exclusiva.
snippet object
O objeto snippet identifica o usuário banido e contém detalhes sobre a proibição.
snippet.liveChatId string
O chat ao vivo que será banido. O ID do chat ao vivo associado a uma transmissão é retornado na propriedade snippet.liveChatId do recurso liveBroadcast.
snippet.type string
O tipo de proibição.

Os valores válidos para essa propriedade são:
  • permanent
  • temporary
snippet.banDurationSeconds unsigned long
A duração da proibição. Defina um valor para esta propriedade apenas se o tipo de proibição for temporary. O valor padrão é 300 (5 minutos).
snippet.bannedUserDetails object
Esse objeto contém informações que identificam o usuário banido.
snippet.bannedUserDetails.channelId string
O ID do canal do YouTube do usuário banido.