docs: update generated docs (#981)
diff --git a/docs/dyn/youtube_v3.liveChatMessages.html b/docs/dyn/youtube_v3.liveChatMessages.html
index fa5955d..cb88737 100644
--- a/docs/dyn/youtube_v3.liveChatMessages.html
+++ b/docs/dyn/youtube_v3.liveChatMessages.html
@@ -72,358 +72,380 @@
</style>
-<h1><a href="youtube_v3.html">YouTube Data API</a> . <a href="youtube_v3.liveChatMessages.html">liveChatMessages</a></h1>
+<h1><a href="youtube_v3.html">YouTube Data API v3</a> . <a href="youtube_v3.liveChatMessages.html">liveChatMessages</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
- <code><a href="#delete">delete(id)</a></code></p>
+ <code><a href="#delete">delete(id, x__xgafv=None)</a></code></p>
<p class="firstline">Deletes a chat message.</p>
<p class="toc_element">
- <code><a href="#insert">insert(part, body=None)</a></code></p>
-<p class="firstline">Adds a message to a live chat.</p>
+ <code><a href="#insert">insert(part, body=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Inserts a new resource into this collection.</p>
<p class="toc_element">
- <code><a href="#list">list(liveChatId, part, hl=None, maxResults=None, pageToken=None, profileImageSize=None)</a></code></p>
-<p class="firstline">Lists live chat messages for a specific chat.</p>
+ <code><a href="#list">list(liveChatId, part, pageToken=None, hl=None, maxResults=None, profileImageSize=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Retrieves a list of resources, possibly filtered.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<h3>Method Details</h3>
<div class="method">
- <code class="details" id="delete">delete(id)</code>
+ <code class="details" id="delete">delete(id, x__xgafv=None)</code>
<pre>Deletes a chat message.
Args:
- id: string, The id parameter specifies the YouTube chat message ID of the resource that is being deleted. (required)
+ id: string, A parameter (required)
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
</pre>
</div>
<div class="method">
- <code class="details" id="insert">insert(part, body=None)</code>
- <pre>Adds a message to a live chat.
+ <code class="details" id="insert">insert(part, body=None, x__xgafv=None)</code>
+ <pre>Inserts a new resource into this collection.
Args:
- part: string, The part parameter serves two purposes. It identifies the properties that the write operation will set as well as the properties that the API response will include. Set the parameter value to snippet. (required)
+ part: string, The <code><strong>part</strong></code> parameter serves two purposes. It
+identifies the properties that the write operation will set as well as the
+properties that the API response will include. Set the parameter value to
+<code>snippet</code>. (required) (repeated)
body: object, The request body.
The object takes the form of:
-{ # A liveChatMessage resource represents a chat message in a YouTube Live Chat.
- "authorDetails": { # The authorDetails object contains basic details about the user that posted this message.
- "channelId": "A String", # The YouTube channel ID.
- "channelUrl": "A String", # The channel's URL.
- "displayName": "A String", # The channel's display name.
- "isChatModerator": True or False, # Whether the author is a moderator of the live chat.
- "isChatOwner": True or False, # Whether the author is the owner of the live chat.
- "isChatSponsor": True or False, # Whether the author is a sponsor of the live chat.
- "isVerified": True or False, # Whether the author's identity has been verified by YouTube.
- "profileImageUrl": "A String", # The channels's avatar URL.
- },
+{ # A <code><strong>liveChatMessage</strong></code> resource represents a chat
+ # message in a YouTube Live Chat.
+ "kind": "youtube#liveChatMessage", # Identifies what kind of resource this is. Value: the fixed string
+ # <code>"youtube#liveChatMessage"</code>.
"etag": "A String", # Etag of this resource.
- "id": "A String", # The ID that YouTube assigns to uniquely identify the message.
- "kind": "youtube#liveChatMessage", # Identifies what kind of resource this is. Value: the fixed string "youtube#liveChatMessage".
- "snippet": { # The snippet object contains basic details about the message.
- "authorChannelId": "A String", # The ID of the user that authored this message, this field is not always filled. textMessageEvent - the user that wrote the message fanFundingEvent - the user that funded the broadcast newSponsorEvent - the user that just became a sponsor messageDeletedEvent - the moderator that took the action messageRetractedEvent - the author that retracted their message userBannedEvent - the moderator that took the action superChatEvent - the user that made the purchase
- "displayMessage": "A String", # Contains a string that can be displayed to the user. If this field is not present the message is silent, at the moment only messages of type TOMBSTONE and CHAT_ENDED_EVENT are silent.
- "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is 'fanFundingEvent'.
- "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
- "amountMicros": "A String", # The amount of the fund.
- "currency": "A String", # The currency in which the fund was made.
- "userComment": "A String", # The comment added by the user to this fan funding event.
- },
- "hasDisplayContent": True or False, # Whether the message has display content that should be displayed to users.
+ "snippet": { # The <code>snippet</code> object contains basic details about the message.
"liveChatId": "A String",
- "messageDeletedDetails": {
- "deletedMessageId": "A String",
+ "authorChannelId": "A String", # The ID of the user that authored this message, this field is not always
+ # filled.
+ # textMessageEvent - the user that wrote the message
+ # fanFundingEvent - the user that funded the broadcast
+ # newSponsorEvent - the user that just became a sponsor
+ # messageDeletedEvent - the moderator that took the action
+ # messageRetractedEvent - the author that retracted their message
+ # userBannedEvent - the moderator that took the action
+ # superChatEvent - the user that made the purchase
+ "publishedAt": "A String", # The date and time when the message was orignally published. The value is
+ # specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+ # format.
+ "userBannedDetails": {
+ "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the
+ # <code>banType</code> is <code>temporary</code>.
+ "bannedUserDetails": { # The details of the user that was banned.
+ "profileImageUrl": "A String", # The channels's avatar URL.
+ "channelUrl": "A String", # The channel's URL.
+ "displayName": "A String", # The channel's display name.
+ "channelId": "A String", # The YouTube channel ID.
+ },
+ "banType": "A String", # The type of ban.
},
"messageRetractedDetails": {
"retractedMessageId": "A String",
},
- "pollClosedDetails": {
- "pollId": "A String", # The id of the poll that was closed.
- },
- "pollEditedDetails": {
- "id": "A String",
- "items": [
- {
- "description": "A String", # Plain text description of the item.
- "itemId": "A String",
- },
- ],
- "prompt": "A String",
- },
- "pollOpenedDetails": {
- "id": "A String",
- "items": [
- {
- "description": "A String", # Plain text description of the item.
- "itemId": "A String",
- },
- ],
- "prompt": "A String",
- },
- "pollVotedDetails": {
- "itemId": "A String", # The poll item the user chose.
- "pollId": "A String", # The poll the user voted on.
- },
- "publishedAt": "A String", # The date and time when the message was orignally published. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
- "superChatDetails": { # Details about the Super Chat event, this is only set if the type is 'superChatEvent'.
- "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
+ "superChatDetails": { # Details about the Super Chat event, this is only set if the type is
+ # 'superChatEvent'.
"amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
- "currency": "A String", # The currency in which the purchase was made.
- "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
"userComment": "A String", # The comment added by the user to this Super Chat event.
- },
- "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is 'superStickerEvent'.
- "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
- "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
"currency": "A String", # The currency in which the purchase was made.
- "superStickerMetadata": { # Information about the Super Sticker.
- "altText": "A String", # Internationalized alt text that describes the sticker image and any animation associated with it.
- "altTextLanguage": "A String", # Specifies the localization language in which the alt text is returned.
- "stickerId": "A String", # Unique identifier of the Super Sticker. This is a shorter form of the alt_text that includes pack name and a recognizable characteristic of the sticker.
- },
- "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
+ "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
+ "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower
+ # tiers. The lowest tier is <code>1</code>.
},
- "textMessageDetails": { # Details about the text message, this is only set if the type is 'textMessageEvent'.
+ "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is
+ # 'superStickerEvent'.
+ "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower
+ # tiers. The lowest tier is <code>1</code>.
+ "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
+ "superStickerMetadata": { # Information about the Super Sticker.
+ "altTextLanguage": "A String", # Specifies the localization language in which the alt text is returned.
+ "altText": "A String", # Internationalized alt text that describes the sticker image and any
+ # animation associated with it.
+ "stickerId": "A String", # Unique identifier of the Super Sticker. This is a shorter form of the
+ # alt_text that includes pack name and a recognizable characteristic of the
+ # sticker.
+ },
+ "currency": "A String", # The currency in which the purchase was made.
+ "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
+ },
+ "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is
+ # 'fanFundingEvent'.
+ "userComment": "A String", # The comment added by the user to this fan funding event.
+ "amountMicros": "A String", # The amount of the fund.
+ "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
+ "currency": "A String", # The currency in which the fund was made.
+ },
+ "textMessageDetails": { # Details about the text message, this is only set if the type is
+ # 'textMessageEvent'.
"messageText": "A String", # The user's message.
},
- "type": "A String", # The type of message, this will always be present, it determines the contents of the message as well as which fields will be present.
- "userBannedDetails": {
- "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the banType is temporary.
- "banType": "A String", # The type of ban.
- "bannedUserDetails": { # The details of the user that was banned.
- "channelId": "A String", # The YouTube channel ID.
- "channelUrl": "A String", # The channel's URL.
- "displayName": "A String", # The channel's display name.
- "profileImageUrl": "A String", # The channels's avatar URL.
- },
+ "displayMessage": "A String", # Contains a string that can be displayed to the user.
+ # If this field is not present the message is silent, at the moment only
+ # messages of type TOMBSTONE and CHAT_ENDED_EVENT are silent.
+ "messageDeletedDetails": {
+ "deletedMessageId": "A String",
},
+ "type": "A String", # The type of message, this will always be present, it determines the
+ # contents of the message as well as which fields will be present.
+ "hasDisplayContent": True or False, # Whether the message has display content that should be displayed to users.
+ },
+ "id": "A String", # The ID that YouTube assigns to uniquely identify the message.
+ "authorDetails": { # The <code>authorDetails</code> object contains basic details about the
+ # user that posted this message.
+ "isChatModerator": True or False, # Whether the author is a moderator of the live chat.
+ "channelUrl": "A String", # The channel's URL.
+ "isChatSponsor": True or False, # Whether the author is a sponsor of the live chat.
+ "isVerified": True or False, # Whether the author's identity has been verified by YouTube.
+ "isChatOwner": True or False, # Whether the author is the owner of the live chat.
+ "profileImageUrl": "A String", # The channels's avatar URL.
+ "channelId": "A String", # The YouTube channel ID.
+ "displayName": "A String", # The channel's display name.
},
}
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
Returns:
An object of the form:
- { # A liveChatMessage resource represents a chat message in a YouTube Live Chat.
- "authorDetails": { # The authorDetails object contains basic details about the user that posted this message.
- "channelId": "A String", # The YouTube channel ID.
- "channelUrl": "A String", # The channel's URL.
- "displayName": "A String", # The channel's display name.
- "isChatModerator": True or False, # Whether the author is a moderator of the live chat.
- "isChatOwner": True or False, # Whether the author is the owner of the live chat.
- "isChatSponsor": True or False, # Whether the author is a sponsor of the live chat.
- "isVerified": True or False, # Whether the author's identity has been verified by YouTube.
- "profileImageUrl": "A String", # The channels's avatar URL.
- },
+ { # A <code><strong>liveChatMessage</strong></code> resource represents a chat
+ # message in a YouTube Live Chat.
+ "kind": "youtube#liveChatMessage", # Identifies what kind of resource this is. Value: the fixed string
+ # <code>"youtube#liveChatMessage"</code>.
"etag": "A String", # Etag of this resource.
- "id": "A String", # The ID that YouTube assigns to uniquely identify the message.
- "kind": "youtube#liveChatMessage", # Identifies what kind of resource this is. Value: the fixed string "youtube#liveChatMessage".
- "snippet": { # The snippet object contains basic details about the message.
- "authorChannelId": "A String", # The ID of the user that authored this message, this field is not always filled. textMessageEvent - the user that wrote the message fanFundingEvent - the user that funded the broadcast newSponsorEvent - the user that just became a sponsor messageDeletedEvent - the moderator that took the action messageRetractedEvent - the author that retracted their message userBannedEvent - the moderator that took the action superChatEvent - the user that made the purchase
- "displayMessage": "A String", # Contains a string that can be displayed to the user. If this field is not present the message is silent, at the moment only messages of type TOMBSTONE and CHAT_ENDED_EVENT are silent.
- "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is 'fanFundingEvent'.
- "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
- "amountMicros": "A String", # The amount of the fund.
- "currency": "A String", # The currency in which the fund was made.
- "userComment": "A String", # The comment added by the user to this fan funding event.
- },
- "hasDisplayContent": True or False, # Whether the message has display content that should be displayed to users.
+ "snippet": { # The <code>snippet</code> object contains basic details about the message.
"liveChatId": "A String",
- "messageDeletedDetails": {
- "deletedMessageId": "A String",
+ "authorChannelId": "A String", # The ID of the user that authored this message, this field is not always
+ # filled.
+ # textMessageEvent - the user that wrote the message
+ # fanFundingEvent - the user that funded the broadcast
+ # newSponsorEvent - the user that just became a sponsor
+ # messageDeletedEvent - the moderator that took the action
+ # messageRetractedEvent - the author that retracted their message
+ # userBannedEvent - the moderator that took the action
+ # superChatEvent - the user that made the purchase
+ "publishedAt": "A String", # The date and time when the message was orignally published. The value is
+ # specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+ # format.
+ "userBannedDetails": {
+ "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the
+ # <code>banType</code> is <code>temporary</code>.
+ "bannedUserDetails": { # The details of the user that was banned.
+ "profileImageUrl": "A String", # The channels's avatar URL.
+ "channelUrl": "A String", # The channel's URL.
+ "displayName": "A String", # The channel's display name.
+ "channelId": "A String", # The YouTube channel ID.
+ },
+ "banType": "A String", # The type of ban.
},
"messageRetractedDetails": {
"retractedMessageId": "A String",
},
- "pollClosedDetails": {
- "pollId": "A String", # The id of the poll that was closed.
- },
- "pollEditedDetails": {
- "id": "A String",
- "items": [
- {
- "description": "A String", # Plain text description of the item.
- "itemId": "A String",
- },
- ],
- "prompt": "A String",
- },
- "pollOpenedDetails": {
- "id": "A String",
- "items": [
- {
- "description": "A String", # Plain text description of the item.
- "itemId": "A String",
- },
- ],
- "prompt": "A String",
- },
- "pollVotedDetails": {
- "itemId": "A String", # The poll item the user chose.
- "pollId": "A String", # The poll the user voted on.
- },
- "publishedAt": "A String", # The date and time when the message was orignally published. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
- "superChatDetails": { # Details about the Super Chat event, this is only set if the type is 'superChatEvent'.
- "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
+ "superChatDetails": { # Details about the Super Chat event, this is only set if the type is
+ # 'superChatEvent'.
"amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
- "currency": "A String", # The currency in which the purchase was made.
- "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
"userComment": "A String", # The comment added by the user to this Super Chat event.
- },
- "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is 'superStickerEvent'.
- "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
- "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
"currency": "A String", # The currency in which the purchase was made.
- "superStickerMetadata": { # Information about the Super Sticker.
- "altText": "A String", # Internationalized alt text that describes the sticker image and any animation associated with it.
- "altTextLanguage": "A String", # Specifies the localization language in which the alt text is returned.
- "stickerId": "A String", # Unique identifier of the Super Sticker. This is a shorter form of the alt_text that includes pack name and a recognizable characteristic of the sticker.
- },
- "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
+ "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
+ "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower
+ # tiers. The lowest tier is <code>1</code>.
},
- "textMessageDetails": { # Details about the text message, this is only set if the type is 'textMessageEvent'.
+ "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is
+ # 'superStickerEvent'.
+ "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower
+ # tiers. The lowest tier is <code>1</code>.
+ "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
+ "superStickerMetadata": { # Information about the Super Sticker.
+ "altTextLanguage": "A String", # Specifies the localization language in which the alt text is returned.
+ "altText": "A String", # Internationalized alt text that describes the sticker image and any
+ # animation associated with it.
+ "stickerId": "A String", # Unique identifier of the Super Sticker. This is a shorter form of the
+ # alt_text that includes pack name and a recognizable characteristic of the
+ # sticker.
+ },
+ "currency": "A String", # The currency in which the purchase was made.
+ "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
+ },
+ "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is
+ # 'fanFundingEvent'.
+ "userComment": "A String", # The comment added by the user to this fan funding event.
+ "amountMicros": "A String", # The amount of the fund.
+ "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
+ "currency": "A String", # The currency in which the fund was made.
+ },
+ "textMessageDetails": { # Details about the text message, this is only set if the type is
+ # 'textMessageEvent'.
"messageText": "A String", # The user's message.
},
- "type": "A String", # The type of message, this will always be present, it determines the contents of the message as well as which fields will be present.
- "userBannedDetails": {
- "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the banType is temporary.
- "banType": "A String", # The type of ban.
- "bannedUserDetails": { # The details of the user that was banned.
- "channelId": "A String", # The YouTube channel ID.
- "channelUrl": "A String", # The channel's URL.
- "displayName": "A String", # The channel's display name.
- "profileImageUrl": "A String", # The channels's avatar URL.
- },
+ "displayMessage": "A String", # Contains a string that can be displayed to the user.
+ # If this field is not present the message is silent, at the moment only
+ # messages of type TOMBSTONE and CHAT_ENDED_EVENT are silent.
+ "messageDeletedDetails": {
+ "deletedMessageId": "A String",
},
+ "type": "A String", # The type of message, this will always be present, it determines the
+ # contents of the message as well as which fields will be present.
+ "hasDisplayContent": True or False, # Whether the message has display content that should be displayed to users.
+ },
+ "id": "A String", # The ID that YouTube assigns to uniquely identify the message.
+ "authorDetails": { # The <code>authorDetails</code> object contains basic details about the
+ # user that posted this message.
+ "isChatModerator": True or False, # Whether the author is a moderator of the live chat.
+ "channelUrl": "A String", # The channel's URL.
+ "isChatSponsor": True or False, # Whether the author is a sponsor of the live chat.
+ "isVerified": True or False, # Whether the author's identity has been verified by YouTube.
+ "isChatOwner": True or False, # Whether the author is the owner of the live chat.
+ "profileImageUrl": "A String", # The channels's avatar URL.
+ "channelId": "A String", # The YouTube channel ID.
+ "displayName": "A String", # The channel's display name.
},
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(liveChatId, part, hl=None, maxResults=None, pageToken=None, profileImageSize=None)</code>
- <pre>Lists live chat messages for a specific chat.
+ <code class="details" id="list">list(liveChatId, part, pageToken=None, hl=None, maxResults=None, profileImageSize=None, x__xgafv=None)</code>
+ <pre>Retrieves a list of resources, possibly filtered.
Args:
- liveChatId: string, The liveChatId parameter specifies the ID of the chat whose messages will be returned. (required)
- part: string, The part parameter specifies the liveChatComment resource parts that the API response will include. Supported values are id and snippet. (required)
- hl: string, The hl parameter instructs the API to retrieve localized resource metadata for a specific application language that the YouTube website supports. The parameter value must be a language code included in the list returned by the i18nLanguages.list method.
-
-If localized resource details are available in that language, the resource's snippet.localized object will contain the localized values. However, if localized details are not available, the snippet.localized object will contain resource details in the resource's default language.
- maxResults: integer, The maxResults parameter specifies the maximum number of messages that should be returned in the result set.
- pageToken: string, The pageToken parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken property identify other pages that could be retrieved.
- profileImageSize: integer, The profileImageSize parameter specifies the size of the user profile pictures that should be returned in the result set. Default: 88.
+ liveChatId: string, The id of the live chat for which comments should be returned. (required)
+ part: string, The <code><strong>part</strong></code> parameter specifies the
+<code>liveChatComment</code> resource parts that the API response will
+include. Supported values are <code>id</code> and <code>snippet</code>. (required) (repeated)
+ pageToken: string, The <code><strong>pageToken</strong></code> parameter identifies a specific
+page in the result set that should be returned. In an API response, the
+<code>nextPageToken</code> property identify other pages that could be
+retrieved.
+ hl: string, Specifies the localization language in which the system messages
+should be returned.
+ maxResults: integer, The <code><strong>maxResults</strong></code> parameter specifies the
+maximum number of items that should be returned in the result set.
+ profileImageSize: integer, Specifies the size of the profile image that should be
+returned for each user.
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
Returns:
An object of the form:
{
- "etag": "A String", # Etag of this resource.
- "eventId": "A String", # Serialized EventId of the request which produced this response.
- "items": [ # A list of live chat messages.
- { # A liveChatMessage resource represents a chat message in a YouTube Live Chat.
- "authorDetails": { # The authorDetails object contains basic details about the user that posted this message.
- "channelId": "A String", # The YouTube channel ID.
- "channelUrl": "A String", # The channel's URL.
- "displayName": "A String", # The channel's display name.
- "isChatModerator": True or False, # Whether the author is a moderator of the live chat.
- "isChatOwner": True or False, # Whether the author is the owner of the live chat.
- "isChatSponsor": True or False, # Whether the author is a sponsor of the live chat.
- "isVerified": True or False, # Whether the author's identity has been verified by YouTube.
- "profileImageUrl": "A String", # The channels's avatar URL.
- },
+ "pollingIntervalMillis": 42, # The amount of time the client should wait before polling again.
+ "items": [
+ { # A <code><strong>liveChatMessage</strong></code> resource represents a chat
+ # message in a YouTube Live Chat.
+ "kind": "youtube#liveChatMessage", # Identifies what kind of resource this is. Value: the fixed string
+ # <code>"youtube#liveChatMessage"</code>.
"etag": "A String", # Etag of this resource.
- "id": "A String", # The ID that YouTube assigns to uniquely identify the message.
- "kind": "youtube#liveChatMessage", # Identifies what kind of resource this is. Value: the fixed string "youtube#liveChatMessage".
- "snippet": { # The snippet object contains basic details about the message.
- "authorChannelId": "A String", # The ID of the user that authored this message, this field is not always filled. textMessageEvent - the user that wrote the message fanFundingEvent - the user that funded the broadcast newSponsorEvent - the user that just became a sponsor messageDeletedEvent - the moderator that took the action messageRetractedEvent - the author that retracted their message userBannedEvent - the moderator that took the action superChatEvent - the user that made the purchase
- "displayMessage": "A String", # Contains a string that can be displayed to the user. If this field is not present the message is silent, at the moment only messages of type TOMBSTONE and CHAT_ENDED_EVENT are silent.
- "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is 'fanFundingEvent'.
- "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
- "amountMicros": "A String", # The amount of the fund.
- "currency": "A String", # The currency in which the fund was made.
- "userComment": "A String", # The comment added by the user to this fan funding event.
- },
- "hasDisplayContent": True or False, # Whether the message has display content that should be displayed to users.
+ "snippet": { # The <code>snippet</code> object contains basic details about the message.
"liveChatId": "A String",
- "messageDeletedDetails": {
- "deletedMessageId": "A String",
+ "authorChannelId": "A String", # The ID of the user that authored this message, this field is not always
+ # filled.
+ # textMessageEvent - the user that wrote the message
+ # fanFundingEvent - the user that funded the broadcast
+ # newSponsorEvent - the user that just became a sponsor
+ # messageDeletedEvent - the moderator that took the action
+ # messageRetractedEvent - the author that retracted their message
+ # userBannedEvent - the moderator that took the action
+ # superChatEvent - the user that made the purchase
+ "publishedAt": "A String", # The date and time when the message was orignally published. The value is
+ # specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+ # format.
+ "userBannedDetails": {
+ "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the
+ # <code>banType</code> is <code>temporary</code>.
+ "bannedUserDetails": { # The details of the user that was banned.
+ "profileImageUrl": "A String", # The channels's avatar URL.
+ "channelUrl": "A String", # The channel's URL.
+ "displayName": "A String", # The channel's display name.
+ "channelId": "A String", # The YouTube channel ID.
+ },
+ "banType": "A String", # The type of ban.
},
"messageRetractedDetails": {
"retractedMessageId": "A String",
},
- "pollClosedDetails": {
- "pollId": "A String", # The id of the poll that was closed.
- },
- "pollEditedDetails": {
- "id": "A String",
- "items": [
- {
- "description": "A String", # Plain text description of the item.
- "itemId": "A String",
- },
- ],
- "prompt": "A String",
- },
- "pollOpenedDetails": {
- "id": "A String",
- "items": [
- {
- "description": "A String", # Plain text description of the item.
- "itemId": "A String",
- },
- ],
- "prompt": "A String",
- },
- "pollVotedDetails": {
- "itemId": "A String", # The poll item the user chose.
- "pollId": "A String", # The poll the user voted on.
- },
- "publishedAt": "A String", # The date and time when the message was orignally published. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
- "superChatDetails": { # Details about the Super Chat event, this is only set if the type is 'superChatEvent'.
- "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
+ "superChatDetails": { # Details about the Super Chat event, this is only set if the type is
+ # 'superChatEvent'.
"amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
- "currency": "A String", # The currency in which the purchase was made.
- "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
"userComment": "A String", # The comment added by the user to this Super Chat event.
- },
- "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is 'superStickerEvent'.
- "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
- "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
"currency": "A String", # The currency in which the purchase was made.
- "superStickerMetadata": { # Information about the Super Sticker.
- "altText": "A String", # Internationalized alt text that describes the sticker image and any animation associated with it.
- "altTextLanguage": "A String", # Specifies the localization language in which the alt text is returned.
- "stickerId": "A String", # Unique identifier of the Super Sticker. This is a shorter form of the alt_text that includes pack name and a recognizable characteristic of the sticker.
- },
- "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
+ "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
+ "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower
+ # tiers. The lowest tier is <code>1</code>.
},
- "textMessageDetails": { # Details about the text message, this is only set if the type is 'textMessageEvent'.
+ "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is
+ # 'superStickerEvent'.
+ "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower
+ # tiers. The lowest tier is <code>1</code>.
+ "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
+ "superStickerMetadata": { # Information about the Super Sticker.
+ "altTextLanguage": "A String", # Specifies the localization language in which the alt text is returned.
+ "altText": "A String", # Internationalized alt text that describes the sticker image and any
+ # animation associated with it.
+ "stickerId": "A String", # Unique identifier of the Super Sticker. This is a shorter form of the
+ # alt_text that includes pack name and a recognizable characteristic of the
+ # sticker.
+ },
+ "currency": "A String", # The currency in which the purchase was made.
+ "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
+ },
+ "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is
+ # 'fanFundingEvent'.
+ "userComment": "A String", # The comment added by the user to this fan funding event.
+ "amountMicros": "A String", # The amount of the fund.
+ "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
+ "currency": "A String", # The currency in which the fund was made.
+ },
+ "textMessageDetails": { # Details about the text message, this is only set if the type is
+ # 'textMessageEvent'.
"messageText": "A String", # The user's message.
},
- "type": "A String", # The type of message, this will always be present, it determines the contents of the message as well as which fields will be present.
- "userBannedDetails": {
- "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the banType is temporary.
- "banType": "A String", # The type of ban.
- "bannedUserDetails": { # The details of the user that was banned.
- "channelId": "A String", # The YouTube channel ID.
- "channelUrl": "A String", # The channel's URL.
- "displayName": "A String", # The channel's display name.
- "profileImageUrl": "A String", # The channels's avatar URL.
- },
+ "displayMessage": "A String", # Contains a string that can be displayed to the user.
+ # If this field is not present the message is silent, at the moment only
+ # messages of type TOMBSTONE and CHAT_ENDED_EVENT are silent.
+ "messageDeletedDetails": {
+ "deletedMessageId": "A String",
},
+ "type": "A String", # The type of message, this will always be present, it determines the
+ # contents of the message as well as which fields will be present.
+ "hasDisplayContent": True or False, # Whether the message has display content that should be displayed to users.
+ },
+ "id": "A String", # The ID that YouTube assigns to uniquely identify the message.
+ "authorDetails": { # The <code>authorDetails</code> object contains basic details about the
+ # user that posted this message.
+ "isChatModerator": True or False, # Whether the author is a moderator of the live chat.
+ "channelUrl": "A String", # The channel's URL.
+ "isChatSponsor": True or False, # Whether the author is a sponsor of the live chat.
+ "isVerified": True or False, # Whether the author's identity has been verified by YouTube.
+ "isChatOwner": True or False, # Whether the author is the owner of the live chat.
+ "profileImageUrl": "A String", # The channels's avatar URL.
+ "channelId": "A String", # The YouTube channel ID.
+ "displayName": "A String", # The channel's display name.
},
},
],
- "kind": "youtube#liveChatMessageListResponse", # Identifies what kind of resource this is. Value: the fixed string "youtube#liveChatMessageListResponse".
- "nextPageToken": "A String", # The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.
- "offlineAt": "A String", # The date and time when the underlying stream went offline. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
- "pageInfo": { # Paging details for lists of resources, including total number of items available and number of resources returned in a single page.
+ "etag": "A String", # Etag of this resource.
+ "kind": "youtube#liveChatMessageListResponse", # Identifies what kind of resource this is. Value: the fixed string
+ # <code>"youtube#liveChatMessageListResponse"</code>.
+ "pageInfo": { # Paging details for lists of resources, including total number of items # General pagination information.
+ # available and number of resources returned in a single page.
"resultsPerPage": 42, # The number of results included in the API response.
"totalResults": 42, # The total number of results in the result set.
},
- "pollingIntervalMillis": 42, # The amount of time the client should wait before polling again.
+ "visitorId": "A String", # The <code>visitorId</code> identifies the visitor.
+ "eventId": "A String", # Serialized EventId of the request which produced this response.
"tokenPagination": { # Stub token pagination template to suppress results.
},
- "visitorId": "A String", # The visitorId identifies the visitor.
+ "offlineAt": "A String", # The date and time when the underlying stream went offline. The value is
+ # specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+ # format.
+ "nextPageToken": "A String",
}</pre>
</div>