google-apps-chat-v1 0.6.0 → 0.8.0

data/proto_docs/google/chat/v1/message.rb

@@ -24,7 +24,7 @@ module Google
         # A message in a Google Chat space.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Resource name of the message.
+        #     Identifier. Resource name of the message.
         #
         #     Format: `spaces/{space}/messages/{message}`
         #
@@ -66,10 +66,10 @@ module Google
         #     Google Chat. If the message is never deleted, this field is empty.
         # @!attribute [rw] text
         #   @return [::String]
-        #     Plain-text body of the message. The first link to an image, video, or web
-        #     page generates a
-        #     [preview chip](https://developers.google.com/workspace/chat/preview-links).
-        #     You can also [@mention a Google Chat
+        #     Optional. Plain-text body of the message. The first link to an image,
+        #     video, or web page generates a [preview
+        #     chip](https://developers.google.com/workspace/chat/preview-links). You can
+        #     also [@mention a Google Chat
         #     user](https://developers.google.com/workspace/chat/format-messages#messages-@mention),
         #     or everyone in the space.
         #
@@ -111,7 +111,7 @@ module Google
         #     `cards_v2` can have a maximum size of 32 KB.
         # @!attribute [rw] cards_v2
         #   @return [::Array<::Google::Apps::Chat::V1::CardWithId>]
-        #     An array of
+        #     Optional. An array of
         #     [cards](https://developers.google.com/workspace/chat/api/reference/rest/v1/cards).
         #
         #     Only Chat apps can create cards. If your Chat app [authenticates as a
@@ -130,17 +130,17 @@ module Google
         #     The thread the message belongs to. For example usage, see
         #     [Start or reply to a message
         #     thread](https://developers.google.com/workspace/chat/create-messages#create-message-thread).
-        # @!attribute [rw] space
+        # @!attribute [r] space
         #   @return [::Google::Apps::Chat::V1::Space]
-        #     If your Chat app [authenticates as a
+        #     Output only. If your Chat app [authenticates as a
         #     user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
-        #     the output populates the
+        #     the output only populates the
         #     [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces)
         #     `name`.
         # @!attribute [rw] fallback_text
         #   @return [::String]
-        #     A plain-text description of the message's cards, used when the actual cards
-        #     can't be displayed—for example, mobile notifications.
+        #     Optional. A plain-text description of the message's cards, used when the
+        #     actual cards can't be displayed—for example, mobile notifications.
         # @!attribute [rw] action_response
         #   @return [::Google::Apps::Chat::V1::ActionResponse]
         #     Input only. Parameters that a Chat app can use to configure how its
@@ -154,7 +154,7 @@ module Google
         #     Output only. Slash command information, if applicable.
         # @!attribute [rw] attachment
         #   @return [::Array<::Google::Apps::Chat::V1::Attachment>]
-        #     User-uploaded attachment.
+        #     Optional. User-uploaded attachment.
         # @!attribute [r] matched_url
         #   @return [::Google::Apps::Chat::V1::MatchedUrl]
         #     Output only. A URL in `spaces.messages.text` that matches a link preview
@@ -181,10 +181,10 @@ module Google
         #     Output only. The list of emoji reaction summaries on the message.
         # @!attribute [rw] private_message_viewer
         #   @return [::Google::Apps::Chat::V1::User]
-        #     Immutable. Input for creating a message, otherwise output only. The user
-        #     that can view the message. When set, the message is private and only
-        #     visible to the specified user and the Chat app. To include this field in
-        #     your request, you must call the Chat API using [app
+        #     Optional. Immutable. Input for creating a message, otherwise output only.
+        #     The user that can view the message. When set, the message is private and
+        #     only visible to the specified user and the Chat app. To include this field
+        #     in your request, you must call the Chat API using [app
         #     authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
         #     and omit the following:
         #
@@ -207,10 +207,10 @@ module Google
         #     Output only. GIF images that are attached to the message.
         # @!attribute [rw] accessory_widgets
         #   @return [::Array<::Google::Apps::Chat::V1::AccessoryWidget>]
-        #     One or more interactive widgets that appear at the bottom of a message.
-        #     You can add accessory widgets to messages that contain text, cards, or both
-        #     text and cards. Not supported for messages that contain dialogs. For
-        #     details, see [Add interactive widgets at the bottom of a
+        #     Optional. One or more interactive widgets that appear at the bottom of a
+        #     message. You can add accessory widgets to messages that contain text,
+        #     cards, or both text and cards. Not supported for messages that contain
+        #     dialogs. For details, see [Add interactive widgets at the bottom of a
         #     message](https://developers.google.com/workspace/chat/create-messages#add-accessory-widgets).
         #
         #     Creating a message with accessory widgets requires [app
