LiveChatBans

Un recurso liveChatBan identifica a un usuario de YouTube y un chat en vivo de YouTube en el que el usuario no puede participar.

Métodos

La API admite los siguientes métodos para los recursos liveChatBans:

insertar
Impide que un usuario específico participe en el chat en vivo. El propietario del canal o un moderador del chat en vivo asociado con la prohibición debe autorizar la solicitud a la API. Pruébala ahora.
borrar
Quita una prohibición que impide que un usuario específico participe en un chat en vivo, lo que le permite volver a unirse al chat. El propietario del canal o un moderador del chat en vivo asociado con la prohibición debe autorizar la solicitud a la API. Pruébala ahora.

Representación de recursos

En la siguiente estructura JSON, se muestra el formato de un recurso liveChatBans:

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

Propiedades

La siguiente tabla define las propiedades que aparecen en este recurso:

Propiedades
kind string
Identifica el tipo de recurso de la API. El valor será youtube#liveChatBan.
etag etag
Es la etiqueta de Etag de este recurso.
id string
Es el ID que YouTube asigna para identificar de forma única la prohibición.
snippet object
El objeto snippet identifica al usuario expulsado y contiene detalles sobre la expulsión.
snippet.liveChatId string
Es el chat en vivo al que se aplica la prohibición. El ID de chat en vivo asociado con una transmisión se muestra en la propiedad snippet.liveChatId del recurso liveBroadcast.
snippet.type string
Es el tipo de prohibición.

Los valores válidos para esta propiedad son los siguientes:
  • permanent
  • temporary
snippet.banDurationSeconds unsigned long
Es la duración de la prohibición. Solo establece un valor para esta propiedad si el tipo de prohibición es temporary. El valor predeterminado es 300 (5 minutos).
snippet.bannedUserDetails object
Este objeto contiene información que identifica al usuario expulsado.
snippet.bannedUserDetails.channelId string
Es el ID del canal de YouTube del usuario bloqueado.