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 |
string O 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.liveChatId
snippet.type
: usetextMessageEvent
snippet.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.