@@ -254,7 +254,7 @@ module Google
         # field to determine what happens if no matching thread is found.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Resource name of the thread.
+        #     Identifier. Resource name of the thread.
         #
         #     Example: `spaces/{space}/threads/{thread}`
         # @!attribute [rw] thread_key
@@ -301,8 +301,8 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # The response of the updated widget.
-          # Used to provide autocomplete options for a widget.
+          # For `selectionInput` widgets, returns autocomplete suggestions for a
+          # multiselect menu.
           # @!attribute [rw] suggestions
           #   @return [::Google::Apps::Chat::V1::ActionResponse::SelectionItems]
           #     List of widget autocomplete results
@@ -384,8 +384,8 @@ module Google
         #     (https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
         # @!attribute [rw] force
         #   @return [::Boolean]
-        #     When `true`, deleting a message also deletes its threaded replies. When
-        #     `false`, if a message has threaded replies, deletion fails.
+        #     Optional. When `true`, deleting a message also deletes its threaded
+        #     replies. When `false`, if a message has threaded replies, deletion fails.
         #
         #     Only applies when [authenticating as a
         #     user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -458,6 +458,12 @@ module Google
         #   @return [::Google::Apps::Chat::V1::CreateMessageRequest::MessageReplyOption]
         #     Optional. Specifies whether a message starts a thread or replies to one.
         #     Only supported in named spaces.
+        #
+        #     When [responding to user
+        #     interactions](https://developers.google.com/workspace/chat/receive-respond-interactions),
+        #     this field is ignored. For interactions within a thread, the reply is
+        #     created in the same thread. Otherwise, the reply is created as a new
+        #     thread.
         # @!attribute [rw] message_id
         #   @return [::String]
         #     Optional. A custom ID for a message. Lets Chat apps get, update, or delete
@@ -510,8 +516,8 @@ module Google
         #     Format: `spaces/{space}`
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     The maximum number of messages returned. The service might return fewer
-        #     messages than this value.
+        #     Optional. The maximum number of messages returned. The service might return
+        #     fewer messages than this value.
         #
         #     If unspecified, at most 25 are returned.
         #
@@ -521,17 +527,15 @@ module Google
         #     Negative values return an `INVALID_ARGUMENT` error.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional, if resuming from a previous query.
-        #
-        #     A page token received from a previous list messages call. Provide this
-        #     parameter to retrieve the subsequent page.
+        #     Optional. A page token received from a previous list messages call. Provide
+        #     this parameter to retrieve the subsequent page.
         #
         #     When paginating, all other parameters provided should match the call that
         #     provided the page token. Passing different values to the other parameters
         #     might lead to unexpected results.
         # @!attribute [rw] filter
         #   @return [::String]
-        #     A query filter.
+        #     Optional. A query filter.
         #
         #     You can filter messages by date (`create_time`) and thread (`thread.name`).
         #
@@ -570,10 +574,8 @@ module Google
         #     error.
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     Optional, if resuming from a previous query.
-        #
-        #     How the list of messages is ordered. Specify a value to order by an
-        #     ordering operation. Valid ordering operation values are as follows:
+        #     Optional. How the list of messages is ordered. Specify a value to order by
+        #     an ordering operation. Valid ordering operation values are as follows:
         #
         #     - `ASC` for ascending.
         #
@@ -582,8 +584,9 @@ module Google
         #     The default ordering is `create_time ASC`.
         # @!attribute [rw] show_deleted
         #   @return [::Boolean]
-        #     Whether to include deleted messages. Deleted messages include deleted time
-        #     and metadata about their deletion, but message content is unavailable.
+        #     Optional. Whether to include deleted messages. Deleted messages include
+        #     deleted time and metadata about their deletion, but message content is
+        #     unavailable.
         class ListMessagesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/chat/v1/reaction.rb

@@ -24,7 +24,7 @@ module Google
         # A reaction to a message.
         # @!attribute [rw] name
         #   @return [::String]
-        #     The resource name of the reaction.
+        #     Identifier. The resource name of the reaction.
         #
         #     Format: `spaces/{space}/messages/{message}/reactions/{reaction}`
         # @!attribute [r] user
@@ -32,7 +32,7 @@ module Google
         #     Output only. The user who created the reaction.
         # @!attribute [rw] emoji
         #   @return [::Google::Apps::Chat::V1::Emoji]
