LiveChatBans

Une ressource liveChatBan identifie un utilisateur YouTube et un chat en direct dont l'utilisateur est exclu.

Méthodes

L'API accepte les méthodes suivantes pour les ressources liveChatBans:

insérer
Interdire à un utilisateur spécifique de participer au chat en direct. La demande d'API doit être autorisée par le propriétaire de la chaîne ou un modérateur du chat en direct associé à l'exclusion. Essayer
supprimer
Supprime une exclusion qui empêche un utilisateur spécifique de contribuer au chat en direct, ce qui lui permet de rejoindre le chat. La demande d'API doit être autorisée par le propriétaire de la chaîne ou un modérateur du chat en direct associé à l'exclusion. Essayer

Représentation des ressources

La structure JSON suivante montre le format d'une ressource liveChatBans:

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

Propriétés

Le tableau suivant définit les propriétés qui apparaissent dans cette ressource:

Propriétés
kind string
Identifie le type de ressource de l'API. La valeur sera youtube#liveChatBan.
etag etag
ETag de cette ressource.
id string
Identifiant attribué par YouTube afin d'identifier l'interdiction de manière unique.
snippet object
L'objet snippet identifie l'utilisateur exclu et contient des informations sur l'exclusion.
snippet.liveChatId string
Chat en direct auquel l'exclusion s'applique. L'ID de chat en direct associé à une diffusion est renvoyé dans la propriété snippet.liveChatId de la ressource liveBroadcast.
snippet.type string
Type d'exclusion.

Valeurs valides pour cette propriété :
  • permanent
  • temporary
snippet.banDurationSeconds unsigned long
Durée de l'exclusion. Ne définissez une valeur pour cette propriété que si le type d'exclusion est temporary. La valeur par défaut est 300 (5 minutes).
snippet.bannedUserDetails object
Cet objet contient des informations qui identifient l'utilisateur exclu.
snippet.bannedUserDetails.channelId string
ID de la chaîne YouTube de l'utilisateur exclu.