google-apps-chat-v1 0.6.0 → 0.8.0

data/proto_docs/google/api/field_info.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Api
+    # Rich semantic information of an API field beyond basic typing.
+    # @!attribute [rw] format
+    #   @return [::Google::Api::FieldInfo::Format]
+    #     The standard format of a field value. This does not explicitly configure
+    #     any API consumer, just documents the API's format for the field it is
+    #     applied to.
+    # @!attribute [rw] referenced_types
+    #   @return [::Array<::Google::Api::TypeReference>]
+    #     The type(s) that the annotated, generic field may represent.
+    #
+    #     Currently, this must only be used on fields of type `google.protobuf.Any`.
+    #     Supporting other generic types may be considered in the future.
+    class FieldInfo
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # The standard format of a field value. The supported formats are all backed
+      # by either an RFC defined by the IETF or a Google-defined AIP.
+      module Format
+        # Default, unspecified value.
+        FORMAT_UNSPECIFIED = 0
+
+        # Universally Unique Identifier, version 4, value as defined by
+        # https://datatracker.ietf.org/doc/html/rfc4122. The value may be
+        # normalized to entirely lowercase letters. For example, the value
+        # `F47AC10B-58CC-0372-8567-0E02B2C3D479` would be normalized to
+        # `f47ac10b-58cc-0372-8567-0e02b2c3d479`.
+        UUID4 = 1
+
+        # Internet Protocol v4 value as defined by [RFC
+        # 791](https://datatracker.ietf.org/doc/html/rfc791). The value may be
+        # condensed, with leading zeros in each octet stripped. For example,
+        # `001.022.233.040` would be condensed to `1.22.233.40`.
+        IPV4 = 2
+
+        # Internet Protocol v6 value as defined by [RFC
+        # 2460](https://datatracker.ietf.org/doc/html/rfc2460). The value may be
+        # normalized to entirely lowercase letters with zeros compressed, following
+        # [RFC 5952](https://datatracker.ietf.org/doc/html/rfc5952). For example,
+        # the value `2001:0DB8:0::0` would be normalized to `2001:db8::`.
+        IPV6 = 3
+
+        # An IP address in either v4 or v6 format as described by the individual
+        # values defined herein. See the comments on the IPV4 and IPV6 types for
+        # allowed normalizations of each.
+        IPV4_OR_IPV6 = 4
+      end
+    end
+
+    # A reference to a message type, for use in {::Google::Api::FieldInfo FieldInfo}.
+    # @!attribute [rw] type_name
+    #   @return [::String]
+    #     The name of the type that the annotated, generic field may represent.
+    #     If the type is in the same protobuf package, the value can be the simple
+    #     message name e.g., `"MyMessage"`. Otherwise, the value must be the
+    #     fully-qualified message name e.g., `"google.library.v1.Book"`.
+    #
+    #     If the type(s) are unknown to the service (e.g. the field accepts generic
+    #     user input), use the wildcard `"*"` to denote this behavior.
+    #
+    #     See [AIP-202](https://google.aip.dev/202#type-references) for more details.
+    class TypeReference
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

data/proto_docs/google/apps/card/v1/card.rb

@@ -393,6 +393,8 @@ module Google
         #       "text": "  <b>bold text</b>"
         #     }
         #     ```
+        #
+        #     Note: The following fields are mutually exclusive: `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] image
         #   @return [::Google::Apps::Card::V1::Image]
         #     Displays an image.
@@ -405,6 +407,8 @@ module Google
         #       "altText": "Chat app avatar"
         #     }
         #     ```
+        #
+        #     Note: The following fields are mutually exclusive: `image`, `text_paragraph`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] decorated_text
         #   @return [::Google::Apps::Card::V1::DecoratedText]
         #     Displays a decorated text item.
@@ -427,6 +431,8 @@ module Google
         #       }
         #     }
         #     ```
+        #
+        #     Note: The following fields are mutually exclusive: `decorated_text`, `text_paragraph`, `image`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] button_list
         #   @return [::Google::Apps::Card::V1::ButtonList]
         #     A list of buttons.
@@ -461,6 +467,8 @@ module Google
         #       ]
         #     }
         #     ```