-        #     The emoji used in the reaction.
+        #     Required. The emoji used in the reaction.
         class Reaction
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -41,10 +41,14 @@ module Google
         # An emoji that is used as a reaction to a message.
         # @!attribute [rw] unicode
         #   @return [::String]
-        #     A basic emoji represented by a unicode string.
+        #     Optional. A basic emoji represented by a unicode string.
+        #
+        #     Note: The following fields are mutually exclusive: `unicode`, `custom_emoji`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [r] custom_emoji
         #   @return [::Google::Apps::Chat::V1::CustomEmoji]
         #     Output only. A custom emoji.
+        #
+        #     Note: The following fields are mutually exclusive: `custom_emoji`, `unicode`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class Emoji
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -60,12 +64,12 @@ module Google
         end
 
         # The number of people who reacted to a message with a specific emoji.
-        # @!attribute [rw] emoji
+        # @!attribute [r] emoji
         #   @return [::Google::Apps::Chat::V1::Emoji]
-        #     Emoji associated with the reactions.
-        # @!attribute [rw] reaction_count
+        #     Output only. Emoji associated with the reactions.
+        # @!attribute [r] reaction_count
         #   @return [::Integer]
-        #     The total number of reactions using the associated emoji.
+        #     Output only. The total number of reactions using the associated emoji.
         class EmojiReactionSummary
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/chat/v1/space.rb

@@ -25,7 +25,7 @@ module Google
         # or 1:1 messages between a user and a Chat app.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Resource name of the space.
+        #     Identifier. Resource name of the space.
         #
         #     Format: `spaces/{space}`
         #
@@ -42,8 +42,8 @@ module Google
         #     The type of a space.
         # @!attribute [rw] space_type
         #   @return [::Google::Apps::Chat::V1::Space::SpaceType]
-        #     The type of space. Required when creating a space or updating the space
-        #     type of a space. Output only for other usage.
+        #     Optional. The type of space. Required when creating a space or updating the
+        #     space type of a space. Output only for other usage.
         # @!attribute [rw] single_user_bot_dm
         #   @return [::Boolean]
         #     Optional. Whether the space is a DM between a Chat app and a single
@@ -55,7 +55,7 @@ module Google
         #     Whether messages are threaded in this space.
         # @!attribute [rw] display_name
         #   @return [::String]
-        #     The space's display name. Required when [creating a
+        #     Optional. The space's display name. Required when [creating a
         #     space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create)
         #     with a `spaceType` of `SPACE`. If you receive the error message
         #     `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a
@@ -67,9 +67,9 @@ module Google
         #     Supports up to 128 characters.
         # @!attribute [rw] external_user_allowed
         #   @return [::Boolean]
-        #     Immutable. Whether this space permits any Google Chat user as a member.
-        #     Input when creating a space in a Google Workspace organization. Omit this
-        #     field when creating spaces in the following conditions:
+        #     Optional. Immutable. Whether this space permits any Google Chat user as a
+        #     member. Input when creating a space in a Google Workspace organization.
+        #     Omit this field when creating spaces in the following conditions:
         #
         #       * The authenticated user uses a consumer account (unmanaged user
         #         account). By default, a space created by a consumer account permits any
@@ -81,15 +81,18 @@ module Google
         #     Output only. The threading state in the Chat space.
         # @!attribute [rw] space_details
         #   @return [::Google::Apps::Chat::V1::Space::SpaceDetails]
-        #     Details about the space including description and rules.
+        #     Optional. Details about the space including description and rules.
         # @!attribute [rw] space_history_state
         #   @return [::Google::Apps::Chat::V1::HistoryState]
-        #     The message history state for messages and threads in this space.
+        #     Optional. The message history state for messages and threads in this space.
         # @!attribute [rw] import_mode
         #   @return [::Boolean]
         #     Optional. Whether this space is created in `Import Mode` as part of a data
         #     migration into Google Workspace. While spaces are being imported, they
         #     aren't visible to users until the import is complete.
+        #
+        #     Creating a space in `Import Mode`requires [user
+        #     authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
         # @!attribute [rw] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Optional. Immutable. For spaces created in Chat, the time the space was
@@ -130,11 +133,15 @@ module Google
         #     when creating a space. If the field is not set, a collaboration space is
         #     created. After you create the space, settings are populated in the
         #     `PermissionSettings` field.
