From 6dce01ba90d86496038bad226a14a9d714fb6e37 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 18 Oct 2022 07:20:47 +0000 Subject: [PATCH] feat(chat): update the api #### chat:v1 The following keys were added: - resources.dms.methods.messages.parameters.messageId (Total Keys: 2) - resources.dms.methods.webhooks.parameters.messageId (Total Keys: 2) - resources.dms.resources.conversations.methods.messages.parameters.messageId (Total Keys: 2) - resources.rooms.methods.messages.parameters.messageId (Total Keys: 2) - resources.rooms.methods.webhooks.parameters.messageId (Total Keys: 2) - resources.rooms.resources.conversations.methods.messages.parameters.messageId (Total Keys: 2) - resources.spaces.methods.webhooks.parameters.messageId (Total Keys: 2) - resources.spaces.resources.members.methods.get.scopes (Total Keys: 1) - resources.spaces.resources.members.methods.list.scopes (Total Keys: 1) - resources.spaces.resources.messages.methods.create.parameters.messageId (Total Keys: 2) - resources.spaces.resources.messages.methods.update.parameters.allowMissing (Total Keys: 2) - schemas.Message.properties.clientAssignedMessageId.type (Total Keys: 1) --- docs/dyn/chat_v1.dms.conversations.html | 7 +- docs/dyn/chat_v1.dms.html | 14 +++- docs/dyn/chat_v1.rooms.conversations.html | 7 +- docs/dyn/chat_v1.rooms.html | 14 +++- docs/dyn/chat_v1.spaces.html | 13 +-- docs/dyn/chat_v1.spaces.members.html | 6 +- docs/dyn/chat_v1.spaces.messages.html | 17 ++-- .../discovery_cache/documents/chat.v1.json | 84 ++++++++++++++++--- 8 files changed, 127 insertions(+), 35 deletions(-) diff --git a/docs/dyn/chat_v1.dms.conversations.html b/docs/dyn/chat_v1.dms.conversations.html index 35e3e751e2d..b17f9470899 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, requestId=None, threadKey=None, x__xgafv=None)

+ messages(parent, body=None, messageId=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, requestId=None, threadKey=None, x__xgafv=None) + messages(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None)
Legacy path for creating message. Calling these will result in a BadRequest response.
 
 Args:
@@ -1354,6 +1354,7 @@ 

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. @@ -1388,6 +1389,7 @@

Method Details

}, } + 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). 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. x__xgafv: string, V1 error format. @@ -2657,6 +2659,7 @@

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. diff --git a/docs/dyn/chat_v1.dms.html b/docs/dyn/chat_v1.dms.html index 0676aa32788..7b03fb2116a 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, requestId=None, threadKey=None, x__xgafv=None)

+ messages(parent, body=None, messageId=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, requestId=None, threadKey=None, x__xgafv=None)

+ webhooks(parent, body=None, messageId=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, requestId=None, threadKey=None, x__xgafv=None) + messages(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None)
Legacy path for creating message. Calling these will result in a BadRequest response.
 
 Args:
@@ -1362,6 +1362,7 @@ 

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. @@ -1396,6 +1397,7 @@

Method Details

}, } + 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). 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. x__xgafv: string, V1 error format. @@ -2665,6 +2667,7 @@

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. @@ -2701,7 +2704,7 @@

Method Details

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

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. @@ -4002,6 +4006,7 @@

Method Details

}, } + 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). 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. x__xgafv: string, V1 error format. @@ -5271,6 +5276,7 @@

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. diff --git a/docs/dyn/chat_v1.rooms.conversations.html b/docs/dyn/chat_v1.rooms.conversations.html index c6ea2fc86b2..e3c8b238580 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, requestId=None, threadKey=None, x__xgafv=None)

+ messages(parent, body=None, messageId=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, requestId=None, threadKey=None, x__xgafv=None) + messages(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None)
Legacy path for creating message. Calling these will result in a BadRequest response.
 
 Args:
@@ -1354,6 +1354,7 @@ 

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. @@ -1388,6 +1389,7 @@

