Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit 39808f1

Browse files
committedOct 25, 2022
feat(chat): update the api
#### chat:v1 The following keys were added: - resources.dms.methods.messages.parameters.messageReplyOption (Total Keys: 2) - resources.dms.methods.webhooks.parameters.messageReplyOption (Total Keys: 2) - resources.dms.resources.conversations.methods.messages.parameters.messageReplyOption (Total Keys: 2) - resources.rooms.methods.messages.parameters.messageReplyOption (Total Keys: 2) - resources.rooms.methods.webhooks.parameters.messageReplyOption (Total Keys: 2) - resources.rooms.resources.conversations.methods.messages.parameters.messageReplyOption (Total Keys: 2) - resources.spaces.methods.webhooks.parameters.messageReplyOption (Total Keys: 2) - resources.spaces.resources.messages.methods.create.parameters.messageReplyOption (Total Keys: 2) - schemas.Message.properties.threadReply (Total Keys: 2) - schemas.Space.properties.spaceThreadingState (Total Keys: 2) - schemas.Thread.properties.threadKey.type (Total Keys: 1)
1 parent 4b424cf commit 39808f1

7 files changed

+369
-124
lines changed
 

‎docs/dyn/chat_v1.dms.conversations.html

+22-11
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ <h2>Instance Methods</h2>
7878
<code><a href="#close">close()</a></code></p>
7979
<p class="firstline">Close httplib2 connections.</p>
8080
<p class="toc_element">
81-
<code><a href="#messages">messages(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None)</a></code></p>
81+
<code><a href="#messages">messages(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)</a></code></p>
8282
<p class="firstline">Legacy path for creating message. Calling these will result in a BadRequest response.</p>
8383
<h3>Method Details</h3>
8484
<div class="method">
@@ -87,7 +87,7 @@ <h3>Method Details</h3>
8787
</div>
8888

8989
<div class="method">
90-
<code class="details" id="messages">messages(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None)</code>
90+
<code class="details" id="messages">messages(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)</code>
9191
<pre>Legacy path for creating message. Calling these will result in a BadRequest response.
9292