+        #
+        #     Note: The following fields are mutually exclusive: `predefined_permission_settings`, `permission_settings`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] permission_settings
         #   @return [::Google::Apps::Chat::V1::Space::PermissionSettings]
         #     Optional. Space permission settings for existing spaces. Input for
         #     updating exact space permission settings, where existing permission
         #     settings are replaced. Output lists current permission settings.
+        #
+        #     Note: The following fields are mutually exclusive: `permission_settings`, `predefined_permission_settings`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [r] import_mode_expire_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. The time when the space will be automatically deleted by the
@@ -166,13 +173,13 @@ module Google
           end
 
           # Represents the count of memberships of a space, grouped into categories.
-          # @!attribute [rw] joined_direct_human_user_count
+          # @!attribute [r] joined_direct_human_user_count
           #   @return [::Integer]
-          #     Count of human users that have directly joined the space, not counting
-          #     users joined by having membership in a joined group.
-          # @!attribute [rw] joined_group_count
+          #     Output only. Count of human users that have directly joined the space,
+          #     not counting users joined by having membership in a joined group.
+          # @!attribute [r] joined_group_count
           #   @return [::Integer]
-          #     Count of all groups that have directly joined the space.
+          #     Output only. Count of all groups that have directly joined the space.
           class MembershipCount
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -198,8 +205,23 @@ module Google
           #     To use the default target audience for the Google Workspace organization,
           #     set to `audiences/default`.
           #
+          #     Reading the target audience supports:
+          #
+          #     - [User
+          #     authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+          #
+          #     - [App
+          #     authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+          #     with [administrator
+          #     approval](https://support.google.com/a?p=chat-app-auth)
+          #     with the `chat.app.spaces` scope in [Developer
+          #     Preview](https://developers.google.com/workspace/preview).
+          #
           #     This field is not populated when using the `chat.bot` scope with [app
           #     authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
+          #
+          #     Setting the target audience requires [user
+          #     authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
           class AccessSettings
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -219,6 +241,9 @@ module Google
               # invited to the space can also discover and access the space. To learn
               # more, see [Make a space discoverable to specific
               # users](https://developers.google.com/workspace/chat/space-target-audience).
+              #
+              # Creating discoverable spaces requires [user
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
               DISCOVERABLE = 2
             end
           end
@@ -230,28 +255,29 @@ module Google
           # `PredefinedPermissionSettings` field in your request.
           # @!attribute [rw] manage_members_and_groups
           #   @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
-          #     Setting for managing members and groups in a space.
+          #     Optional. Setting for managing members and groups in a space.
           # @!attribute [rw] modify_space_details
           #   @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
-          #     Setting for updating space name, avatar, description and guidelines.
+          #     Optional. Setting for updating space name, avatar, description and
+          #     guidelines.
           # @!attribute [rw] toggle_history
           #   @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
-          #     Setting for toggling space history on and off.
+          #     Optional. Setting for toggling space history on and off.
           # @!attribute [rw] use_at_mention_all
           #   @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
-          #     Setting for using @all in a space.
+          #     Optional. Setting for using @all in a space.
           # @!attribute [rw] manage_apps
           #   @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
-          #     Setting for managing apps in a space.
+          #     Optional. Setting for managing apps in a space.
           # @!attribute [rw] manage_webhooks
           #   @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
-          #     Setting for managing webhooks in a space.
+          #     Optional. Setting for managing webhooks in a space.
           # @!attribute [r] post_messages
           #   @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
           #     Output only. Setting for posting messages in a space.
           # @!attribute [rw] reply_messages
           #   @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
-          #     Setting for replying to messages in a space.
+          #     Optional. Setting for replying to messages in a space.
           class PermissionSettings
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -260,10 +286,10 @@ module Google
           # Represents a space permission setting.
           # @!attribute [rw] managers_allowed
           #   @return [::Boolean]
-          #     Whether spaces managers have this permission.
+          #     Optional. Whether spaces managers have this permission.
           # @!attribute [rw] members_allowed
           #   @return [::Boolean]
-          #     Whether non-manager members have this permission.
+          #     Optional. Whether non-manager members have this permission.
           class PermissionSetting
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -341,15 +367,13 @@ module Google
         # @!attribute [rw] space
         #   @return [::Google::Apps::Chat::V1::Space]
         #     Required. The `displayName` and `spaceType` fields must be populated.  Only
