diff --git a/docs/dyn/chat_v1.dms.conversations.html b/docs/dyn/chat_v1.dms.conversations.html index b17f9470899..498750369e1 100644 --- a/docs/dyn/chat_v1.dms.conversations.html +++ b/docs/dyn/chat_v1.dms.conversations.html @@ -78,7 +78,7 @@

Instance Methods

close()

Close httplib2 connections.

- messages(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None)

+ messages(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)

Legacy path for creating message. Calling these will result in a BadRequest response.

Method Details

@@ -87,7 +87,7 @@

Method Details

- messages(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None) + messages(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)
Legacy path for creating message. Calling these will result in a BadRequest response.
 
 Args:
@@ -1372,7 +1372,7 @@ 

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -1380,18 +1380,26 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. } 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). + messageReplyOption: string, Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces. + Allowed values + MESSAGE_REPLY_OPTION_UNSPECIFIED - Default. Starts a thread. + 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. + 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. 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. - 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. + 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). x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -2677,7 +2685,7 @@

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -2685,13 +2693,16 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. }
diff --git a/docs/dyn/chat_v1.dms.html b/docs/dyn/chat_v1.dms.html index 7b03fb2116a..2fcd06bd70b 100644 --- a/docs/dyn/chat_v1.dms.html +++ b/docs/dyn/chat_v1.dms.html @@ -83,10 +83,10 @@

Instance Methods

close()

Close httplib2 connections.

- messages(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None)

+ messages(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)

Legacy path for creating message. Calling these will result in a BadRequest response.

- webhooks(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None)

+ webhooks(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)

Legacy path for creating message. Calling these will result in a BadRequest response.

Method Details

@@ -95,7 +95,7 @@

Method Details

- messages(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None) + messages(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)
Legacy path for creating message. Calling these will result in a BadRequest response.
 
 Args:
@@ -1380,7 +1380,7 @@ 

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -1388,18 +1388,26 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. } 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). + messageReplyOption: string, Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces. + Allowed values + MESSAGE_REPLY_OPTION_UNSPECIFIED - Default. Starts a thread. + 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. + 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. 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. - 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. + 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). x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -2685,7 +2693,7 @@

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -2693,18 +2701,21 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. }
- webhooks(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None) + webhooks(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)
Legacy path for creating message. Calling these will result in a BadRequest response.
 
 Args:
@@ -3989,7 +4000,7 @@ 

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -3997,18 +4008,26 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. } 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). + messageReplyOption: string, Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces. + Allowed values + MESSAGE_REPLY_OPTION_UNSPECIFIED - Default. Starts a thread. + 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. + 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. 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. - 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. + 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). x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -5294,7 +5313,7 @@

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -5302,13 +5321,16 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. }
diff --git a/docs/dyn/chat_v1.rooms.conversations.html b/docs/dyn/chat_v1.rooms.conversations.html index e3c8b238580..56097fa6042 100644 --- a/docs/dyn/chat_v1.rooms.conversations.html +++ b/docs/dyn/chat_v1.rooms.conversations.html @@ -78,7 +78,7 @@

Instance Methods

close()

Close httplib2 connections.

- messages(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None)

+ messages(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)

Legacy path for creating message. Calling these will result in a BadRequest response.

Method Details

@@ -87,7 +87,7 @@

Method Details

- messages(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None) + messages(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)
Legacy path for creating message. Calling these will result in a BadRequest response.
 
 Args:
@@ -1372,7 +1372,7 @@ 

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -1380,18 +1380,26 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. } 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). + messageReplyOption: string, Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces. + Allowed values + MESSAGE_REPLY_OPTION_UNSPECIFIED - Default. Starts a thread. + 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. + 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. 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. - 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. + 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). x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -2677,7 +2685,7 @@

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -2685,13 +2693,16 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. }
diff --git a/docs/dyn/chat_v1.rooms.html b/docs/dyn/chat_v1.rooms.html index 0689d0ce55c..11d62813114 100644 --- a/docs/dyn/chat_v1.rooms.html +++ b/docs/dyn/chat_v1.rooms.html @@ -83,10 +83,10 @@

