feat: Automated regeneration of Chat client (#11258)

Auto-created at 2024-04-04 13:09:37 +0000 using the toys pull request generator.

clients/chat/lib/google_api/chat/v1/api/spaces.ex

@@ -1418,12 +1418,12 @@ defmodule GoogleApi.Chat.V1.Api.Spaces do
   end
 
   @doc """
-  Returns a SpaceEvent. You can request events from up to 28 days before the time of the request. The server will return the most recent version of the resource. For example, if a `google.workspace.chat.message.v1.created` event is requested and the message has since been deleted, the returned event will contain the deleted message resource in the payload. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users).
+  Returns an event from a Google Chat space. The [event payload](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.oneof_payload) contains the most recent version of the resource that changed. For example, if you request an event about a new message but the message was later updated, the server returns the updated `Message` resource in the event payload. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users). To get an event, the authenticated user must be a member of the space. For an example, see [Get details about an event from a Google Chat space](https://developers.google.com/workspace/chat/get-space-event).
 
   ## Parameters
 
   *   `connection` (*type:* `GoogleApi.Chat.V1.Connection.t`) - Connection to server
-  *   `name` (*type:* `String.t`) - Required. The resource name of the event. Format: `spaces/{space}/spaceEvents/{spaceEvent}`
+  *   `name` (*type:* `String.t`) - Required. The resource name of the space event. Format: `spaces/{space}/spaceEvents/{spaceEvent}`
   *   `optional_params` (*type:* `keyword()`) - Optional parameters
       *   `:"$.xgafv"` (*type:* `String.t`) - V1 error format.
       *   `:access_token` (*type:* `String.t`) - OAuth access token.
@@ -1478,12 +1478,12 @@ defmodule GoogleApi.Chat.V1.Api.Spaces do
   end
 
   @doc """
-  Lists SpaceEvents in a space that the caller is a member of. You can request events from up to 28 days before the time of the request. The server will return the most recent version of the resources. For example, if a `google.workspace.chat.message.v1.created` event is requested and the message has since been deleted, the returned event will contain the deleted message resource in the payload. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users).
+  Lists events from a Google Chat space. For each event, the [payload](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.oneof_payload) contains the most recent version of the Chat resource. For example, if you list events about new space members, the server returns `Membership` resources that contain the latest membership details. If new members were removed during the requested period, the event payload contains an empty `Membership` resource. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users). To list events, the authenticated user must be a member of the space. For an example, see [List events from a Google Chat space](https://developers.google.com/workspace/chat/list-space-events).
 
   ## Parameters
 
   *   `connection` (*type:* `GoogleApi.Chat.V1.Connection.t`) - Connection to server
-  *   `parent` (*type:* `String.t`) - Required. The resource name of the space from which to list events. Format: `spaces/{space}`.
+  *   `parent` (*type:* `String.t`) - Required. Resource name of the [Google Chat space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) where the events occurred. Format: `spaces/{space}`.
   *   `optional_params` (*type:* `keyword()`) - Optional parameters
       *   `:"$.xgafv"` (*type:* `String.t`) - V1 error format.
       *   `:access_token` (*type:* `String.t`) - OAuth access token.
@@ -1496,8 +1496,8 @@ defmodule GoogleApi.Chat.V1.Api.Spaces do
       *   `:quotaUser` (*type:* `String.t`) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
       *   `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart").
       *   `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart").
-      *   `:filter` (*type:* `String.t`) - Required. A query filter. This method supports filtering by: `event_types`, `start_time`, and `end_time`. `event_types`: You must specify at least one event type in your query. `event_types` supports the has `:` operator. To filter by multiple event types, use the `OR` operator. To see the list of currently supported event types, see google.chat.v1.SpaceEvent.event_type `start_time`: Exclusive timestamp from which to start listing space events. You can list events that occurred up to 28 days ago. If unspecified, lists space events from the 28 days ago up to end time. `end_time`: Inclusive timestamp up to which space events are listed. Default value is the present. `start_time` and `end_time` accept a timestamp in [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339) format and support the equals `=` comparison operator. To filter by both `start_time` and `end_time`, use the `AND` operator. For example, the following queries are valid: ``` start_time="2023-08-23T19:20:33+00:00" AND end_time="2023-08-23T19:21:54+00:00" ``` ``` start_time="2023-08-23T19:20:33+00:00" AND (event_types:"google.workspace.chat.space.v1.updated" OR event_types:"google.workspace.chat.message.v1.created") ``` The following queries are invalid: ``` start_time="2023-08-23T19:20:33+00:00" OR end_time="2023-08-23T19:21:54+00:00" ``` ``` event_types:"google.workspace.chat.space.v1.updated" AND event_types:"google.workspace.chat.message.v1.created" ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.
-      *   `:pageSize` (*type:* `integer()`) - Optional. The maximum number of space events returned. The service may return fewer than this value. Negative values return an `INVALID_ARGUMENT` error.
+      *   `:filter` (*type:* `String.t`) - Required. A query filter. You must specify at least one event type (`event_type`) using the has `:` operator. To filter by multiple event types, use the `OR` operator. Omit batch event types in your filter. The request automatically returns any related batch events. For example, if you filter by new reactions (`google.workspace.chat.reaction.v1.created`), the server also returns batch new reactions events (`google.workspace.chat.reaction.v1.batchCreated`). For a list of supported event types, see the [`SpaceEvents` reference documentation](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.event_type). Optionally, you can also filter by start time (`start_time`) and end time (`end_time`): * `start_time`: Exclusive timestamp from which to start listing space events. You can list events that occurred up to 28 days ago. If unspecified, lists space events from the past 28 days. * `end_time`: Inclusive timestamp until which space events are listed. If unspecified, lists events up to the time of the request. To specify a start or end time, use the equals `=` operator and format in [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339). To filter by both `start_time` and `end_time`, use the `AND` operator. For example, the following queries are valid: ``` start_time="2023-08-23T19:20:33+00:00" AND end_time="2023-08-23T19:21:54+00:00" ``` ``` start_time="2023-08-23T19:20:33+00:00" AND (event_types:"google.workspace.chat.space.v1.updated" OR event_types:"google.workspace.chat.message.v1.created") ``` The following queries are invalid: ``` start_time="2023-08-23T19:20:33+00:00" OR end_time="2023-08-23T19:21:54+00:00" ``` ``` event_types:"google.workspace.chat.space.v1.updated" AND event_types:"google.workspace.chat.message.v1.created" ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.
+      *   `:pageSize` (*type:* `integer()`) - Optional. The maximum number of space events returned. The service might return fewer than this value. Negative values return an `INVALID_ARGUMENT` error.
       *   `:pageToken` (*type:* `String.t`) - A page token, received from a previous list space events call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to list space events must match the call that provided the page token. Passing different values to the other parameters might lead to unexpected results.
   *   `opts` (*type:* `keyword()`) - Call options
 

clients/chat/lib/google_api/chat/v1/metadata.ex

@@ -20,7 +20,7 @@ defmodule GoogleApi.Chat.V1 do
   API client metadata for GoogleApi.Chat.V1.
   """
 
-  @discovery_revision "20240326"
+  @discovery_revision "20240331"
 
   def discovery_revision(), do: @discovery_revision
 end

clients/chat/lib/google_api/chat/v1/model/membership_batch_created_event_data.ex

@@ -17,11 +17,11 @@
 
 defmodule GoogleApi.Chat.V1.Model.MembershipBatchCreatedEventData do
   @moduledoc """
-  Payload for batch new membership events where the `EventType` field is `google.workspace.chat.membership.v1.batchCreated`.
+  Event payload for multiple new memberships. Event type: `google.workspace.chat.membership.v1.batchCreated`
 
   ## Attributes
 
-  *   `memberships` (*type:* `list(GoogleApi.Chat.V1.Model.MembershipCreatedEventData.t)`, *default:* `nil`) - A list of created memberships.
+  *   `memberships` (*type:* `list(GoogleApi.Chat.V1.Model.MembershipCreatedEventData.t)`, *default:* `nil`) - A list of new memberships.
   """
 
   use GoogleApi.Gax.ModelBase

clients/chat/lib/google_api/chat/v1/model/membership_batch_deleted_event_data.ex

@@ -17,7 +17,7 @@
 
 defmodule GoogleApi.Chat.V1.Model.MembershipBatchDeletedEventData do
   @moduledoc """
-  Payload for batch deleted membership events where the `EventType` field is `google.workspace.chat.membership.v1.batchDeleted`.
+  Event payload for multiple deleted memberships. Event type: `google.workspace.chat.membership.v1.batchDeleted`
 
   ## Attributes
 

clients/chat/lib/google_api/chat/v1/model/membership_batch_updated_event_data.ex

@@ -17,7 +17,7 @@
 
 defmodule GoogleApi.Chat.V1.Model.MembershipBatchUpdatedEventData do
   @moduledoc """
-  Payload for batch updated membership events where the `EventType` field is `google.workspace.chat.membership.v1.batchUpdated`.
+  Event payload for multiple updated memberships. Event type: `google.workspace.chat.membership.v1.batchUpdated`
 
   ## Attributes
 

clients/chat/lib/google_api/chat/v1/model/membership_created_event_data.ex

@@ -17,11 +17,11 @@
 
 defmodule GoogleApi.Chat.V1.Model.MembershipCreatedEventData do
   @moduledoc """
-  Payload for new membership events where the `EventType` field is `google.workspace.chat.membership.v1.created`.
+  Event payload for a new membership. Event type: `google.workspace.chat.membership.v1.created`.
 
   ## Attributes
 
-  *   `membership` (*type:* `GoogleApi.Chat.V1.Model.Membership.t`, *default:* `nil`) - The most recent version of membership.
+  *   `membership` (*type:* `GoogleApi.Chat.V1.Model.Membership.t`, *default:* `nil`) - The new membership.
   """
 
   use GoogleApi.Gax.ModelBase

clients/chat/lib/google_api/chat/v1/model/membership_deleted_event_data.ex

@@ -17,11 +17,11 @@
 
 defmodule GoogleApi.Chat.V1.Model.MembershipDeletedEventData do
   @moduledoc """
-  Payload for deleted membership events where the `EventType` field is `google.workspace.chat.membership.v1.deleted`.
+  Event payload for a deleted membership. Event type: `google.workspace.chat.membership.v1.deleted`
 
   ## Attributes
 
-  *   `membership` (*type:* `GoogleApi.Chat.V1.Model.Membership.t`, *default:* `nil`) - The deleted membership. Only `name` and `state` are populated.
+  *   `membership` (*type:* `GoogleApi.Chat.V1.Model.Membership.t`, *default:* `nil`) - The deleted membership. Only the `name` and `state` fields are populated.
   """
 
   use GoogleApi.Gax.ModelBase

clients/chat/lib/google_api/chat/v1/model/membership_updated_event_data.ex

@@ -17,11 +17,11 @@
 
 defmodule GoogleApi.Chat.V1.Model.MembershipUpdatedEventData do
   @moduledoc """
-  Payload for updated membership events where the `EventType` field is `google.workspace.chat.membership.v1.updated`.
+  Event payload for an updated membership. Event type: `google.workspace.chat.membership.v1.updated`
 
   ## Attributes
 
-  *   `membership` (*type:* `GoogleApi.Chat.V1.Model.Membership.t`, *default:* `nil`) - The most recent version of membership.
+  *   `membership` (*type:* `GoogleApi.Chat.V1.Model.Membership.t`, *default:* `nil`) - The updated membership.
   """
 
   use GoogleApi.Gax.ModelBase

clients/chat/lib/google_api/chat/v1/model/message_batch_created_event_data.ex

@@ -17,11 +17,11 @@
 
 defmodule GoogleApi.Chat.V1.Model.MessageBatchCreatedEventData do
   @moduledoc """
-  Payload for batch new message events where the `EventType` field is `google.workspace.chat.message.v1.batchCreated`.
+  Event payload for multiple new messages. Event type: `google.workspace.chat.message.v1.batchCreated`
 
   ## Attributes
 
-  *   `messages` (*type:* `list(GoogleApi.Chat.V1.Model.MessageCreatedEventData.t)`, *default:* `nil`) - A list of created messages.
+  *   `messages` (*type:* `list(GoogleApi.Chat.V1.Model.MessageCreatedEventData.t)`, *default:* `nil`) - A list of new messages.
   """
 
   use GoogleApi.Gax.ModelBase

clients/chat/lib/google_api/chat/v1/model/message_batch_deleted_event_data.ex

@@ -17,7 +17,7 @@
 
 defmodule GoogleApi.Chat.V1.Model.MessageBatchDeletedEventData do
   @moduledoc """
-  Payload for batch deleted message events where the `EventType` field is `google.workspace.chat.message.v1.batchDeleted`.
+  Event payload for multiple deleted messages. Event type: `google.workspace.chat.message.v1.batchDeleted`
 
   ## Attributes
 

clients/chat/lib/google_api/chat/v1/model/message_batch_updated_event_data.ex

@@ -17,7 +17,7 @@
 
 defmodule GoogleApi.Chat.V1.Model.MessageBatchUpdatedEventData do
   @moduledoc """
-  Payload for batch updated message events where the `EventType` field is `google.workspace.chat.message.v1.batchUpdated`.
+  Event payload for multiple updated messages. Event type: `google.workspace.chat.message.v1.batchUpdated`
 
   ## Attributes
 

clients/chat/lib/google_api/chat/v1/model/message_created_event_data.ex

@@ -17,11 +17,11 @@
 
 defmodule GoogleApi.Chat.V1.Model.MessageCreatedEventData do
   @moduledoc """
-  Payload for new message events where the `EventType` field is `google.workspace.chat.message.v1.created`.
+  Event payload for a new message. Event type: `google.workspace.chat.message.v1.created`
 
   ## Attributes
 
-  *   `message` (*type:* `GoogleApi.Chat.V1.Model.Message.t`, *default:* `nil`) - The most recent version of the message.
+  *   `message` (*type:* `GoogleApi.Chat.V1.Model.Message.t`, *default:* `nil`) - The new message.
   """
 
   use GoogleApi.Gax.ModelBase

clients/chat/lib/google_api/chat/v1/model/message_deleted_event_data.ex

@@ -17,11 +17,11 @@
 
 defmodule GoogleApi.Chat.V1.Model.MessageDeletedEventData do
   @moduledoc """
-  Payload for deleted message events where the `EventType` field is `google.workspace.chat.message.v1.deleted`.
+  Event payload for a deleted message. Event type: `google.workspace.chat.message.v1.deleted`
 
   ## Attributes
 
-  *   `message` (*type:* `GoogleApi.Chat.V1.Model.Message.t`, *default:* `nil`) - The deleted message. Only `name`, `createTime`, `deleteTime`, and `deletionMetadata` are populated.
+  *   `message` (*type:* `GoogleApi.Chat.V1.Model.Message.t`, *default:* `nil`) - The deleted message. Only the `name`, `createTime`, `deleteTime`, and `deletionMetadata` fields are populated.
   """
 
   use GoogleApi.Gax.ModelBase

clients/chat/lib/google_api/chat/v1/model/message_updated_event_data.ex

@@ -17,11 +17,11 @@
 
 defmodule GoogleApi.Chat.V1.Model.MessageUpdatedEventData do
   @moduledoc """
-  Payload for updated message events where the `EventType` field is `google.workspace.chat.message.v1.updated`.
+  Event payload for an updated message. Event type: `google.workspace.chat.message.v1.updated`
 
   ## Attributes
 
-  *   `message` (*type:* `GoogleApi.Chat.V1.Model.Message.t`, *default:* `nil`) - The most recent version of the message.
+  *   `message` (*type:* `GoogleApi.Chat.V1.Model.Message.t`, *default:* `nil`) - The updated message.
   """
 
   use GoogleApi.Gax.ModelBase

clients/chat/lib/google_api/chat/v1/model/reaction_batch_created_event_data.ex

@@ -17,11 +17,11 @@
 
 defmodule GoogleApi.Chat.V1.Model.ReactionBatchCreatedEventData do
   @moduledoc """
-  Payload for batch new reaction events where the `EventType` field is `google.workspace.chat.reaction.v1.batchCreated`.
+  Event payload for multiple new reactions. Event type: `google.workspace.chat.reaction.v1.batchCreated`
 
   ## Attributes
 
-  *   `reactions` (*type:* `list(GoogleApi.Chat.V1.Model.ReactionCreatedEventData.t)`, *default:* `nil`) - A list of created reactions.
+  *   `reactions` (*type:* `list(GoogleApi.Chat.V1.Model.ReactionCreatedEventData.t)`, *default:* `nil`) - A list of new reactions.
   """
 
   use GoogleApi.Gax.ModelBase

clients/chat/lib/google_api/chat/v1/model/reaction_batch_deleted_event_data.ex

@@ -17,7 +17,7 @@
 
 defmodule GoogleApi.Chat.V1.Model.ReactionBatchDeletedEventData do
   @moduledoc """
-  Payload for batch deleted reaction events where the `EventType` field is `google.workspace.chat.reaction.v1.batchDeleted`.
+  Event payload for multiple deleted reactions. Event type: `google.workspace.chat.reaction.v1.batchDeleted`
 
   ## Attributes
 

clients/chat/lib/google_api/chat/v1/model/reaction_created_event_data.ex

@@ -17,11 +17,11 @@
 
 defmodule GoogleApi.Chat.V1.Model.ReactionCreatedEventData do
   @moduledoc """
-  Payload for new reaction events where the `EventType` field is `google.workspace.chat.reaction.v1.created`.
+  Event payload for a new reaction. Event type: `google.workspace.chat.reaction.v1.created`
 
   ## Attributes
 
-  *   `reaction` (*type:* `GoogleApi.Chat.V1.Model.Reaction.t`, *default:* `nil`) - The created reaction.
+  *   `reaction` (*type:* `GoogleApi.Chat.V1.Model.Reaction.t`, *default:* `nil`) - The new reaction.
   """
 
   use GoogleApi.Gax.ModelBase

clients/chat/lib/google_api/chat/v1/model/reaction_deleted_event_data.ex

@@ -17,7 +17,7 @@
 
 defmodule GoogleApi.Chat.V1.Model.ReactionDeletedEventData do
   @moduledoc """
-  Payload for deleted reaction events where the `EventType` field is `google.workspace.chat.reaction.v1.deleted`.
+  Event payload for a deleted reaction. Type: `google.workspace.chat.reaction.v1.deleted`
 
   ## Attributes
 

clients/chat/lib/google_api/chat/v1/model/space_batch_updated_event_data.ex

@@ -17,7 +17,7 @@
 
 defmodule GoogleApi.Chat.V1.Model.SpaceBatchUpdatedEventData do
   @moduledoc """
-  Payload for batch updated space events where the `EventType` field is `google.workspace.chat.space.v1.batchUpdated`.
+  Event payload for multiple updates to a space. Event type: `google.workspace.chat.space.v1.batchUpdated`
 
   ## Attributes