-        #     `SpaceType.SPACE` is supported.
+        #     `SpaceType.SPACE`  and `SpaceType.GROUP_CHAT` are supported.
+        #     `SpaceType.GROUP_CHAT` can only be used if `importMode` is set to true.
         #
         #     If you receive the error message `ALREADY_EXISTS`,
         #     try a different `displayName`. An existing space within the Google
         #     Workspace organization might already use this display name.
         #
-        #     If you're a member of the [Developer Preview
-        #     program](https://developers.google.com/workspace/preview),
-        #     `SpaceType.GROUP_CHAT` can be used if `importMode` is set to true.
         #
         #     The space `name` is assigned on the server so anything specified in this
         #     field will be ignored.
@@ -434,7 +458,7 @@ module Google
         #     Format: `spaces/{space}`
         # @!attribute [rw] use_admin_access
         #   @return [::Boolean]
-        #     When `true`, the method runs using the user's Google Workspace
+        #     Optional. When `true`, the method runs using the user's Google Workspace
         #     administrator privileges.
         #
         #     The calling user must be a Google Workspace administrator with the
@@ -540,7 +564,7 @@ module Google
         #     - `permission_settings.replyMessages`
         # @!attribute [rw] use_admin_access
         #   @return [::Boolean]
-        #     When `true`, the method runs using the user's Google Workspace
+        #     Optional. When `true`, the method runs using the user's Google Workspace
         #     administrator privileges.
         #
         #     The calling user must be a Google Workspace administrator with the
@@ -716,7 +740,7 @@ module Google
         #     Format: `spaces/{space}`
         # @!attribute [rw] use_admin_access
         #   @return [::Boolean]
-        #     When `true`, the method runs using the user's Google Workspace
+        #     Optional. When `true`, the method runs using the user's Google Workspace
         #     administrator privileges.
         #
         #     The calling user must be a Google Workspace administrator with the

data/proto_docs/google/chat/v1/space_event.rb

@@ -85,91 +85,127 @@ module Google
         #     Event payload for a new message.
         #
         #     Event type: `google.workspace.chat.message.v1.created`
+        #
+        #     Note: The following fields are mutually exclusive: `message_created_event_data`, `message_updated_event_data`, `message_deleted_event_data`, `message_batch_created_event_data`, `message_batch_updated_event_data`, `message_batch_deleted_event_data`, `space_updated_event_data`, `space_batch_updated_event_data`, `membership_created_event_data`, `membership_updated_event_data`, `membership_deleted_event_data`, `membership_batch_created_event_data`, `membership_batch_updated_event_data`, `membership_batch_deleted_event_data`, `reaction_created_event_data`, `reaction_deleted_event_data`, `reaction_batch_created_event_data`, `reaction_batch_deleted_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] message_updated_event_data
         #   @return [::Google::Apps::Chat::V1::MessageUpdatedEventData]
         #     Event payload for an updated message.
         #
         #     Event type: `google.workspace.chat.message.v1.updated`
+        #
+        #     Note: The following fields are mutually exclusive: `message_updated_event_data`, `message_created_event_data`, `message_deleted_event_data`, `message_batch_created_event_data`, `message_batch_updated_event_data`, `message_batch_deleted_event_data`, `space_updated_event_data`, `space_batch_updated_event_data`, `membership_created_event_data`, `membership_updated_event_data`, `membership_deleted_event_data`, `membership_batch_created_event_data`, `membership_batch_updated_event_data`, `membership_batch_deleted_event_data`, `reaction_created_event_data`, `reaction_deleted_event_data`, `reaction_batch_created_event_data`, `reaction_batch_deleted_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] message_deleted_event_data
         #   @return [::Google::Apps::Chat::V1::MessageDeletedEventData]
         #     Event payload for a deleted message.
         #
         #     Event type: `google.workspace.chat.message.v1.deleted`
+        #
+        #     Note: The following fields are mutually exclusive: `message_deleted_event_data`, `message_created_event_data`, `message_updated_event_data`, `message_batch_created_event_data`, `message_batch_updated_event_data`, `message_batch_deleted_event_data`, `space_updated_event_data`, `space_batch_updated_event_data`, `membership_created_event_data`, `membership_updated_event_data`, `membership_deleted_event_data`, `membership_batch_created_event_data`, `membership_batch_updated_event_data`, `membership_batch_deleted_event_data`, `reaction_created_event_data`, `reaction_deleted_event_data`, `reaction_batch_created_event_data`, `reaction_batch_deleted_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] message_batch_created_event_data
         #   @return [::Google::Apps::Chat::V1::MessageBatchCreatedEventData]
         #     Event payload for multiple new messages.
         #
         #     Event type: `google.workspace.chat.message.v1.batchCreated`
