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. |