Adiciona uma mensagem a um chat ao vivo.
Casos de uso comuns
Solicitação
Solicitação HTTP
POST https://www.googleapis.com/youtube/v3/liveChat/messages
Autorização
Esta solicitação requer autorização com pelo menos um dos seguintes escopos (leia mais sobre autenticação e autorização).
| Escopo |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parâmetros
A tabela a seguir lista os parâmetros compatíveis com essa consulta. Todos os parâmetros listados são os parâmetros de consulta.
| Parâmetros | ||
|---|---|---|
| Parâmetros obrigatórios | ||
part |
stringO parâmetro part tem duas finalidades. identifica as propriedades que serão definidas pela operação de gravação e as propriedades que serão incluídas pela resposta da API. Defina o valor do parâmetro como snippet. |
|
Corpo da solicitação
Forneça um recurso liveChatMessage no corpo da solicitação. Para esse recurso, é preciso especificar os valores das propriedades
snippet.liveChatIdsnippet.type: usetextMessageEventsnippet.textMessageDetails.messageText
Resposta
Se for bem-sucedido, esse método retornará um recurso liveChatMessage no corpo da resposta.
Erros
A tabela a seguir identifica mensagens de erro que a API pode retornar em resposta a uma chamada para esse método. Consulte a documentação da mensagem de erro para mais detalhes.
| Tipo de erro | Detalhe do erro | Descrição |
|---|---|---|
forbidden (403) |
forbidden |
Você não tem as permissões necessárias para criar a mensagem especificada. |
forbidden (403) |
liveChatDisabled |
O chat ao vivo especificado foi desativado pelo proprietário. Isso significa que não é possível adicionar mensagens ao chat. |
forbidden (403) |
liveChatEnded |
O chat ao vivo especificado não está mais ativo. |
invalidValue (400) |
messageTextInvalid |
O texto da mensagem (snippet.textMessageDetails.messageText) não é válido. |
notFound (404) |
liveChatNotFound |
O chat ao vivo identificado na solicitação de API não existe. Esse erro ocorre quando a conversa é excluída pelo proprietário. |
required (400) |
liveChatIdRequired |
O recurso liveChatMessage precisa incluir e especificar um valor para a propriedade snippet.liveChatId. |
required (400) |
messageTextRequired |
O recurso liveChatMessage precisa incluir e especificar um valor para a propriedade snippet.textMessageDetails.messageText. |
required (400) |
typeRequired |
O recurso liveChatMessage precisa incluir e especificar um valor para a propriedade snippet.type. Defina o valor do parâmetro como text. |
required (400) |
preconditionCheckFailed |
Já existe uma enquete ativa fixada. |
rateLimitExceeded |
rateLimitExceeded |
O usuário postou muitas mensagens de chat em um determinado período. |
Confira!
Use o APIs Explorer para chamar essa API e conferir a solicitação e a resposta da API.