{ "type": "object", "description": "A list of live chat message resources for a given broadcast.", "properties": { "kind": { "type": "string", "description": "Identifies the API resource's type. Value is youtube#liveChatMessageListResponse.", "example": "youtube#video" }, "etag": { "type": "string", "description": "The Etag of this resource.", "example": "XI7nbFXulYBIpL0ayR_gDh3eu1k" }, "nextPageToken": { "type": "string", "description": "The token for the next page of results.", "example": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9" }, "pollingIntervalMillis": { "type": "integer", "description": "The amount of time the client should wait before polling again, in milliseconds.", "example": 10 }, "offlineAt": { "type": "string", "description": "The date and time when the underlying stream went offline.", "example": "2026-01-15T10:30:00Z", "format": "date-time" }, "pageInfo": { "type": "object", "description": "Paging details for a list of live streaming resources.", "properties": { "totalResults": { "type": "integer", "description": "The total number of results in the result set.", "example": 42 }, "resultsPerPage": { "type": "integer", "description": "The number of results included in the API response.", "example": 10 } } }, "items": { "type": "array", "description": "A list of chat messages that match the request criteria.", "example": [], "items": { "type": "object", "description": "A liveChatMessage resource represents a chat message in a YouTube live broadcast.", "properties": { "kind": { "type": "string", "description": "Identifies the API resource's type. Value is youtube#liveChatMessage.", "example": "youtube#video" }, "etag": { "type": "string", "description": "The Etag of this resource.", "example": "XI7nbFXulYBIpL0ayR_gDh3eu1k" }, "id": { "type": "string", "description": "The ID that YouTube assigns to uniquely identify the message.", "example": "abc123def456" }, "snippet": { "type": "object", "description": "The snippet object contains basic details about the message.", "example": "example_value", "properties": { "liveChatId": { "type": "string", "description": "The ID of the live chat to which this message belongs." }, "type": { "type": "string", "description": "The type of message.", "enum": [ "chatEndedEvent", "fanFundingEvent", "giftMembershipReceivedEvent", "memberMilestoneChatEvent", "membershipGiftingEvent", "messageDeletedEvent", "newSponsorEvent", "pollClosedEvent", "pollEditedEvent", "pollOpenedEvent", "pollVotedEvent", "sponsorOnlyModeEndedEvent", "sponsorOnlyModeStartedEvent", "superChatEvent", "superStickerEvent", "textMessageEvent", "tombstone", "userBannedEvent" ] }, "displayMessage": { "type": "string", "description": "Contains a string that can be displayed to the user. The string is not necessarily the message text itself." }, "authorChannelId": { "type": "string", "description": "The ID of the user that authored this message." }, "publishedAt": { "type": "string", "description": "The date and time when the message was orignally published.", "format": "date-time" }, "hasDisplayContent": { "type": "boolean", "description": "Whether the message has display content that should be displayed to users." }, "textMessageDetails": { "type": "object", "description": "Details about the text message. This object is only present if the type is textMessageEvent.", "properties": { "messageText": { "type": "string", "description": "The user's message." } } } } }, "authorDetails": { "type": "object", "description": "The authorDetails object contains basic details about the user that posted this message.", "example": "example_value", "properties": { "channelId": { "type": "string", "description": "The YouTube channel ID of the message author." }, "channelUrl": { "type": "string", "description": "The channel URL of the message author." }, "displayName": { "type": "string", "description": "The channel's display name." }, "profileImageUrl": { "type": "string", "description": "The channel's avatar URL." }, "isVerified": { "type": "boolean", "description": "Indicates whether YouTube has verified the authenticity of the channel owner's identity." }, "isChatOwner": { "type": "boolean", "description": "Indicates whether the user is the owner of the live chat." }, "isChatSponsor": { "type": "boolean", "description": "Indicates whether the user is a sponsor of the live chat." }, "isChatModerator": { "type": "boolean", "description": "Indicates whether the user is a moderator of the live chat." } } } }, "required": [ "kind", "etag" ] } } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "LiveChatMessageListResponse", "x-schema-source": "openapi", "x-source-url": "openapi/youtube-live-streaming-openapi.yml" }