9393
Args:
@@ -1372,26 +1372,34 @@ <h3>Method Details</h3>
13721372
&quot;slashCommand&quot;: { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable.
13731373
&quot;commandId&quot;: &quot;A String&quot;, # The id of the slash command invoked.
13741374
},
1375-
&quot;space&quot;: { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # The space the message belongs to.
1375+
&quot;space&quot;: { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # The space the message belongs to. When accessed with [user authentication](https://developers.google.com/chat/api/guides/auth/users), only the name of the Space is populated.
13761376
&quot;displayName&quot;: &quot;A String&quot;, # The space&#x27;s display name. For direct messages between humans, this field might be empty.
13771377
&quot;name&quot;: &quot;A String&quot;, # Resource name of the space. Format: spaces/{space}
13781378
&quot;singleUserBotDm&quot;: True or False, # Optional. Whether the space is a DM between a Chat app and a single human.
13791379
&quot;spaceDetails&quot;: { # Details about the space including description and rules. # Details about the space including description and rules.
13801380
&quot;description&quot;: &quot;A String&quot;, # Optional. A description of the space. It could describe the space&#x27;s discussion topic, functional purpose, or participants.
13811381
&quot;guidelines&quot;: &quot;A String&quot;, # Optional. The space&#x27;s rules, expectations, and etiquette.
13821382
},
1383-
&quot;threaded&quot;: True or False, # Output only. Whether messages are threaded in this space.
1383+
&quot;spaceThreadingState&quot;: &quot;A String&quot;, # Output only. The threading state in the Chat space.
1384+
&quot;threaded&quot;: True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space.
13841385
&quot;type&quot;: &quot;A String&quot;, # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space.
13851386
},
13861387
&quot;text&quot;: &quot;A String&quot;, # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip.
1387-
&quot;thread&quot;: { # A thread in Google Chat. # The thread the message belongs to.
1388-
&quot;name&quot;: &quot;A String&quot;, # Resource name, in the form &quot;spaces/*/threads/*&quot;. Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT
1388+
&quot;thread&quot;: { # A thread in Google Chat. # The thread the message belongs to. For example usage, see [Start or reply to a message thread](/chat/api/guides/crudl/messages#start_or_reply_to_a_message_thread).
1389+
&quot;name&quot;: &quot;A String&quot;, # Resource name of the thread. Example: spaces/{space}/threads/{thread}
1390+
&quot;threadKey&quot;: &quot;A String&quot;, # Optional. Opaque thread identifier. To start or add to a thread, create a message and specify a `threadKey` or the thread.name. For example usage, see [Start or reply to a message thread](/chat/api/guides/crudl/messages#start_or_reply_to_a_message_thread). For other requests, this is an output only field.
13891391
},
1392+
&quot;threadReply&quot;: True or False, # Output only. When `true`, the message is a response in a reply thread. When `false`, the message is visible in the space&#x27;s top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn&#x27;t support reply in threads, this field is always `false`.
13901393
}
13911394

13921395
messageId: string, Optional. A custom name for a Chat message assigned at creation. Must start with `client-` and contain only lowercase letters, numbers, and hyphens up to 63 characters in length. Specify this field to get, update, or delete the message with the specified value. For example usage, see [Name a created message](https://developers.google.com/chat/api/guides/crudl/messages#name_a_created_message).
1396+
messageReplyOption: string, Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces.
1397+
Allowed values
1398+
MESSAGE_REPLY_OPTION_UNSPECIFIED - Default. Starts a thread.
1399+
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD - Creates the message as a reply to the thread specified by thread ID or thread_key. If it fails, the message starts a new thread instead.
1400+
REPLY_MESSAGE_OR_FAIL - Creates the message as a reply to the thread specified by thread ID or thread_key. If it fails, a NOT_FOUND error is returned instead.
13931401
requestId: string, Optional. A unique request ID for this message. Specifying an existing request ID returns the message created with that ID instead of creating a new message.
1394-
threadKey: string, Optional. Opaque thread identifier. To start or add to a thread, create a message and specify a `threadKey` instead of thread.name. (Setting thread.name has no effect.) The first message with a given `threadKey` starts a new thread. Subsequent messages with the same `threadKey` post into the same thread.
1402+
threadKey: string, Optional. Deprecated: Use thread_key instead. Opaque thread identifier. To start or add to a thread, create a message and specify a `threadKey` or the thread.name. For example usage, see [Start or reply to a message thread](/chat/api/guides/crudl/messages#start_or_reply_to_a_message_thread).
13951403
x__xgafv: string, V1 error format.
13961404
Allowed values
13971405
1 - v1 error format
@@ -2677,21 +2685,24 @@ <h3>Method Details</h3>
26772685
&quot;slashCommand&quot;: { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable.
26782686
&quot;commandId&quot;: &quot;A String&quot;, # The id of the slash command invoked.
26792687
},
2680-
&quot;space&quot;: { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # The space the message belongs to.
2688+
&quot;space&quot;: { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. # The space the message belongs to. When accessed with [user authentication](https://developers.google.com/chat/api/guides/auth/users), only the name of the Space is populated.
26812689
&quot;displayName&quot;: &quot;A String&quot;, # The space&#x27;s display name. For direct messages between humans, this field might be empty.
26822690
&quot;name&quot;: &quot;A String&quot;, # Resource name of the space. Format: spaces/{space}
26832691
&quot;singleUserBotDm&quot;: True or False, # Optional. Whether the space is a DM between a Chat app and a single human.
26842692
&quot;spaceDetails&quot;: { # Details about the space including description and rules. # Details about the space including description and rules.
26852693
&quot;description&quot;: &quot;A String&quot;, # Optional. A description of the space. It could describe the space&#x27;s discussion topic, functional purpose, or participants.
26862694
&quot;guidelines&quot;: &quot;A String&quot;, # Optional. The space&#x27;s rules, expectations, and etiquette.
26872695
},
2688-
&quot;threaded&quot;: True or False, # Output only. Whether messages are threaded in this space.
2696+
&quot;spaceThreadingState&quot;: &quot;A String&quot;, # Output only. The threading state in the Chat space.
2697+
&quot;threaded&quot;: True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space.
26892698
&quot;type&quot;: &quot;A String&quot;, # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space.
26902699
},
26912700
&quot;text&quot;: &quot;A String&quot;, # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip.
2692-
&quot;thread&quot;: { # A thread in Google Chat. # The thread the message belongs to.
2693-
&quot;name&quot;: &quot;A String&quot;, # Resource name, in the form &quot;spaces/*/threads/*&quot;. Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT
2701+
&quot;thread&quot;: { # A thread in Google Chat. # The thread the message belongs to. For example usage, see [Start or reply to a message thread](/chat/api/guides/crudl/messages#start_or_reply_to_a_message_thread).
2702+
&quot;name&quot;: &quot;A String&quot;, # Resource name of the thread. Example: spaces/{space}/threads/{thread}
2703+
&quot;threadKey&quot;: &quot;A String&quot;, # Optional. Opaque thread identifier. To start or add to a thread, create a message and specify a `threadKey` or the thread.name. For example usage, see [Start or reply to a message thread](/chat/api/guides/crudl/messages#start_or_reply_to_a_message_thread). For other requests, this is an output only field.
26942704
},
2705+
&quot;threadReply&quot;: True or False, # Output only. When `true`, the message is a response in a reply thread. When `false`, the message is visible in the space&#x27;s top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn&#x27;t support reply in threads, this field is always `false`.
26952706
}</pre>
26962707
</div>
26972708

0 commit comments

Comments
 (0)
Please sign in to comment.