Method Details

}, } + 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). 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. x__xgafv: string, V1 error format. @@ -2657,6 +2659,7 @@

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. diff --git a/docs/dyn/chat_v1.rooms.html b/docs/dyn/chat_v1.rooms.html index 5ab2809ca12..0689d0ce55c 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, requestId=None, threadKey=None, x__xgafv=None)

+ messages(parent, body=None, messageId=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, requestId=None, threadKey=None, x__xgafv=None)

+ webhooks(parent, body=None, messageId=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, requestId=None, threadKey=None, x__xgafv=None) + messages(parent, body=None, messageId=None, requestId=None, threadKey=None, x__xgafv=None)
Legacy path for creating message. Calling these will result in a BadRequest response.
 
 Args:
@@ -1362,6 +1362,7 @@ 

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. @@ -1396,6 +1397,7 @@

Method Details

}, } + 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). 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. x__xgafv: string, V1 error format. @@ -2665,6 +2667,7 @@

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. @@ -2701,7 +2704,7 @@

Method Details

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

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. @@ -4002,6 +4006,7 @@

Method Details

}, } + 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). 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. x__xgafv: string, V1 error format. @@ -5271,6 +5276,7 @@

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. diff --git a/docs/dyn/chat_v1.spaces.html b/docs/dyn/chat_v1.spaces.html index 9c63e136304..c6c296bfed7 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, requestId=None, threadKey=None, x__xgafv=None)

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

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

Method Details

@@ -137,8 +137,8 @@

Method Details

Lists spaces the caller is a member of. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts). 
 
 Args:
-  pageSize: integer, Optional. Requested page size. The value is capped at 1000. Server may return fewer results than requested. If unspecified, server will default to 100.
-  pageToken: string, Optional. A token identifying a page of results the server should return.
+  pageSize: integer, Optional. The maximum number of spaces to return. The service may return fewer than this value. If unspecified, at most 100 spaces are returned. The maximum value is 1000; values above 1000 are coerced to 1000. Negative values return an INVALID_ARGUMENT error.
+  pageToken: string, Optional. A page token, received from a previous list spaces call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided must match the call that provided the page token.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -148,7 +148,7 @@ 

Method Details

An object of the form: { - "nextPageToken": "A String", # Continuation token to retrieve the next page of results. It will be empty for the last page of results. Tokens expire in an hour. An error is thrown if an expired token is passed. + "nextPageToken": "A String", # A token that can be sent as `pageToken` to retrieve the next page of results. If empty, there are no subsequent pages. "spaces": [ # List of spaces in the requested (or first) page. { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app. "displayName": "A String", # The space's display name. For direct messages between humans, this field might be empty. @@ -180,7 +180,7 @@

Method Details

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

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. @@ -1481,6 +1482,7 @@

Method Details

}, } + 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). 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. x__xgafv: string, V1 error format. @@ -2750,6 +2752,7 @@

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. diff --git a/docs/dyn/chat_v1.spaces.members.html b/docs/dyn/chat_v1.spaces.members.html index 260b5127269..ee162f70abe 100644 --- a/docs/dyn/chat_v1.spaces.members.html +++ b/docs/dyn/chat_v1.spaces.members.html @@ -127,8 +127,8 @@

Method Details

Args: parent: string, Required. The resource name of the space for which to fetch a membership list. Format: spaces/{space} (required) - pageSize: integer, Requested page size. The value is capped at 1000. Server may return fewer results than requested. If unspecified, server will default to 100. - pageToken: string, A token identifying a page of results the server should return. + pageSize: integer, The maximum number of memberships to return. The service may return fewer than this value. If unspecified, at most 100 memberships are returned. The maximum value is 1000; values above 1000 are coerced to 1000. Negative values return an INVALID_ARGUMENT error. + pageToken: string, A page token, received from a previous list memberships call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided must match the call that provided the page token. x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -153,7 +153,7 @@

Method Details

"state": "A String", # Output only. State of the membership. }, ], - "nextPageToken": "A String", # Continuation token to retrieve the next page of results. It will be empty for the last page of results. + "nextPageToken": "A String", # A token that can be sent as `pageToken` to retrieve the next page of results. If empty, there are no subsequent pages. }
diff --git a/docs/dyn/chat_v1.spaces.messages.html b/docs/dyn/chat_v1.spaces.messages.html index c396f7d79a2..b2e70c264d1 100644 --- a/docs/dyn/chat_v1.spaces.messages.html +++ b/docs/dyn/chat_v1.spaces.messages.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

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

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