+        #
+        #     Note: The following fields are mutually exclusive: `button_list`, `text_paragraph`, `image`, `decorated_text`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] text_input
         #   @return [::Google::Apps::Card::V1::TextInput]
         #     Displays a text box that users can type into.
@@ -499,6 +507,8 @@ module Google
         #       }
         #     }
         #     ```
+        #
+        #     Note: The following fields are mutually exclusive: `text_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] selection_input
         #   @return [::Google::Apps::Card::V1::SelectionInput]
         #     Displays a selection control that lets users select items. Selection
@@ -536,6 +546,8 @@ module Google
         #       ]
         #     }
         #     ```
+        #
+        #     Note: The following fields are mutually exclusive: `selection_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `date_time_picker`, `divider`, `grid`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] date_time_picker
         #   @return [::Google::Apps::Card::V1::DateTimePicker]
         #     Displays a widget that lets users input a date, time, or date and time.
@@ -552,6 +564,8 @@ module Google
         #       "valueMsEpoch": "796435200000"
         #     }
         #     ```
+        #
+        #     Note: The following fields are mutually exclusive: `date_time_picker`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `divider`, `grid`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] divider
         #   @return [::Google::Apps::Card::V1::Divider]
         #     Displays a horizontal line divider between widgets.
@@ -561,6 +575,8 @@ module Google
         #     "divider": {
         #     }
         #     ```
+        #
+        #     Note: The following fields are mutually exclusive: `divider`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `grid`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] grid
         #   @return [::Google::Apps::Card::V1::Grid]
         #     Displays a grid with a collection of items.
@@ -606,6 +622,8 @@ module Google
         #       }
         #     }
         #     ```
+        #
+        #     Note: The following fields are mutually exclusive: `grid`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `columns`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] columns
         #   @return [::Google::Apps::Card::V1::Columns]
         #     Displays up to 2 columns.
@@ -645,6 +663,8 @@ module Google
         #       ]
         #     }
         #     ```
+        #
+        #     Note: The following fields are mutually exclusive: `columns`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] horizontal_alignment
         #   @return [::Google::Apps::Card::V1::Widget::HorizontalAlignment]
         #     Specifies whether widgets align to the left, right, or center of a column.
@@ -799,10 +819,14 @@ module Google
         # @!attribute [rw] button
         #   @return [::Google::Apps::Card::V1::Button]
         #     A button that a user can click to trigger an action.
+        #
+        #     Note: The following fields are mutually exclusive: `button`, `switch_control`, `end_icon`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] switch_control
         #   @return [::Google::Apps::Card::V1::DecoratedText::SwitchControl]
         #     A switch widget that a user can click to change its state and trigger an
         #     action.
+        #
+        #     Note: The following fields are mutually exclusive: `switch_control`, `button`, `end_icon`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] end_icon
         #   @return [::Google::Apps::Card::V1::Icon]
         #     An icon displayed after the text.
@@ -812,6 +836,8 @@ module Google
         #     and
         #     [custom](https://developers.google.com/workspace/chat/format-messages#customicons)
         #     icons.
+        #
+        #     Note: The following fields are mutually exclusive: `end_icon`, `button`, `switch_control`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class DecoratedText
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1098,9 +1124,13 @@ module Google
         # @!attribute [rw] external_data_source
         #   @return [::Google::Apps::Card::V1::Action]
         #     An external data source, such as a relational data base.
+        #
+        #     Note: The following fields are mutually exclusive: `external_data_source`, `platform_data_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] platform_data_source
         #   @return [::Google::Apps::Card::V1::SelectionInput::PlatformDataSource]
         #     A data source from Google Workspace.
+        #
+        #     Note: The following fields are mutually exclusive: `platform_data_source`, `external_data_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class SelectionInput
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1380,6 +1410,8 @@ module Google
         #
         #     For a full list of supported icons, see [built-in
         #     icons](https://developers.google.com/workspace/chat/format-messages#builtinicons).
+        #
+        #     Note: The following fields are mutually exclusive: `known_icon`, `icon_url`, `material_icon`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] icon_url
         #   @return [::String]
         #     Display a custom icon hosted at an HTTPS URL.
