LiveChatMessages: transition

Faz a transição do status de uma mensagem de chat ao vivo do YouTube e inicia todos os processos associados ao novo status. Por exemplo, quando você faz a transição do status de uma enquete ao vivo para closed, o YouTube encerra a enquete dessa mensagem. Antes de chamar esse método, confirme se o valor da propriedade status para a mensagem da enquete ao vivo é active.

Solicitação

Solicitação HTTP

POST https://www.googleapis.com/youtube/v3/liveChatMessages/transition

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
id string
O parâmetro id especifica o ID exclusivo da mensagem que está em transição para outro status.
status enum
O parâmetro status identifica o estado para o qual a mensagem está mudando. Para fazer a transição de uma mensagem para o estado closed, o status precisa ser active na enquete a que a mensagem está vinculada.

Só é possível fazer a transição para closed, o que significa que a enquete está encerrada.
Parâmetros opcionais
part string
O parâmetro part especifica as partes do recurso liveChatMessage que a resposta da API vai incluir. Os valores aceitos são id, snippet e authorDetails.

Defina o valor do parâmetro como snippet para ver o resultado final da enquete no corpo da resposta.

Corpo da solicitação

Não forneça um corpo de solicitação ao chamar este método.

Resposta

Se for bem-sucedido, esse método retornará um recurso liveChatMessages 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 fazer a transição do status da mensagem especificada.
required (400) idRequired O parâmetro id obrigatório precisa identificar a mensagem com o status que você quer mudar.
required (400) statusRequired A solicitação de API precisa especificar um valor para o parâmetro status.
notFound (404) liveChatMessagesNotFound A mensagem especificada pelo parâmetro id não existe.
forbidden (403) modificationNotAllowed Não é possível fazer a transição do status do recurso liveChatMessage especificado. O parâmetro id pode identificar uma mensagem cujo status não pode ser transferido.

Confira!

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