+        #
+        #     Note: The following fields are mutually exclusive: `message_batch_created_event_data`, `message_created_event_data`, `message_updated_event_data`, `message_deleted_event_data`, `message_batch_updated_event_data`, `message_batch_deleted_event_data`, `space_updated_event_data`, `space_batch_updated_event_data`, `membership_created_event_data`, `membership_updated_event_data`, `membership_deleted_event_data`, `membership_batch_created_event_data`, `membership_batch_updated_event_data`, `membership_batch_deleted_event_data`, `reaction_created_event_data`, `reaction_deleted_event_data`, `reaction_batch_created_event_data`, `reaction_batch_deleted_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] message_batch_updated_event_data
         #   @return [::Google::Apps::Chat::V1::MessageBatchUpdatedEventData]
         #     Event payload for multiple updated messages.
         #
         #     Event type: `google.workspace.chat.message.v1.batchUpdated`
+        #
+        #     Note: The following fields are mutually exclusive: `message_batch_updated_event_data`, `message_created_event_data`, `message_updated_event_data`, `message_deleted_event_data`, `message_batch_created_event_data`, `message_batch_deleted_event_data`, `space_updated_event_data`, `space_batch_updated_event_data`, `membership_created_event_data`, `membership_updated_event_data`, `membership_deleted_event_data`, `membership_batch_created_event_data`, `membership_batch_updated_event_data`, `membership_batch_deleted_event_data`, `reaction_created_event_data`, `reaction_deleted_event_data`, `reaction_batch_created_event_data`, `reaction_batch_deleted_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] message_batch_deleted_event_data
         #   @return [::Google::Apps::Chat::V1::MessageBatchDeletedEventData]
         #     Event payload for multiple deleted messages.
         #
         #     Event type: `google.workspace.chat.message.v1.batchDeleted`
+        #
+        #     Note: The following fields are mutually exclusive: `message_batch_deleted_event_data`, `message_created_event_data`, `message_updated_event_data`, `message_deleted_event_data`, `message_batch_created_event_data`, `message_batch_updated_event_data`, `space_updated_event_data`, `space_batch_updated_event_data`, `membership_created_event_data`, `membership_updated_event_data`, `membership_deleted_event_data`, `membership_batch_created_event_data`, `membership_batch_updated_event_data`, `membership_batch_deleted_event_data`, `reaction_created_event_data`, `reaction_deleted_event_data`, `reaction_batch_created_event_data`, `reaction_batch_deleted_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] space_updated_event_data
         #   @return [::Google::Apps::Chat::V1::SpaceUpdatedEventData]
         #     Event payload for a space update.
         #
         #     Event type: `google.workspace.chat.space.v1.updated`
+        #
+        #     Note: The following fields are mutually exclusive: `space_updated_event_data`, `message_created_event_data`, `message_updated_event_data`, `message_deleted_event_data`, `message_batch_created_event_data`, `message_batch_updated_event_data`, `message_batch_deleted_event_data`, `space_batch_updated_event_data`, `membership_created_event_data`, `membership_updated_event_data`, `membership_deleted_event_data`, `membership_batch_created_event_data`, `membership_batch_updated_event_data`, `membership_batch_deleted_event_data`, `reaction_created_event_data`, `reaction_deleted_event_data`, `reaction_batch_created_event_data`, `reaction_batch_deleted_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] space_batch_updated_event_data
         #   @return [::Google::Apps::Chat::V1::SpaceBatchUpdatedEventData]
         #     Event payload for multiple updates to a space.
         #
         #     Event type: `google.workspace.chat.space.v1.batchUpdated`
+        #
+        #     Note: The following fields are mutually exclusive: `space_batch_updated_event_data`, `message_created_event_data`, `message_updated_event_data`, `message_deleted_event_data`, `message_batch_created_event_data`, `message_batch_updated_event_data`, `message_batch_deleted_event_data`, `space_updated_event_data`, `membership_created_event_data`, `membership_updated_event_data`, `membership_deleted_event_data`, `membership_batch_created_event_data`, `membership_batch_updated_event_data`, `membership_batch_deleted_event_data`, `reaction_created_event_data`, `reaction_deleted_event_data`, `reaction_batch_created_event_data`, `reaction_batch_deleted_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] membership_created_event_data
         #   @return [::Google::Apps::Chat::V1::MembershipCreatedEventData]
         #     Event payload for a new membership.
         #
         #     Event type: `google.workspace.chat.membership.v1.created`
