LiveChatMessages: insert

Adiciona uma mensagem a um chat ao vivo. No momento, a API permite inserir apenas mensagens de texto.

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:

  • É necessário especificar um valor para essas propriedades:

    • snippet.liveChatId
    • snippet.type: no momento, o único valor compatível é textMessageEvent.
    • 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 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.
rateLimitExceeded rateLimitExceeded O usuário postou muitas mensagens de chat em um determinado período.
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.

Confira!

Use o APIs Explorer para chamar essa API e conferir a solicitação e a resposta da API.