@@ -1392,6 +1424,8 @@ module Google
         #     ```
         #
         #     Supported file types include `.png` and `.jpg`.
+        #
+        #     Note: The following fields are mutually exclusive: `icon_url`, `known_icon`, `material_icon`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] material_icon
         #   @return [::Google::Apps::Card::V1::MaterialIcon]
         #     Display one of the [Google Material
@@ -1407,6 +1441,8 @@ module Google
         #     ```
         #
         #     [Google Chat apps](https://developers.google.com/workspace/chat):
+        #
+        #     Note: The following fields are mutually exclusive: `material_icon`, `known_icon`, `icon_url`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] alt_text
         #   @return [::String]
         #     Optional. A description of the icon used for accessibility.
@@ -1776,24 +1812,38 @@ module Google
             # @!attribute [rw] text_paragraph
             #   @return [::Google::Apps::Card::V1::TextParagraph]
             #     {::Google::Apps::Card::V1::TextParagraph TextParagraph} widget.
+            #
+            #     Note: The following fields are mutually exclusive: `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] image
             #   @return [::Google::Apps::Card::V1::Image]
             #     {::Google::Apps::Card::V1::Image Image} widget.
+            #
+            #     Note: The following fields are mutually exclusive: `image`, `text_paragraph`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] decorated_text
             #   @return [::Google::Apps::Card::V1::DecoratedText]
             #     {::Google::Apps::Card::V1::DecoratedText DecoratedText} widget.
+            #
+            #     Note: The following fields are mutually exclusive: `decorated_text`, `text_paragraph`, `image`, `button_list`, `text_input`, `selection_input`, `date_time_picker`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] button_list
             #   @return [::Google::Apps::Card::V1::ButtonList]
             #     {::Google::Apps::Card::V1::ButtonList ButtonList} widget.
+            #
+            #     Note: The following fields are mutually exclusive: `button_list`, `text_paragraph`, `image`, `decorated_text`, `text_input`, `selection_input`, `date_time_picker`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] text_input
             #   @return [::Google::Apps::Card::V1::TextInput]
             #     {::Google::Apps::Card::V1::TextInput TextInput} widget.
+            #
+            #     Note: The following fields are mutually exclusive: `text_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `selection_input`, `date_time_picker`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] selection_input
             #   @return [::Google::Apps::Card::V1::SelectionInput]
             #     {::Google::Apps::Card::V1::SelectionInput SelectionInput} widget.
+            #
+            #     Note: The following fields are mutually exclusive: `selection_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `date_time_picker`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] date_time_picker
             #   @return [::Google::Apps::Card::V1::DateTimePicker]
             #     {::Google::Apps::Card::V1::DateTimePicker DateTimePicker} widget.
+            #
+            #     Note: The following fields are mutually exclusive: `date_time_picker`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             class Widgets
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1852,9 +1902,13 @@ module Google
         # @!attribute [rw] action
         #   @return [::Google::Apps::Card::V1::Action]
         #     If specified, an action is triggered by this `onClick`.
+        #
+        #     Note: The following fields are mutually exclusive: `action`, `open_link`, `open_dynamic_link_action`, `card`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] open_link
         #   @return [::Google::Apps::Card::V1::OpenLink]
         #     If specified, this `onClick` triggers an open link action.
+        #
+        #     Note: The following fields are mutually exclusive: `open_link`, `action`, `open_dynamic_link_action`, `card`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] open_dynamic_link_action
         #   @return [::Google::Apps::Card::V1::Action]
         #     An add-on triggers this action when the action needs to open a
@@ -1864,12 +1918,16 @@ module Google
         #
         #     [Google Workspace
         #     Add-ons](https://developers.google.com/workspace/add-ons):
+        #
+        #     Note: The following fields are mutually exclusive: `open_dynamic_link_action`, `action`, `open_link`, `card`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] card
         #   @return [::Google::Apps::Card::V1::Card]
         #     A new card is pushed to the card stack after clicking if specified.
         #
         #     [Google Workspace
         #     Add-ons](https://developers.google.com/workspace/add-ons):