Instance Methods

close()

Close httplib2 connections.

- messages(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None)

+ messages(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)

Legacy path for creating message. Calling these will result in a BadRequest response.

- webhooks(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None)

+ webhooks(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)

Legacy path for creating message. Calling these will result in a BadRequest response.

Method Details

@@ -95,7 +95,7 @@

Method Details

- messages(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None) + messages(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)
Legacy path for creating message. Calling these will result in a BadRequest response.
 
 Args:
@@ -1380,7 +1380,7 @@ 

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -1388,18 +1388,26 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. } 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). + messageReplyOption: string, Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces. + Allowed values + MESSAGE_REPLY_OPTION_UNSPECIFIED - Default. Starts a thread. + 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. + 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. 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. - 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. + 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). x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -2685,7 +2693,7 @@

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -2693,18 +2701,21 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. }
- webhooks(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None) + webhooks(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)
Legacy path for creating message. Calling these will result in a BadRequest response.
 
 Args:
@@ -3989,7 +4000,7 @@ 

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -3997,18 +4008,26 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. } 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). + messageReplyOption: string, Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces. + Allowed values + MESSAGE_REPLY_OPTION_UNSPECIFIED - Default. Starts a thread. + 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. + 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. 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. - 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. + 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). x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -5294,7 +5313,7 @@

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -5302,13 +5321,16 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. }
diff --git a/docs/dyn/chat_v1.spaces.html b/docs/dyn/chat_v1.spaces.html index c6c296bfed7..002dd7935a3 100644 --- a/docs/dyn/chat_v1.spaces.html +++ b/docs/dyn/chat_v1.spaces.html @@ -97,7 +97,7 @@

Instance Methods

list_next()

Retrieves the next page of results.

- webhooks(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None)

+ webhooks(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)

Legacy path for creating message. Calling these will result in a BadRequest response.

Method Details

@@ -127,7 +127,8 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }
@@ -158,7 +159,8 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, ], @@ -180,7 +182,7 @@

Method Details

- webhooks(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None) + webhooks(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)
Legacy path for creating message. Calling these will result in a BadRequest response.
 
 Args:
@@ -1465,7 +1467,7 @@ 

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -1473,18 +1475,26 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. } 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). + messageReplyOption: string, Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces. + Allowed values + MESSAGE_REPLY_OPTION_UNSPECIFIED - Default. Starts a thread. + 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. + 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. 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. - 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. + 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). x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -2770,7 +2780,7 @@

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -2778,13 +2788,16 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. }
diff --git a/docs/dyn/chat_v1.spaces.messages.html b/docs/dyn/chat_v1.spaces.messages.html index b2e70c264d1..5cdf1d624d6 100644 --- a/docs/dyn/chat_v1.spaces.messages.html +++ b/docs/dyn/chat_v1.spaces.messages.html @@ -83,14 +83,14 @@

Instance Methods

close()

Close httplib2 connections.

- create(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None)

-

Creates a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).

+ create(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)

+

[Developer Preview](https://developers.google.com/workspace/preview): Creates a message. Requires [authentication](https://developers.google.com/chat/api/guides/auth).

delete(name, x__xgafv=None)

-

Deletes a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).

+

Deletes a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts). [Developer Preview](https://developers.google.com/workspace/preview): Deletes a message. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.messages` authorization scope.

get(name, x__xgafv=None)

-

Returns a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).

+

Returns a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts). [Developer Preview](https://developers.google.com/workspace/preview): Returns a message. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.messages` or `chat.messages.readonly` authorization scope. Messages from a blocked member or messages from a blocked space can also be fetched.

update(name, allowMissing=None, body=None, updateMask=None, x__xgafv=None)

Updates a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).

@@ -101,8 +101,8 @@

Method Details

