LiveChatMessages: list

Lista as mensagens do chat ao vivo de um chat específico.

Quando você faz sua primeira solicitação para recuperar mensagens de chat, a API retorna parte ou todo o histórico de chat, dependendo da duração dele. As mensagens na resposta são ordenadas da mais antiga para a mais recente.
  • O nextPageToken na resposta fornece um token que, na próxima solicitação, vai identificar o próximo conjunto de resultados que o cliente da API precisa recuperar.
  • A propriedade pollingIntervalMillis indica quanto tempo o cliente da API deve esperar antes de solicitar mais resultados.
Ao solicitar mais resultados, defina o parâmetro pageToken como o valor nextPageToken. O servidor da API vai retornar mais mensagens de chat, se disponíveis. Nesse conjunto de resultados, as mensagens são ordenadas da mais antiga para a mais recente.

Casos de uso comuns

Solicitação

Solicitação HTTP

GET https://www.googleapis.com/youtube/v3/liveChat/messages

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
liveChatId string
O parâmetro liveChatId especifica o ID da conversa cujas mensagens serão retornadas. O ID do chat ao vivo associado a uma transmissão é retornado na propriedade snippet.liveChatId do recurso liveBroadcast.
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.
Parâmetros opcionais
hl string
O parâmetro hl instrui a API a extrair uma string de exibição de moeda localizada para um idioma do aplicativo específico compatível com o site do YouTube. Por exemplo, em inglês, a moeda seria exibida como $1.50, mas em francês, como 1,50$.

O valor do parâmetro precisa ser um código de idioma incluído na lista retornada pelo método i18nLanguages.list.
maxResults unsigned integer
O parâmetro maxResults especifica o número máximo de mensagens que devem ser retornadas no conjunto de resultados. Os valores aceitos vão de 200 a 2000. O valor padrão é 500.
pageToken string
O parâmetro pageToken identifica uma página específica no conjunto de resultados que precisa ser retornada. Em uma resposta da API, a propriedade nextPageToken identifica outras páginas que podem ser recuperadas.
profileImageSize unsigned integer
O parâmetro profileImageSize especifica o tamanho das fotos de perfil do usuário que precisam ser retornadas no conjunto de resultados. As imagens são quadradas. O valor padrão é 88, o que significa que as imagens terão 88 x 88 pixels. Os valores aceitos estão no intervalo de 16 a 720.

Corpo da solicitação

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

Resposta

Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:

{
  "kind": "youtube#liveChatMessageListResponse",
  "etag": etag,
  "nextPageToken": string,
  "pollingIntervalMillis": unsigned integer,
  "offlineAt": datetime,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    liveChatMessage Resource
  ],
  "activePollItem": liveChatMessage Resource
}

Propriedades

A tabela a seguir define as propriedades que aparecem neste recurso:

Propriedades
kind string
Identifica o tipo do recurso da API. O valor será youtube#liveChatMessageListResponse.
etag etag
A ETag deste recurso.
nextPageToken string
O token que pode ser usado como o valor do parâmetro pageToken para recuperar a próxima página no conjunto de resultados.
pollingIntervalMillis unsigned integer
O tempo, em milissegundos, que o cliente deve esperar antes de pesquisar novamente por novas mensagens do chat ao vivo.
offlineAt datetime
A data e a hora em que a transmissão ao vivo ficou off-line. Essa propriedade só estará presente se a transmissão já estiver off-line. O valor é especificado no formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
pageInfo object
O objeto pageInfo encapsula informações de paginação para o conjunto de resultados.
pageInfo.totalResults integer
O número total de resultados no conjunto de resultados.
pageInfo.resultsPerPage integer
O número de resultados incluídos na resposta da API.
items[] list
Uma lista de mensagens. Cada item da lista é um recurso liveChatMessage.
activePollItem object
Os dados da enquete na mensagem. Cada pesquisa é um recurso liveChatMessage com o tipo pollEvent, que representa uma pesquisa ativa. Só é possível fazer uma enquete por conversa.

Erros

A tabela a seguir identifica as 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 recuperar mensagens do chat ao vivo especificado.
forbidden (403) liveChatDisabled O chat ao vivo não está ativado para a transmissão especificada.
forbidden (403) liveChatEnded O chat ao vivo especificado não está mais ativo.
notFound (404) liveChatNotFound Não foi possível encontrar o chat ao vivo que você está tentando recuperar. Verifique se o valor do parâmetro liveChatId da solicitação está correto.
rateLimitExceeded rateLimitExceeded A solicitação foi enviada muito rápido após a anterior. Esse erro ocorre quando as solicitações de API para recuperar mensagens são enviadas com mais frequência do que as taxas de atualização do YouTube, o que desperdiça largura de banda desnecessariamente.

Confira!

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