+        #
+        #     Note: The following fields are mutually exclusive: `membership_created_event_data`, `message_created_event_data`, `message_updated_event_data`, `message_deleted_event_data`, `message_batch_created_event_data`, `message_batch_updated_event_data`, `message_batch_deleted_event_data`, `space_updated_event_data`, `space_batch_updated_event_data`, `membership_updated_event_data`, `membership_deleted_event_data`, `membership_batch_created_event_data`, `membership_batch_updated_event_data`, `membership_batch_deleted_event_data`, `reaction_created_event_data`, `reaction_deleted_event_data`, `reaction_batch_created_event_data`, `reaction_batch_deleted_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] membership_updated_event_data
         #   @return [::Google::Apps::Chat::V1::MembershipUpdatedEventData]
         #     Event payload for an updated membership.
         #
         #     Event type: `google.workspace.chat.membership.v1.updated`
+        #
+        #     Note: The following fields are mutually exclusive: `membership_updated_event_data`, `message_created_event_data`, `message_updated_event_data`, `message_deleted_event_data`, `message_batch_created_event_data`, `message_batch_updated_event_data`, `message_batch_deleted_event_data`, `space_updated_event_data`, `space_batch_updated_event_data`, `membership_created_event_data`, `membership_deleted_event_data`, `membership_batch_created_event_data`, `membership_batch_updated_event_data`, `membership_batch_deleted_event_data`, `reaction_created_event_data`, `reaction_deleted_event_data`, `reaction_batch_created_event_data`, `reaction_batch_deleted_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] membership_deleted_event_data
         #   @return [::Google::Apps::Chat::V1::MembershipDeletedEventData]
         #     Event payload for a deleted membership.
         #
         #     Event type: `google.workspace.chat.membership.v1.deleted`
+        #
+        #     Note: The following fields are mutually exclusive: `membership_deleted_event_data`, `message_created_event_data`, `message_updated_event_data`, `message_deleted_event_data`, `message_batch_created_event_data`, `message_batch_updated_event_data`, `message_batch_deleted_event_data`, `space_updated_event_data`, `space_batch_updated_event_data`, `membership_created_event_data`, `membership_updated_event_data`, `membership_batch_created_event_data`, `membership_batch_updated_event_data`, `membership_batch_deleted_event_data`, `reaction_created_event_data`, `reaction_deleted_event_data`, `reaction_batch_created_event_data`, `reaction_batch_deleted_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] membership_batch_created_event_data
         #   @return [::Google::Apps::Chat::V1::MembershipBatchCreatedEventData]
         #     Event payload for multiple new memberships.
         #
         #     Event type: `google.workspace.chat.membership.v1.batchCreated`
+        #
+        #     Note: The following fields are mutually exclusive: `membership_batch_created_event_data`, `message_created_event_data`, `message_updated_event_data`, `message_deleted_event_data`, `message_batch_created_event_data`, `message_batch_updated_event_data`, `message_batch_deleted_event_data`, `space_updated_event_data`, `space_batch_updated_event_data`, `membership_created_event_data`, `membership_updated_event_data`, `membership_deleted_event_data`, `membership_batch_updated_event_data`, `membership_batch_deleted_event_data`, `reaction_created_event_data`, `reaction_deleted_event_data`, `reaction_batch_created_event_data`, `reaction_batch_deleted_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] membership_batch_updated_event_data
         #   @return [::Google::Apps::Chat::V1::MembershipBatchUpdatedEventData]
         #     Event payload for multiple updated memberships.
         #
         #     Event type: `google.workspace.chat.membership.v1.batchUpdated`
+        #
+        #     Note: The following fields are mutually exclusive: `membership_batch_updated_event_data`, `message_created_event_data`, `message_updated_event_data`, `message_deleted_event_data`, `message_batch_created_event_data`, `message_batch_updated_event_data`, `message_batch_deleted_event_data`, `space_updated_event_data`, `space_batch_updated_event_data`, `membership_created_event_data`, `membership_updated_event_data`, `membership_deleted_event_data`, `membership_batch_created_event_data`, `membership_batch_deleted_event_data`, `reaction_created_event_data`, `reaction_deleted_event_data`, `reaction_batch_created_event_data`, `reaction_batch_deleted_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] membership_batch_deleted_event_data
         #   @return [::Google::Apps::Chat::V1::MembershipBatchDeletedEventData]
         #     Event payload for multiple deleted memberships.
         #
         #     Event type: `google.workspace.chat.membership.v1.batchDeleted`