- create(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None) -
Creates a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).
+    create(parent, body=None, messageId=None, messageReplyOption=None, requestId=None, threadKey=None, x__xgafv=None)
+  
[Developer Preview](https://developers.google.com/workspace/preview): Creates a message. Requires [authentication](https://developers.google.com/chat/api/guides/auth).
 
 Args:
   parent: string, Required. Space resource name, in the form "spaces/*". Example: spaces/AAAAAAAAAAA (required)
@@ -1386,7 +1386,7 @@ 

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -1394,18 +1394,26 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. } 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). + messageReplyOption: string, Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces. + Allowed values + MESSAGE_REPLY_OPTION_UNSPECIFIED - Default. Starts a thread. + 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. + 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. 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. - 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. + 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). x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -2691,7 +2699,7 @@

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -2699,19 +2707,22 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. }
delete(name, x__xgafv=None) -
Deletes a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).
+  
Deletes a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts). [Developer Preview](https://developers.google.com/workspace/preview): Deletes a message. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.messages` authorization scope.
 
 Args:
   name: string, Required. Resource name of the message to be deleted, in the form "spaces/*/messages/*" Example: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB (required)
@@ -2729,7 +2740,7 @@ 

Method Details

get(name, x__xgafv=None) -
Returns a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).
+  
Returns a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts). [Developer Preview](https://developers.google.com/workspace/preview): Returns a message. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.messages` or `chat.messages.readonly` authorization scope. Messages from a blocked member or messages from a blocked space can also be fetched.
 
 Args:
   name: string, Required. Resource name of the message to retrieve. Format: spaces/{space}/messages/{message} If the message begins with `client-`, then it has a custom name assigned by a Chat app that created it with the Chat REST API. That Chat app (but not others) can pass the custom name to get, update, or delete the message. To learn more, see [create and name a message] (https://developers.google.com/chat/api/guides/crudl/messages#name_a_created_message). (required)
@@ -4018,7 +4029,7 @@ 

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -4026,13 +4037,16 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. }
@@ -5322,7 +5336,7 @@

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -5330,13 +5344,16 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. } allowMissing: boolean, Optional. If `true` and the message is not found, a new message is created and `updateMask` is ignored. The specified message ID must be [client-assigned](https://developers.google.com/chat/api/guides/crudl/messages#name_a_created_message) or the request fails. @@ -6626,7 +6643,7 @@

Method Details

"slashCommand": { # A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat. # Output only. Slash command information, if applicable. "commandId": "A String", # The id of the slash command invoked. }, - "space": { # 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. + "space": { # 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. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. "name": "A String", # Resource name of the space. Format: spaces/{space} "singleUserBotDm": True or False, # Optional. Whether the space is a DM between a Chat app and a single human. @@ -6634,13 +6651,16 @@

Method Details

"description": "A String", # Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. "guidelines": "A String", # Optional. The space's rules, expectations, and etiquette. }, - "threaded": True or False, # Output only. Whether messages are threaded in this space. + "spaceThreadingState": "A String", # Output only. The threading state in the Chat space. + "threaded": True or False, # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space. "type": "A String", # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer preview) instead. The type of a space. }, "text": "A String", # Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip. - "thread": { # A thread in Google Chat. # The thread the message belongs to. - "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT + "thread": { # 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). + "name": "A String", # Resource name of the thread. Example: spaces/{space}/threads/{thread} + "threadKey": "A String", # 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. }, + "threadReply": 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's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`. }
diff --git a/googleapiclient/discovery_cache/documents/chat.v1.json b/googleapiclient/discovery_cache/documents/chat.v1.json index 682db3f8920..04881a47285 100644 --- a/googleapiclient/discovery_cache/documents/chat.v1.json +++ b/googleapiclient/discovery_cache/documents/chat.v1.json @@ -121,6 +121,21 @@ "location": "query", "type": "string" }, + "messageReplyOption": { + "description": "Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces.", + "enum": [ + "MESSAGE_REPLY_OPTION_UNSPECIFIED", + "REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD", + "REPLY_MESSAGE_OR_FAIL" + ], + "enumDescriptions": [ + "Default. Starts a 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.", + "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." + ], + "location": "query", + "type": "string" + }, "parent": { "description": "Required. Space resource name, in the form \"spaces/*\". Example: spaces/AAAAAAAAAAA", "location": "path", @@ -134,7 +149,7 @@ "type": "string" }, "threadKey": { - "description": "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.", + "description": "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).", "location": "query", "type": "string" } @@ -161,6 +176,21 @@ "location": "query", "type": "string" }, + "messageReplyOption": { + "description": "Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces.", + "enum": [ + "MESSAGE_REPLY_OPTION_UNSPECIFIED", + "REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD", + "REPLY_MESSAGE_OR_FAIL" + ], + "enumDescriptions": [ + "Default. Starts a 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.", + "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." + ], + "location": "query", + "type": "string" + }, "parent": { "description": "Required. Space resource name, in the form \"spaces/*\". Example: spaces/AAAAAAAAAAA", "location": "path", @@ -174,7 +204,7 @@ "type": "string" }, "threadKey": { - "description": "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.", + "description": "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).", "location": "query", "type": "string" } @@ -205,6 +235,21 @@ "location": "query", "type": "string" }, + "messageReplyOption": { + "description": "Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces.", + "enum": [ + "MESSAGE_REPLY_OPTION_UNSPECIFIED", + "REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD", + "REPLY_MESSAGE_OR_FAIL" + ], + "enumDescriptions": [ + "Default. Starts a 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.", + "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." + ], + "location": "query", + "type": "string" + }, "parent": { "description": "Required. Space resource name, in the form \"spaces/*\". Example: spaces/AAAAAAAAAAA", "location": "path", @@ -218,7 +263,7 @@ "type": "string" }, "threadKey": { - "description": "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.", + "description": "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).", "location": "query", "type": "string" } @@ -278,6 +323,21 @@ "location": "query", "type": "string" }, + "messageReplyOption": { + "description": "Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces.", + "enum": [ + "MESSAGE_REPLY_OPTION_UNSPECIFIED", + "REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD", + "REPLY_MESSAGE_OR_FAIL" + ], + "enumDescriptions": [ + "Default. Starts a 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.", + "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." + ], + "location": "query", + "type": "string" + }, "parent": { "description": "Required. Space resource name, in the form \"spaces/*\". Example: spaces/AAAAAAAAAAA", "location": "path", @@ -291,7 +351,7 @@ "type": "string" }, "threadKey": { - "description": "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.", + "description": "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).", "location": "query", "type": "string" } @@ -318,6 +378,21 @@ "location": "query", "type": "string" }, + "messageReplyOption": { + "description": "Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces.", + "enum": [ + "MESSAGE_REPLY_OPTION_UNSPECIFIED", + "REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD", + "REPLY_MESSAGE_OR_FAIL" + ], + "enumDescriptions": [ + "Default. Starts a 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.", + "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." + ], + "location": "query", + "type": "string" + }, "parent": { "description": "Required. Space resource name, in the form \"spaces/*\". Example: spaces/AAAAAAAAAAA", "location": "path", @@ -331,7 +406,7 @@ "type": "string" }, "threadKey": { - "description": "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.", + "description": "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).", "location": "query", "type": "string" } @@ -362,6 +437,21 @@ "location": "query", "type": "string" }, + "messageReplyOption": { + "description": "Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces.", + "enum": [ + "MESSAGE_REPLY_OPTION_UNSPECIFIED", + "REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD", + "REPLY_MESSAGE_OR_FAIL" + ], + "enumDescriptions": [ + "Default. Starts a 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.", + "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." + ], + "location": "query", + "type": "string" + }, "parent": { "description": "Required. Space resource name, in the form \"spaces/*\". Example: spaces/AAAAAAAAAAA", "location": "path", @@ -375,7 +465,7 @@ "type": "string" }, "threadKey": { - "description": "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.", + "description": "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).", "location": "query", "type": "string" } @@ -454,6 +544,21 @@ "location": "query", "type": "string" }, + "messageReplyOption": { + "description": "Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces.", + "enum": [ + "MESSAGE_REPLY_OPTION_UNSPECIFIED", + "REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD", + "REPLY_MESSAGE_OR_FAIL" + ], + "enumDescriptions": [ + "Default. Starts a 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.", + "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." + ], + "location": "query", + "type": "string" + }, "parent": { "description": "Required. Space resource name, in the form \"spaces/*\". Example: spaces/AAAAAAAAAAA", "location": "path", @@ -467,7 +572,7 @@ "type": "string" }, "threadKey": { - "description": "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.", + "description": "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).", "location": "query", "type": "string" } @@ -550,7 +655,7 @@ "messages": { "methods": { "create": { - "description": "Creates a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", + "description": "[Developer Preview](https://developers.google.com/workspace/preview): Creates a message. Requires [authentication](https://developers.google.com/chat/api/guides/auth).", "flatPath": "v1/spaces/{spacesId}/messages", "httpMethod": "POST", "id": "chat.spaces.messages.create", @@ -563,6 +668,21 @@ "location": "query", "type": "string" }, + "messageReplyOption": { + "description": "Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces.", + "enum": [ + "MESSAGE_REPLY_OPTION_UNSPECIFIED", + "REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD", + "REPLY_MESSAGE_OR_FAIL" + ], + "enumDescriptions": [ + "Default. Starts a 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.", + "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." + ], + "location": "query", + "type": "string" + }, "parent": { "description": "Required. Space resource name, in the form \"spaces/*\". Example: spaces/AAAAAAAAAAA", "location": "path", @@ -576,7 +696,7 @@ "type": "string" }, "threadKey": { - "description": "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.", + "description": "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).", "location": "query", "type": "string" } @@ -590,7 +710,7 @@ } }, "delete": { - "description": "Deletes a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", + "description": "Deletes a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts). [Developer Preview](https://developers.google.com/workspace/preview): Deletes a message. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.messages` authorization scope.", "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}", "httpMethod": "DELETE", "id": "chat.spaces.messages.delete", @@ -612,7 +732,7 @@ } }, "get": { - "description": "Returns a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", + "description": "Returns a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts). [Developer Preview](https://developers.google.com/workspace/preview): Returns a message. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.messages` or `chat.messages.readonly` authorization scope. Messages from a blocked member or messages from a blocked space can also be fetched.", "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}", "httpMethod": "GET", "id": "chat.spaces.messages.get", @@ -702,7 +822,7 @@ } } }, - "revision": "20221013", + "revision": "20221020", "rootUrl": "https://chat.googleapis.com/", "schemas": { "ActionParameter": { @@ -2591,7 +2711,7 @@ }, "space": { "$ref": "Space", - "description": "The space the message belongs to." + "description": "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." }, "text": { "description": "Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip.", @@ -2599,7 +2719,12 @@ }, "thread": { "$ref": "Thread", - "description": "The thread the message belongs to." + "description": "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)." + }, + "threadReply": { + "description": "Output only. When `true`, the message is a response in a reply thread. When `false`, the message is visible in the space's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`.", + "readOnly": true, + "type": "boolean" } }, "type": "object" @@ -2718,8 +2843,25 @@ "$ref": "SpaceDetails", "description": "Details about the space including description and rules." }, + "spaceThreadingState": { + "description": "Output only. The threading state in the Chat space.", + "enum": [ + "SPACE_THREADING_STATE_UNSPECIFIED", + "THREADED_MESSAGES", + "GROUPED_MESSAGES", + "UNTHREADED_MESSAGES" + ], + "enumDescriptions": [ + "Reserved.", + "Named spaces that support message threads. When users respond to a message, they can reply in-thread, which keeps their response in the context of the original message.", + "Named spaces where the conversation is organized by topic. Topics and their replies are grouped together.", + "Direct messages (DMs) between two people and group conversations between 3 or more people." + ], + "readOnly": true, + "type": "string" + }, "threaded": { - "description": "Output only. Whether messages are threaded in this space.", + "description": "Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space.", "readOnly": true, "type": "boolean" }, @@ -2827,7 +2969,11 @@ "id": "Thread", "properties": { "name": { - "description": "Resource name, in the form \"spaces/*/threads/*\". Example: spaces/AAAAAAAAAAA/threads/TTTTTTTTTTT", + "description": "Resource name of the thread. Example: spaces/{space}/threads/{thread}", + "type": "string" + }, + "threadKey": { + "description": "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.", "type": "string" } },