Se le impide a un usuario específico participar en el chat en vivo. El propietario del canal o un moderador del chat en vivo asociado con el bloqueo debe autorizar la solicitud a la API.
Casos de uso habituales
Solicitud
Solicitud HTTP
POST https://www.googleapis.com/youtube/v3/liveChat/bans
Autorización
Esta solicitud requiere autorización con al menos uno de los siguientes alcances (obtén más información acerca de la autenticación y autorización).
| Alcance |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parámetros
En la siguiente tabla, se enumeran los parámetros que admite esta consulta. Todos los parámetros mencionados son parámetros de consulta.
| Parámetros | ||
|---|---|---|
| Parámetros obligatorios | ||
part |
stringEl parámetro part tiene dos propósitos en esta operación. Identifica las propiedades que establecerá la operación de escritura, así como las propiedades que devuelve la respuesta de la API. Establece el valor del parámetro en snippet. |
|
Cuerpo de la solicitud
Proporciona un recurso LiveChatBan en el cuerpo de la solicitud. Para ese recurso:
-
Debes especificar un valor para estas propiedades:
snippet.liveChatIdsnippet.typesnippet.bannedUserDetails.channelId
-
Puedes establecer los valores de las siguientes propiedades:
snippet.banDurationSeconds
Respuesta
Si se aplica correctamente, este método muestra un recurso LiveChatBan en el cuerpo de la respuesta.
Errores
En la siguiente tabla se identifican los mensajes de error que la API podría mostrar en respuesta a una llamada a este método. Consulta la documentación sobre mensajes de error para obtener más información.
| Tipo de error | Detalle del error | Descripción |
|---|---|---|
forbidden (403) |
insufficientPermissions |
No tienes los permisos necesarios para bloquear a un usuario en el chat en vivo especificado. |
forbidden (403) |
liveChatBanInsertionNotAllowed |
No se puede crear el bloqueo especificado. Este error puede ocurrir si la solicitud intenta bloquear al propietario del chat o a otro moderador. |
invalidValue (400) |
invalidChannelId |
No se puede encontrar el ID del canal especificado. |
invalidValue (400) |
invalidLiveChatId |
El valor snippet.liveChatId especificado en la solicitud no es válido. Verifica el recurso liveBroadcast asociado para asegurarte de tener el valor correcto. |
notFound (404) |
liveChatNotFound |
No se puede encontrar el chat en vivo especificado. Verifica el recurso liveBroadcast asociado para asegurarte de configurar la propiedad snippet.liveChatId con el valor correcto. |
notFound (404) |
liveChatUserNotFound |
No se puede encontrar al usuario del chat en vivo al que intentas bloquear. |
required (400) |
bannedUserChannelIdRequired |
El recurso liveChatBan enviado en el cuerpo de la solicitud debe especificar un valor para la propiedad snippet.bannedUserDetails.channelId. |
required (400) |
liveChatIdRequired |
El recurso liveChatBan enviado en el cuerpo de la solicitud debe especificar un valor para la propiedad snippet.liveChatId. |
Pruébalo
Usa APIs Explorer para llamar a esta API y ver la solicitud y la respuesta a la API.