delete(name, x__xgafv=None)

@@ -92,7 +92,7 @@

Instance Methods

get(name, x__xgafv=None)

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

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

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

Method Details

@@ -101,7 +101,7 @@

Method Details

- create(parent, body=None, requestId=None, threadKey=None, x__xgafv=None) + 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).
 
 Args:
@@ -1368,6 +1368,7 @@ 

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. @@ -1402,6 +1403,7 @@

Method Details

}, } + 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). 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. x__xgafv: string, V1 error format. @@ -2671,6 +2673,7 @@

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. @@ -2729,7 +2732,7 @@

Method Details

Returns a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).
 
 Args:
-  name: string, Required. Resource name of the message to be retrieved, in the form "spaces/*/messages/*". Example: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB (required)
+  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)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -3997,6 +4000,7 @@ 

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. @@ -4033,7 +4037,7 @@

Method Details

- update(name, body=None, updateMask=None, x__xgafv=None) + 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).
 
 Args:
@@ -5300,6 +5304,7 @@ 

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. @@ -5334,6 +5339,7 @@

Method Details

}, } + 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. updateMask: string, Required. The field paths to update. Separate multiple values with commas. Currently supported field paths: - text - cards (Requires [service account authentication](/chat/api/guides/auth/service-accounts).) - cards_v2 x__xgafv: string, V1 error format. Allowed values @@ -6602,6 +6608,7 @@

Method Details