+        #
+        #     Note: The following fields are mutually exclusive: `card`, `action`, `open_link`, `open_dynamic_link_action`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class OnClick
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -62,12 +62,18 @@ module Google
         # @!attribute [rw] user_mention
         #   @return [::Google::Apps::Chat::V1::UserMentionMetadata]
         #     The metadata of user mention.
+        #
+        #     Note: The following fields are mutually exclusive: `user_mention`, `slash_command`, `rich_link_metadata`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] slash_command
         #   @return [::Google::Apps::Chat::V1::SlashCommandMetadata]
         #     The metadata for a slash command.
+        #
+        #     Note: The following fields are mutually exclusive: `slash_command`, `user_mention`, `rich_link_metadata`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] rich_link_metadata
         #   @return [::Google::Apps::Chat::V1::RichLinkMetadata]
         #     The metadata for a rich link.
+        #
+        #     Note: The following fields are mutually exclusive: `rich_link_metadata`, `user_mention`, `slash_command`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class Annotation
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -138,9 +144,13 @@ module Google
         # @!attribute [rw] drive_link_data
         #   @return [::Google::Apps::Chat::V1::DriveLinkData]
         #     Data for a drive link.
+        #
+        #     Note: The following fields are mutually exclusive: `drive_link_data`, `chat_space_link_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] chat_space_link_data
         #   @return [::Google::Apps::Chat::V1::ChatSpaceLinkData]
         #     Data for a chat space link.
+        #
+        #     Note: The following fields are mutually exclusive: `chat_space_link_data`, `drive_link_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class RichLinkMetadata
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -24,7 +24,7 @@ module Google
         # An attachment in Google Chat.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Resource name of the attachment, in the form
+        #     Optional. Resource name of the attachment, in the form
         #     `spaces/{space}/messages/{message}/attachments/{attachment}`.
         # @!attribute [r] content_name
         #   @return [::String]
@@ -34,12 +34,17 @@ module Google
         #     Output only. The content type (MIME type) of the file.
         # @!attribute [rw] attachment_data_ref
         #   @return [::Google::Apps::Chat::V1::AttachmentDataRef]
-        #     A reference to the attachment data. This field is used with the media API
-        #     to download the attachment data.
+        #     Optional. A reference to the attachment data. This field is used to
+        #     create or update messages with attachments, or with the media API to
+        #     download the attachment data.
+        #
+        #     Note: The following fields are mutually exclusive: `attachment_data_ref`, `drive_data_ref`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [r] drive_data_ref
         #   @return [::Google::Apps::Chat::V1::DriveDataRef]
         #     Output only. A reference to the Google Drive attachment. This field is
         #     used with the Google Drive API.
+        #
+        #     Note: The following fields are mutually exclusive: `drive_data_ref`, `attachment_data_ref`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [r] thumbnail_uri
         #   @return [::String]
         #     Output only. The thumbnail URL which should be used to preview the
@@ -82,13 +87,13 @@ module Google
         # A reference to the attachment data.
         # @!attribute [rw] resource_name
         #   @return [::String]
-        #     The resource name of the attachment data. This field is used with the media
-        #     API to download the attachment data.
+        #     Optional. The resource name of the attachment data. This field is used with
+        #     the media API to download the attachment data.
         # @!attribute [rw] attachment_upload_token
         #   @return [::String]
-        #     Opaque token containing a reference to an uploaded attachment. Treated by
-        #     clients as an opaque string and used to create or update Chat messages with
-        #     attachments.
+        #     Optional. Opaque token containing a reference to an uploaded attachment.
+        #     Treated by clients as an opaque string and used to create or update Chat
+        #     messages with attachments.
         class AttachmentDataRef
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -30,7 +30,8 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
-          # Who deleted the message and how it was deleted.
+          # Who deleted the message and how it was deleted. More values may be added in
+          # the future.
           module DeletionType
             # This value is unused.
             DELETION_TYPE_UNSPECIFIED = 0

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

@@ -25,7 +25,7 @@ module Google
         # Chat app is invited to, part of, or absent from a space.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Resource name of the membership, assigned by the server.
+        #     Identifier. Resource name of the membership, assigned by the server.
         #
         #     Format: `spaces/{space}/members/{member}`
         # @!attribute [r] state