+        #
+        #     Note: The following fields are mutually exclusive: `membership_batch_deleted_event_data`, `message_created_event_data`, `message_updated_event_data`, `message_deleted_event_data`, `message_batch_created_event_data`, `message_batch_updated_event_data`, `message_batch_deleted_event_data`, `space_updated_event_data`, `space_batch_updated_event_data`, `membership_created_event_data`, `membership_updated_event_data`, `membership_deleted_event_data`, `membership_batch_created_event_data`, `membership_batch_updated_event_data`, `reaction_created_event_data`, `reaction_deleted_event_data`, `reaction_batch_created_event_data`, `reaction_batch_deleted_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] reaction_created_event_data
         #   @return [::Google::Apps::Chat::V1::ReactionCreatedEventData]
         #     Event payload for a new reaction.
         #
         #     Event type: `google.workspace.chat.reaction.v1.created`
+        #
+        #     Note: The following fields are mutually exclusive: `reaction_created_event_data`, `message_created_event_data`, `message_updated_event_data`, `message_deleted_event_data`, `message_batch_created_event_data`, `message_batch_updated_event_data`, `message_batch_deleted_event_data`, `space_updated_event_data`, `space_batch_updated_event_data`, `membership_created_event_data`, `membership_updated_event_data`, `membership_deleted_event_data`, `membership_batch_created_event_data`, `membership_batch_updated_event_data`, `membership_batch_deleted_event_data`, `reaction_deleted_event_data`, `reaction_batch_created_event_data`, `reaction_batch_deleted_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] reaction_deleted_event_data
         #   @return [::Google::Apps::Chat::V1::ReactionDeletedEventData]
         #     Event payload for a deleted reaction.
         #
         #     Event type: `google.workspace.chat.reaction.v1.deleted`
+        #
+        #     Note: The following fields are mutually exclusive: `reaction_deleted_event_data`, `message_created_event_data`, `message_updated_event_data`, `message_deleted_event_data`, `message_batch_created_event_data`, `message_batch_updated_event_data`, `message_batch_deleted_event_data`, `space_updated_event_data`, `space_batch_updated_event_data`, `membership_created_event_data`, `membership_updated_event_data`, `membership_deleted_event_data`, `membership_batch_created_event_data`, `membership_batch_updated_event_data`, `membership_batch_deleted_event_data`, `reaction_created_event_data`, `reaction_batch_created_event_data`, `reaction_batch_deleted_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] reaction_batch_created_event_data
         #   @return [::Google::Apps::Chat::V1::ReactionBatchCreatedEventData]
         #     Event payload for multiple new reactions.
         #
         #     Event type: `google.workspace.chat.reaction.v1.batchCreated`
+        #
+        #     Note: The following fields are mutually exclusive: `reaction_batch_created_event_data`, `message_created_event_data`, `message_updated_event_data`, `message_deleted_event_data`, `message_batch_created_event_data`, `message_batch_updated_event_data`, `message_batch_deleted_event_data`, `space_updated_event_data`, `space_batch_updated_event_data`, `membership_created_event_data`, `membership_updated_event_data`, `membership_deleted_event_data`, `membership_batch_created_event_data`, `membership_batch_updated_event_data`, `membership_batch_deleted_event_data`, `reaction_created_event_data`, `reaction_deleted_event_data`, `reaction_batch_deleted_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] reaction_batch_deleted_event_data
         #   @return [::Google::Apps::Chat::V1::ReactionBatchDeletedEventData]
         #     Event payload for multiple deleted reactions.
         #
         #     Event type: `google.workspace.chat.reaction.v1.batchDeleted`
+        #
+        #     Note: The following fields are mutually exclusive: `reaction_batch_deleted_event_data`, `message_created_event_data`, `message_updated_event_data`, `message_deleted_event_data`, `message_batch_created_event_data`, `message_batch_updated_event_data`, `message_batch_deleted_event_data`, `space_updated_event_data`, `space_batch_updated_event_data`, `membership_created_event_data`, `membership_updated_event_data`, `membership_deleted_event_data`, `membership_batch_created_event_data`, `membership_batch_updated_event_data`, `membership_batch_deleted_event_data`, `reaction_created_event_data`, `reaction_deleted_event_data`, `reaction_batch_created_event_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class SpaceEvent
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -202,8 +238,8 @@ module Google
         #     Negative values return an `INVALID_ARGUMENT` error.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     A page token, received from a previous list space events call. Provide this
-        #     to retrieve the subsequent page.
+        #     Optional. 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