"cardId": "A String", # Required for `cardsV2` messages. Chat app-specified identifier for this widget. Scoped within a message. }, ], + "clientAssignedMessageId": "A String", # 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). "createTime": "A String", # Output only. The time at which the message was created in Google Chat server. "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). "lastUpdateTime": "A String", # Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. diff --git a/googleapiclient/discovery_cache/documents/chat.v1.json b/googleapiclient/discovery_cache/documents/chat.v1.json index fd7521952ce..682db3f8920 100644 --- a/googleapiclient/discovery_cache/documents/chat.v1.json +++ b/googleapiclient/discovery_cache/documents/chat.v1.json @@ -1,4 +1,13 @@ { + "auth": { + "oauth2": { + "scopes": { + "https://www.googleapis.com/auth/chat.memberships": { + "description": "View, add, and remove members from conversations in Google Chat" + } + } + } + }, "basePath": "", "baseUrl": "https://chat.googleapis.com/", "batchPath": "batch", @@ -107,6 +116,11 @@ "parent" ], "parameters": { + "messageId": { + "description": "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).", + "location": "query", + "type": "string" + }, "parent": { "description": "Required. Space resource name, in the form \"spaces/*\". Example: spaces/AAAAAAAAAAA", "location": "path", @@ -142,6 +156,11 @@ "parent" ], "parameters": { + "messageId": { + "description": "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).", + "location": "query", + "type": "string" + }, "parent": { "description": "Required. Space resource name, in the form \"spaces/*\". Example: spaces/AAAAAAAAAAA", "location": "path", @@ -181,6 +200,11 @@ "parent" ], "parameters": { + "messageId": { + "description": "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).", + "location": "query", + "type": "string" + }, "parent": { "description": "Required. Space resource name, in the form \"spaces/*\". Example: spaces/AAAAAAAAAAA", "location": "path", @@ -249,6 +273,11 @@ "parent" ], "parameters": { + "messageId": { + "description": "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).", + "location": "query", + "type": "string" + }, "parent": { "description": "Required. Space resource name, in the form \"spaces/*\". Example: spaces/AAAAAAAAAAA", "location": "path", @@ -284,6 +313,11 @@ "parent" ], "parameters": { + "messageId": { + "description": "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).", + "location": "query", + "type": "string" + }, "parent": { "description": "Required. Space resource name, in the form \"spaces/*\". Example: spaces/AAAAAAAAAAA", "location": "path", @@ -323,6 +357,11 @@ "parent" ], "parameters": { + "messageId": { + "description": "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).", + "location": "query", + "type": "string" + }, "parent": { "description": "Required. Space resource name, in the form \"spaces/*\". Example: spaces/AAAAAAAAAAA", "location": "path", @@ -385,13 +424,13 @@ "parameterOrder": [], "parameters": { "pageSize": { - "description": "Optional. Requested page size. The value is capped at 1000. Server may return fewer results than requested. If unspecified, server will default to 100.", + "description": "Optional. The maximum number of spaces to return. The service may return fewer than this value. If unspecified, at most 100 spaces are returned. The maximum value is 1000; values above 1000 are coerced to 1000. Negative values return an INVALID_ARGUMENT error.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "Optional. A token identifying a page of results the server should return.", + "description": "Optional. A page token, received from a previous list spaces call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided must match the call that provided the page token.", "location": "query", "type": "string" } @@ -410,6 +449,11 @@ "parent" ], "parameters": { + "messageId": { + "description": "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).", + "location": "query", + "type": "string" + }, "parent": { "description": "Required. Space resource name, in the form \"spaces/*\". Example: spaces/AAAAAAAAAAA", "location": "path", @@ -460,7 +504,10 @@ "path": "v1/{+name}", "response": { "$ref": "Membership" - } + }, + "scopes": [ + "https://www.googleapis.com/auth/chat.memberships" + ] }, "list": { "description": "Lists human memberships in a space for joined members. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", @@ -472,13 +519,13 @@ ], "parameters": { "pageSize": { - "description": "Requested page size. The value is capped at 1000. Server may return fewer results than requested. If unspecified, server will default to 100.", + "description": "The maximum number of memberships to return. The service may return fewer than this value. If unspecified, at most 100 memberships are returned. The maximum value is 1000; values above 1000 are coerced to 1000. Negative values return an INVALID_ARGUMENT error.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "A token identifying a page of results the server should return.", + "description": "A page token, received from a previous list memberships call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided must match the call that provided the page token.", "location": "query", "type": "string" }, @@ -493,7 +540,10 @@ "path": "v1/{+parent}/members", "response": { "$ref": "ListMembershipsResponse" - } + }, + "scopes": [ + "https://www.googleapis.com/auth/chat.memberships" + ] } } }, @@ -508,6 +558,11 @@ "parent" ], "parameters": { + "messageId": { + "description": "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).", + "location": "query", + "type": "string" + }, "parent": { "description": "Required. Space resource name, in the form \"spaces/*\". Example: spaces/AAAAAAAAAAA", "location": "path", @@ -566,7 +621,7 @@ ], "parameters": { "name": { - "description": "Required. Resource name of the message to be retrieved, in the form \"spaces/*/messages/*\". Example: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB", + "description": "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).", "location": "path", "pattern": "^spaces/[^/]+/messages/[^/]+$", "required": true, @@ -587,6 +642,11 @@ "name" ], "parameters": { + "allowMissing": { + "description": "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.", + "location": "query", + "type": "boolean" + }, "name": { "description": "Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`", "location": "path", @@ -642,7 +702,7 @@ } } }, - "revision": "20221006", + "revision": "20221013", "rootUrl": "https://chat.googleapis.com/", "schemas": { "ActionParameter": { @@ -2350,7 +2410,7 @@ "type": "array" }, "nextPageToken": { - "description": "Continuation token to retrieve the next page of results. It will be empty for the last page of results.", + "description": "A token that can be sent as `pageToken` to retrieve the next page of results. If empty, there are no subsequent pages.", "type": "string" } }, @@ -2360,7 +2420,7 @@ "id": "ListSpacesResponse", "properties": { "nextPageToken": { - "description": "Continuation token to retrieve the next page of results. It will be empty for the last page of results. Tokens expire in an hour. An error is thrown if an expired token is passed.", + "description": "A token that can be sent as `pageToken` to retrieve the next page of results. If empty, there are no subsequent pages.", "type": "string" }, "spaces": { @@ -2490,6 +2550,10 @@ }, "type": "array" }, + "clientAssignedMessageId": { + "description": "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).", + "type": "string" + }, "createTime": { "description": "Output only. The time at which the message was created in Google Chat server.", "format": "google-datetime",