@@ -39,15 +39,22 @@ module Google
         #     This field can only be used as input in `UpdateMembership`.
         # @!attribute [rw] member
         #   @return [::Google::Apps::Chat::V1::User]
-        #     The Google Chat user or app the membership corresponds to.
+        #     Optional. The Google Chat user or app the membership corresponds to.
         #     If your Chat app [authenticates as a
         #     user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
         #     the output populates the
         #     [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User)
         #     `name` and `type`.
+        #
+        #     Note: The following fields are mutually exclusive: `member`, `group_member`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] group_member
         #   @return [::Google::Apps::Chat::V1::Group]
-        #     The Google Group the membership corresponds to.
+        #     Optional. The Google Group the membership corresponds to.
+        #
+        #     Reading or mutating memberships for Google Groups requires [user
+        #     authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+        #
+        #     Note: The following fields are mutually exclusive: `group_member`, `member`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Optional. Immutable. The creation time of the membership, such as when a
@@ -111,24 +118,45 @@ module Google
         # @!attribute [rw] membership
         #   @return [::Google::Apps::Chat::V1::Membership]
         #     Required. The membership relation to create.
+        #
         #     The `memberType` field must contain a user with the `user.name` and
         #     `user.type` fields populated. The server will assign a resource name
         #     and overwrite anything specified.
+        #
         #     When a Chat app creates a membership relation for a human user, it must use
-        #     the `chat.memberships` scope, set `user.type` to `HUMAN`, and set
-        #     `user.name` with format `users/{user}`, where `{user}` can be the email
-        #     address for the user. For users in the same Workspace organization `{user}`
-        #     can also be the `id` of the
-        #     [person](https://developers.google.com/people/api/rest/v1/people) from the
-        #     People API, or the `id` for the user in the Directory API. For example, if
-        #     the People API Person profile ID for `user@example.com` is `123456789`, you
-        #     can add the user to the space by setting the `membership.member.name` to
-        #     `users/user@example.com` or `users/123456789`. When a Chat app creates a
-        #     membership relation for itself, it must use the `chat.memberships.app`
-        #     scope, set `user.type` to `BOT`, and set `user.name` to `users/app`.
+        #     certain authorization scopes and set specific values for certain fields:
+        #
+        #     - When [authenticating as a
+        #     user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
+        #     the `chat.memberships` authorization scope is required.
+        #
+        #     - When [authenticating as an
+        #     app](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app),
+        #     the `chat.app.memberships` authorization scope is required.
+        #     Authenticating as an app is available in [Developer
+        #     Preview](https://developers.google.com/workspace/preview).
+        #
+        #     - Set `user.type` to `HUMAN`, and set `user.name` with format
+        #     `users/{user}`, where `{user}` can be the email address for the user. For
+        #     users in the same Workspace organization `{user}` can also be the `id` of
+        #     the [person](https://developers.google.com/people/api/rest/v1/people) from
+        #     the People API, or the `id` for the user in the Directory API. For example,
+        #     if the People API Person profile ID for `user@example.com` is `123456789`,
+        #     you can add the user to the space by setting the `membership.member.name`
+        #     to `users/user@example.com` or `users/123456789`.
+        #
+        #     Inviting users external to the Workspace organization that owns the space
+        #     requires [user
+        #     authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+        #
+        #     When a Chat app creates a membership relation for itself, it must
+        #     [authenticate as a
+        #     user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+        #     and use the `chat.memberships.app` scope, set `user.type` to `BOT`, and set
+        #     `user.name` to `users/app`.
         # @!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
@@ -161,7 +189,7 @@ module Google
         #     - `role`
         # @!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
@@ -261,7 +289,7 @@ module Google
         #     authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
         # @!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
@@ -302,14 +330,12 @@ module Google
         #
         #     Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`
         #
-        #     When [authenticated as a
-        #     user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
-        #     you can use the user's email as an alias for `{member}`. For example,
+        #     You can use the user's email as an alias for `{member}`. For example,
         #     `spaces/{space}/members/example@gmail.com` where `example@gmail.com` is the
         #     email of the Google Chat user.
         # @!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
@@ -345,7 +371,7 @@ module Google
         #     Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`.
         # @!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