Esta página foi traduzida pela API Cloud Translation.

SuperChatEvents

O recurso superChatEvent representa uma mensagem do Super Chat comprada por um fã durante uma transmissão ao vivo do YouTube. Na transmissão ao vivo do YouTube, os Super Chats se destacam das outras mensagens de duas maneiras:

Os Super Chats são destacados com uma cor.
Os Super Chats permanecem fixados no mostrador por um determinado período.

A cor do Super Chat, o período em que ele fica fixado no mostrador e o comprimento máximo da mensagem são determinados pelo valor da compra. Acesse a Central de Ajuda do YouTube para saber mais sobre os Super Chats.

Métodos

A API oferece suporte aos seguintes métodos para recursos superChatEvents:

list: Lista os eventos do Super Chat das transmissões ao vivo de um canal nos últimos 30 dias. Faça um teste agora.

Representação de recurso

A estrutura JSON a seguir mostra o formato de um recurso superChatEvent:

{
  "kind": "youtube#superChatEvent",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "supporterDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "commentText": string,
    "createdAt": datetime,
    "amountMicros": unsigned long,
    "currency": string,
    "displayString": string,
    "messageType": unsigned integer,
    "isSuperStickerEvent": boolean,
    "superStickerMetadata": {
      "stickerId": string,
      "altText": string,
      "language": string
    }
  }
}

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#superChatEvent`.
`etag`	`etag` A ETag deste recurso.
`id`	`string` O ID que o YouTube atribui para identificar de forma exclusiva o evento do Super Chat.
`snippet`	`object` O objeto `snippet` contém detalhes básicos sobre o evento do Super Chat.
`snippet.channelId`	`string` O ID do canal do YouTube que identifica o canal que transmitiu a transmissão ao vivo associada ao evento do Super Chat.
`snippet.supporterDetails`	`object` Detalhes sobre o canal do apoiador.
`snippet.supporterDetails.channelId`	`string` O ID do canal do YouTube do apoiador.
`snippet.supporterDetails.channelUrl`	`string` O URL do canal do apoiador.
`snippet.supporterDetails.displayName`	`string` O nome de exibição do canal do apoiador.
`snippet.supporterDetails.profileImageUrl`	`string` URL do avatar do canal do apoiador.
`snippet.commentText`	`string` O conteúdo de texto do comentário do apoiador.
`snippet.createdAt`	`datetime` A data e a hora em que o Super Chat foi comprado. O valor é especificado no formato ISO 8601 (`YYYY-MM-DDThh:mm:ss.sZ`).
`snippet.amountMicros`	`unsigned long` O montante da compra, em micros da moeda da compra. Por exemplo, se o montante da compra for um dólar, o valor da propriedade `snippet.amountMicros` será `1000000`.
`snippet.currency`	`string` Moeda em que a compra foi feita. O valor é um código de moeda ISO 4217.
`snippet.displayString`	`string` Uma string, como `$1.00`, que mostra o montante da compra e a moeda. A string de exibição é formatada com base nas convenções do idioma especificado pelo parâmetro de solicitação `hl`. Por padrão, as strings de exibição são formatadas como em inglês. Por exemplo, por padrão, uma string é formatada como `$1.00` em vez de `$1,00`.
`snippet.messageType`	`unsigned integer` O nível da mensagem paga. Quando um recurso `liveChatMessage` identifica uma mensagem do Super Chat, a propriedade `snippet.superChatDetails.tier` contém esse valor. O nível é baseado na quantidade de dinheiro gasto para comprar a mensagem. Ela também determina a cor usada para destacar a mensagem na IU do chat ao vivo, o tamanho máximo da mensagem e por quanto tempo ela fica fixada no mostrador. Os níveis do Super Chat estão documentados na Central de Ajuda do YouTube. Consulte a seção expansível sobre os detalhes da compra do Super Chat. Nessa lista, o nível com o menor valor de compra é o nível 1, o próximo valor mais baixo é o nível 2 e assim por diante.
`snippet.isSuperStickerEvent`	`boolean` Indica se o recurso é um Super Sticker, que é um tipo específico de mensagem do Super Chat que tem uma imagem associada. Se o valor desse campo for `true`, o campo `superStickerMetadata` conterá informações que podem ser usadas para exibir a imagem.
`snippet.superStickerMetadata`	`object` Detalhes sobre o Super Sticker. Esse objeto só será retornado se o valor do campo `snippet.isSuperStickerEvent` for `true`.
`snippet.superStickerMetadata.stickerId`	`string` Um ID exclusivo que identifica a imagem do adesivo. Observe que a imagem só é exibida como parte da mensagem do Super Sticker quando os usuários abrem a janela de chat no YouTube. No entanto, o URL da imagem não está disponível pela API. Apenas para referência, você pode encontrar quais IDs de adesivos estão relacionados a quais Super Stickers neste arquivo CSV.
`snippet.superStickerMetadata.altText`	`string` Uma string de texto que descreve o adesivo. O campo `snippet.superStickerMetadata.language` identifica o idioma do texto. Ao chamar o método `superChatEvents.list`, defina o valor do parâmetro hl como o idioma que você quer para o texto.
`snippet.superStickerMetadata.language`	`string` O idioma do valor da propriedade `snippet.superStickerMetadata.altText`. Se o Super Sticker também mostrar algum texto, ele também estará nesse idioma.