google-apps-chat-v1 0.13.0 → 0.14.0

data/lib/google/apps/chat/v1/chat_service/client.rb

@@ -363,10 +363,21 @@ module Google
             # Creates a message in a Google Chat space. For an example, see [Send a
             # message](https://developers.google.com/workspace/chat/create-messages).
             #
-            # The `create()` method requires either [user
+            # Supports the following types of
+            # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
+            #
+            # - [App
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+            # with the authorization scope:
+            #     - `https://www.googleapis.com/auth/chat.bot`
+            # - [User
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-            # or [app
-            # authentication](https://developers.google.com/workspace/chat/authorize-import).
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.messages.create`
+            #     - `https://www.googleapis.com/auth/chat.messages`
+            #     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+            #     only)
+            #
             # Chat attributes the message sender differently depending on the type of
             # authentication that you use in your request.
             #
@@ -527,7 +538,13 @@ module Google
             # messages](https://developers.google.com/workspace/chat/api/guides/v1/messages/list).
             #
             # Requires [user
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with one of the following [authorization
+            # scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.messages.readonly`
+            #   - `https://www.googleapis.com/auth/chat.messages`
+            #   - `https://www.googleapis.com/auth/chat.import` (import mode spaces only)
             #
             # @overload list_messages(request, options = nil)
             #   Pass arguments to `list_messages` via a request object, either of type
@@ -705,11 +722,23 @@ module Google
             #
             # - [App
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.bot`
+            #     - `https://www.googleapis.com/auth/chat.app.memberships` (requires
+            #     [administrator approval](https://support.google.com/a?p=chat-app-auth))
             #
             # - [User
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-            # You can authenticate and authorize this method with administrator
-            # privileges by setting the `use_admin_access` field in the request.
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.memberships.readonly`
+            #     - `https://www.googleapis.com/auth/chat.memberships`
+            #     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+            #     only)
+            #     - User authentication grants administrator privileges when an
+            #     administrator account authenticates, `use_admin_access` is `true`, and
+            #     one of the following authorization scopes is used:
+            #         - `https://www.googleapis.com/auth/chat.admin.memberships.readonly`
+            #         - `https://www.googleapis.com/auth/chat.admin.memberships`
             #
             # @overload list_memberships(request, options = nil)
             #   Pass arguments to `list_memberships` via a request object, either of type
@@ -897,11 +926,21 @@ module Google
             #
             # - [App
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.bot`
+            #     - `https://www.googleapis.com/auth/chat.app.memberships` (requires
+            #     [administrator approval](https://support.google.com/a?p=chat-app-auth))
             #
             # - [User
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-            # You can authenticate and authorize this method with administrator
-            # privileges by setting the `use_admin_access` field in the request.
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.memberships.readonly`
+            #     - `https://www.googleapis.com/auth/chat.memberships`
+            #     - User authentication grants administrator privileges when an
+            #     administrator account authenticates, `use_admin_access` is `true`, and
+            #     one of the following authorization scopes is used:
+            #         - `https://www.googleapis.com/auth/chat.admin.memberships.readonly`
+            #         - `https://www.googleapis.com/auth/chat.admin.memberships`
             #
             # @overload get_membership(request, options = nil)
             #   Pass arguments to `get_membership` via a request object, either of type
@@ -1018,9 +1057,14 @@ module Google
             #
             # - [App
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+            # with the authorization scope:
+            #     - `https://www.googleapis.com/auth/chat.bot`
             #
             # - [User
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.messages.readonly`
+            #     - `https://www.googleapis.com/auth/chat.messages`
             #
             # Note: Might return a message from a blocked member or space.
             #
@@ -1126,9 +1170,15 @@ module Google
             #
             # - [App
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+            # with the authorization scope:
+            #     - `https://www.googleapis.com/auth/chat.bot`
             #
             # - [User
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.messages`
+            #     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+            #     only)
             #
             # When using app authentication, requests can only update messages
             # created by the calling Chat app.
@@ -1248,9 +1298,15 @@ module Google
             #
             # - [App
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+            # with the authorization scope:
+            #     - `https://www.googleapis.com/auth/chat.bot`
             #
             # - [User
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.messages`
+            #     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+            #     only)
             #
             # When using app authentication, requests can only delete messages
             # created by the calling Chat app.
@@ -1359,8 +1415,13 @@ module Google
             # For an example, see
             # [Get metadata about a message
             # attachment](https://developers.google.com/workspace/chat/get-media-attachments).
+            #
             # Requires [app
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+            # with the [authorization
+            # scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.bot`
             #
             # @overload get_attachment(request, options = nil)
             #   Pass arguments to `get_attachment` via a request object, either of type
@@ -1451,7 +1512,13 @@ module Google
             # attachment](https://developers.google.com/workspace/chat/upload-media-attachments).
             #
             # Requires user
-            # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+            # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with one of the following [authorization
+            # scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.messages.create`
+            #   - `https://www.googleapis.com/auth/chat.messages`
+            #   - `https://www.googleapis.com/auth/chat.import` (import mode spaces only)
             #
             # You can upload attachments up to 200 MB. Certain file types aren't
             # supported. For details, see [File types blocked by Google
@@ -1553,9 +1620,14 @@ module Google
             #
             # - [App
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+            # with the authorization scope:
+            #     - `https://www.googleapis.com/auth/chat.bot`
             #
             # - [User
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.spaces.readonly`
+            #     - `https://www.googleapis.com/auth/chat.spaces`
             #
             # To list all named spaces by Google Workspace organization, use the
             # [`spaces.search()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/search)
@@ -1681,7 +1753,13 @@ module Google
             #
             # Requires [user
             # authentication with administrator
-            # privileges](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user#admin-privileges).
+            # privileges](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user#admin-privileges)
+            # and one of the following [authorization
+            # scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.admin.spaces.readonly`
+            #   - `https://www.googleapis.com/auth/chat.admin.spaces`
+            #
             # In the request, set `use_admin_access` to `true`.
             #
             # @overload search_spaces(request, options = nil)
@@ -1895,11 +1973,29 @@ module Google
             #
             # - [App
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.bot`
+            #     - `https://www.googleapis.com/auth/chat.app.spaces` with [administrator
+            #     approval](https://support.google.com/a?p=chat-app-auth)
             #
             # - [User
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-            # You can authenticate and authorize this method with administrator
-            # privileges by setting the `use_admin_access` field in the request.
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.spaces.readonly`
+            #     - `https://www.googleapis.com/auth/chat.spaces`
+            #     - User authentication grants administrator privileges when an
+            #     administrator account authenticates, `use_admin_access` is `true`, and
+            #     one of the following authorization scopes is used:
+            #         - `https://www.googleapis.com/auth/chat.admin.spaces.readonly`
+            #         - `https://www.googleapis.com/auth/chat.admin.spaces`
+            #
+            # App authentication has the following limitations:
+            #
+            # - `space.access_settings` is only populated when using the
+            # `chat.app.spaces` scope.
+            # - `space.predefind_permission_settings` and `space.permission_settings` are
+            # only populated when using the `chat.app.spaces` scope, and only for
+            # spaces the app created.
             #
             # @overload get_space(request, options = nil)
             #   Pass arguments to `get_space` via a request object, either of type
@@ -1996,28 +2092,49 @@ module Google
             end
 
             ##
-            # Creates a space with no members. Can be used to create a named space, or a
+            # Creates a space. Can be used to create a named space, or a
             # group chat in `Import mode`. For an example, see [Create a
             # space](https://developers.google.com/workspace/chat/create-spaces).
             #
-            #  If you receive the error message `ALREADY_EXISTS` when creating
-            #  a space, try a different `displayName`. An existing space within
-            #  the Google Workspace organization might already use this display name.
-            #
             # Supports the following types of
             # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
             #
             # - [App
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
             # with [administrator approval](https://support.google.com/a?p=chat-app-auth)
-            # in [Developer Preview](https://developers.google.com/workspace/preview)
+            # and one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.app.spaces.create`
+            #     - `https://www.googleapis.com/auth/chat.app.spaces`
             #
             # - [User
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.spaces.create`
+            #     - `https://www.googleapis.com/auth/chat.spaces`
+            #     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+            #     only)
             #
             # When authenticating as an app, the `space.customer` field must be set in
             # the request.
             #
+            # When authenticating as an app, the Chat app is added as a member of the
+            # space. However, unlike human authentication, the Chat app is not added as a
+            # space manager. By default, the Chat app can be removed from the space by
+            # all space members. To allow only space managers to remove the app from a
+            # space, set `space.permission_settings.manage_apps` to `managers_allowed`.
+            #
+            # Space membership upon creation depends on whether the space is created in
+            # `Import mode`:
+            #
+            # * **Import mode:** No members are created.
+            # * **All other modes:**  The calling user is added as a member. This is:
+            #     * The app itself when using app authentication.
+            #     * The human user when using user authentication.
+            #
+            #  If you receive the error message `ALREADY_EXISTS` when creating
+            #  a space, try a different `displayName`. An existing space within
+            #  the Google Workspace organization might already use this display name.
+            #
             # @overload create_space(request, options = nil)
             #   Pass arguments to `create_space` via a request object, either of type
             #   {::Google::Apps::Chat::V1::CreateSpaceRequest} or an equivalent Hash.
@@ -2161,7 +2278,12 @@ module Google
             # might already use this display name.
             #
             # Requires [user
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with one of the following [authorization
+            # scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.spaces.create`
+            #   - `https://www.googleapis.com/auth/chat.spaces`
             #
             # @overload set_up_space(request, options = nil)
             #   Pass arguments to `set_up_space` via a request object, either of type
@@ -2213,7 +2335,7 @@ module Google
             #     Optional. The Google Chat users or groups to invite to join the space. Omit
             #     the calling user, as they are added automatically.
             #
-            #     The set currently allows up to 20 memberships (in addition to the caller).
+            #     The set currently allows up to 49 memberships (in addition to the caller).
             #
             #     For human membership, the `Membership.member` field must contain a `user`
             #     with `name` populated (format: `users/{user}`) and `type` set to
@@ -2311,12 +2433,26 @@ module Google
             # - [App
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
             # with [administrator approval](https://support.google.com/a?p=chat-app-auth)
-            # in [Developer Preview](https://developers.google.com/workspace/preview)
+            # and one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.app.spaces`
             #
             # - [User
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-            # You can authenticate and authorize this method with administrator
-            # privileges by setting the `use_admin_access` field in the request.
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.spaces`
+            #     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+            #     only)
+            #     - User authentication grants administrator privileges when an
+            #     administrator account authenticates, `use_admin_access` is `true`, and
+            #     the following authorization scopes is used:
+            #         - `https://www.googleapis.com/auth/chat.admin.spaces`
+            #
+            # App authentication has the following limitations:
+            #
+            # - To update either `space.predefined_permission_settings` or
+            # `space.permission_settings`, the app must be the space creator.
+            # - Updating the `space.access_settings.audience` is not supported for app
+            # authentication.
             #
             # @overload update_space(request, options = nil)
             #   Pass arguments to `update_space` via a request object, either of type
@@ -2489,13 +2625,22 @@ module Google
             #
             # - [App
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
-            # with [administrator approval](https://support.google.com/a?p=chat-app-auth)
-            # in [Developer Preview](https://developers.google.com/workspace/preview)
+            # with [administrator
+            # approval](https://support.google.com/a?p=chat-app-auth) and the
+            # authorization scope:
+            #     - `https://www.googleapis.com/auth/chat.app.delete` (only in
+            #     spaces the app created)
             #
             # - [User
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-            # You can authenticate and authorize this method with administrator
-            # privileges by setting the `use_admin_access` field in the request.
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.delete`
+            #     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+            #     only)
+            #     - User authentication grants administrator privileges when an
+            #     administrator account authenticates, `use_admin_access` is `true`, and
+            #     the following authorization scope is used:
+            #         - `https://www.googleapis.com/auth/chat.admin.delete`
             #
             # @overload delete_space(request, options = nil)
             #   Pass arguments to `delete_space` via a request object, either of type
@@ -2596,9 +2741,14 @@ module Google
             # [import process](https://developers.google.com/workspace/chat/import-data)
             # for the specified space and makes it visible to users.
             #
-            # Requires [app
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
-            # and domain-wide delegation. For more information, see [Authorize Google
+            # Requires [user
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # and domain-wide delegation with the [authorization
+            # scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.import`
+            #
+            # For more information, see [Authorize Google
             # Chat apps to import
             # data](https://developers.google.com/workspace/chat/authorize-import).
             #
@@ -2702,14 +2852,19 @@ module Google
             # returns the direct message space between the specified user and the
             # authenticated user.
             #
-            # // Supports the following types of
+            # Supports the following types of
             # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
             #
             # - [App
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+            # with the authorization scope:
+            #     - `https://www.googleapis.com/auth/chat.bot`
             #
             # - [User
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.spaces.readonly`
+            #     - `https://www.googleapis.com/auth/chat.spaces`
             #
             # @overload find_direct_message(request, options = nil)
             #   Pass arguments to `find_direct_message` via a request object, either of type
@@ -2811,21 +2966,35 @@ module Google
             # - [App
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
             # with [administrator approval](https://support.google.com/a?p=chat-app-auth)
-            # in [Developer Preview](https://developers.google.com/workspace/preview)
+            # and the authorization scope:
+            #     - `https://www.googleapis.com/auth/chat.app.memberships`
             #
             # - [User
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-            # You can authenticate and authorize this method with administrator
-            # privileges by setting the `use_admin_access` field in the request.
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.memberships`
+            #     - `https://www.googleapis.com/auth/chat.memberships.app` (to add the
+            #     calling app to the space)
+            #     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+            #     only)
+            #     - User authentication grants administrator privileges when an
+            #     administrator account authenticates, `use_admin_access` is `true`, and
+            #     the following authorization scope is used:
+            #         - `https://www.googleapis.com/auth/chat.admin.memberships`
+            #
+            # App authentication is not supported for the following use cases:
+            #
+            # - Inviting users external to the Workspace organization that owns the
+            # space.
+            # - Adding a Google Group to a space.
+            # - Adding a Chat app to a space.
             #
             # For example usage, see:
             #
             # - [Invite or add a user to a
             # space](https://developers.google.com/workspace/chat/create-members#create-user-membership).
-            #
             # - [Invite or add a Google Group to a
             # space](https://developers.google.com/workspace/chat/create-members#create-group-membership).
-            #
             # - [Add the Chat app to a
             # space](https://developers.google.com/workspace/chat/create-members#create-membership-calling-api).
             #
@@ -2866,8 +3035,6 @@ module Google
             #     - 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
@@ -2975,13 +3142,22 @@ module Google
             #
             # - [App
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
-            # with [administrator approval](https://support.google.com/a?p=chat-app-auth)
-            # in [Developer Preview](https://developers.google.com/workspace/preview)
+            # with [administrator
+            # approval](https://support.google.com/a?p=chat-app-auth) and the
+            # authorization scope:
+            #     - `https://www.googleapis.com/auth/chat.app.memberships` (only in
+            #     spaces the app created)
             #
             # - [User
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-            # You can authenticate and authorize this method with administrator
-            # privileges by setting the `use_admin_access` field in the request.
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.memberships`
+            #     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+            #     only)
+            #     - User authentication grants administrator privileges when an
+            #     administrator account authenticates, `use_admin_access` is `true`, and
+            #     the following authorization scope is used:
+            #         - `https://www.googleapis.com/auth/chat.admin.memberships`
             #
             # @overload update_membership(request, options = nil)
             #   Pass arguments to `update_membership` via a request object, either of type
@@ -3094,12 +3270,31 @@ module Google
             # - [App
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
             # with [administrator approval](https://support.google.com/a?p=chat-app-auth)
-            # in [Developer Preview](https://developers.google.com/workspace/preview)
+            # and the authorization scope:
+            #     - `https://www.googleapis.com/auth/chat.app.memberships`
             #
             # - [User
             # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-            # You can authenticate and authorize this method with administrator
-            # privileges by setting the `use_admin_access` field in the request.
+            # with one of the following authorization scopes:
+            #     - `https://www.googleapis.com/auth/chat.memberships`
+            #     - `https://www.googleapis.com/auth/chat.memberships.app` (to remove
+            #     the calling app from the space)
+            #     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+            #     only)
+            #     - User authentication grants administrator privileges when an
+            #     administrator account authenticates, `use_admin_access` is `true`, and
+            #     the following authorization scope is used:
+            #         - `https://www.googleapis.com/auth/chat.admin.memberships`
+            #
+            # App authentication is not supported for the following use cases:
+            #
+            # - Removing a Google Group from a space.
+            # - Removing a Chat app from a space.
+            #
+            # To delete memberships for space managers, the requester
+            # must be a space manager. If you're using [app
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+            # the Chat app must be the space creator.
             #
             # @overload delete_membership(request, options = nil)
             #   Pass arguments to `delete_membership` via a request object, either of type
@@ -3121,9 +3316,13 @@ module Google
             #     human users' or their own memberships. Chat apps can't delete other apps'
             #     memberships.
             #
-            #     When deleting a human membership, requires the `chat.memberships` scope and
-            #     `spaces/{space}/members/{member}` format. You can use the email as an
-            #     alias for `{member}`. For example,
+            #     When deleting a human membership, requires the `chat.memberships` scope
+            #     with [user
+            #     authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            #     or the `chat.memberships.app` scope with [app
+            #     authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+            #     and the `spaces/{space}/members/{member}` format.
+            #     You can use the 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.
             #
@@ -3214,7 +3413,14 @@ module Google
             # message](https://developers.google.com/workspace/chat/create-reactions).
             #
             # Requires [user
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with one of the following [authorization
+            # scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.messages.reactions.create`
+            #   - `https://www.googleapis.com/auth/chat.messages.reactions`
+            #   - `https://www.googleapis.com/auth/chat.messages`
+            #   - `https://www.googleapis.com/auth/chat.import` (import mode spaces only)
             #
             # @overload create_reaction(request, options = nil)
             #   Pass arguments to `create_reaction` via a request object, either of type
@@ -3308,7 +3514,14 @@ module Google
             # message](https://developers.google.com/workspace/chat/list-reactions).
             #
             # Requires [user
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with one of the following [authorization
+            # scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.messages.reactions.readonly`
+            #   - `https://www.googleapis.com/auth/chat.messages.reactions`
+            #   - `https://www.googleapis.com/auth/chat.messages.readonly`
+            #   - `https://www.googleapis.com/auth/chat.messages`
             #
             # @overload list_reactions(request, options = nil)
             #   Pass arguments to `list_reactions` via a request object, either of type
@@ -3462,7 +3675,13 @@ module Google
             # reaction](https://developers.google.com/workspace/chat/delete-reactions).
             #
             # Requires [user
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with one of the following [authorization
+            # scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.messages.reactions`
+            #   - `https://www.googleapis.com/auth/chat.messages`
+            #   - `https://www.googleapis.com/auth/chat.import` (import mode spaces only)
             #
             # @overload delete_reaction(request, options = nil)
             #   Pass arguments to `delete_reaction` via a request object, either of type
@@ -3559,7 +3778,11 @@ module Google
             # permissions](https://support.google.com/a/answer/12850085).
             #
             # Requires [user
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with the [authorization
+            # scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.customemojis`
             #
             # @overload create_custom_emoji(request, options = nil)
             #   Pass arguments to `create_custom_emoji` via a request object, either of type
@@ -3646,7 +3869,12 @@ module Google
             # permissions](https://support.google.com/a/answer/12850085).
             #
             # Requires [user
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with one of the following [authorization
+            # scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.customemojis.readonly`
+            #   - `https://www.googleapis.com/auth/chat.customemojis`
             #
             # @overload get_custom_emoji(request, options = nil)
             #   Pass arguments to `get_custom_emoji` via a request object, either of type
@@ -3747,7 +3975,12 @@ module Google
             # permissions](https://support.google.com/a/answer/12850085).
             #
             # Requires [user
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with one of the following [authorization
+            # scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.customemojis.readonly`
+            #   - `https://www.googleapis.com/auth/chat.customemojis`
             #
             # @overload list_custom_emojis(request, options = nil)
             #   Pass arguments to `list_custom_emojis` via a request object, either of type
@@ -3870,7 +4103,11 @@ module Google
             # permissions](https://support.google.com/a/answer/12850085).
             #
             # Requires [user
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with the [authorization
+            # scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.customemojis`
             #
             # @overload delete_custom_emoji(request, options = nil)
             #   Pass arguments to `delete_custom_emoji` via a request object, either of type
@@ -3967,7 +4204,12 @@ module Google
             # state](https://developers.google.com/workspace/chat/get-space-read-state).
             #
             # Requires [user
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with one of the following [authorization
+            # scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.users.readstate.readonly`
+            #   - `https://www.googleapis.com/auth/chat.users.readstate`
             #
             # @overload get_space_read_state(request, options = nil)
             #   Pass arguments to `get_space_read_state` via a request object, either of type
@@ -4071,7 +4313,11 @@ module Google
             # state](https://developers.google.com/workspace/chat/update-space-read-state).
             #
             # Requires [user
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with the [authorization
+            # scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.users.readstate`
             #
             # @overload update_space_read_state(request, options = nil)
             #   Pass arguments to `update_space_read_state` via a request object, either of type
@@ -4190,7 +4436,12 @@ module Google
             # state](https://developers.google.com/workspace/chat/get-thread-read-state).
             #
             # Requires [user
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with one of the following [authorization
+            # scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.users.readstate.readonly`
+            #   - `https://www.googleapis.com/auth/chat.users.readstate`
             #
             # @overload get_thread_read_state(request, options = nil)
             #   Pass arguments to `get_thread_read_state` via a request object, either of type
@@ -4301,7 +4552,20 @@ module Google
             # object of the Space event data for this request.
             #
             # Requires [user
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with an [authorization
+            # scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes)
+            # appropriate for reading the requested data:
+            #
+            #   - `https://www.googleapis.com/auth/chat.spaces.readonly`
+            #   - `https://www.googleapis.com/auth/chat.spaces`
+            #   - `https://www.googleapis.com/auth/chat.messages.readonly`
+            #   - `https://www.googleapis.com/auth/chat.messages`
+            #   - `https://www.googleapis.com/auth/chat.messages.reactions.readonly`
+            #   - `https://www.googleapis.com/auth/chat.messages.reactions`
+            #   - `https://www.googleapis.com/auth/chat.memberships.readonly`
+            #   - `https://www.googleapis.com/auth/chat.memberships`
+            #
             # To get an event, the authenticated user must be a member of the space.
             #
             # For an example, see [Get details about an
@@ -4402,7 +4666,20 @@ module Google
             # `Membership` resource.
             #
             # Requires [user
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with an [authorization
+            # scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes)
+            # appropriate for reading the requested data:
+            #
+            #   - `https://www.googleapis.com/auth/chat.spaces.readonly`
+            #   - `https://www.googleapis.com/auth/chat.spaces`
+            #   - `https://www.googleapis.com/auth/chat.messages.readonly`
+            #   - `https://www.googleapis.com/auth/chat.messages`
+            #   - `https://www.googleapis.com/auth/chat.messages.reactions.readonly`
+            #   - `https://www.googleapis.com/auth/chat.messages.reactions`
+            #   - `https://www.googleapis.com/auth/chat.memberships.readonly`
+            #   - `https://www.googleapis.com/auth/chat.memberships`
+            #
             # To list events, the authenticated user must be a member of the space.
             #
             # For an example, see [List events from a Google Chat
@@ -4571,7 +4848,11 @@ module Google
             # setting](https://developers.google.com/workspace/chat/get-space-notification-setting).
             #
             # Requires [user
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with the [authorization
+            # scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.users.spacesettings`
             #
             # @overload get_space_notification_setting(request, options = nil)
             #   Pass arguments to `get_space_notification_setting` via a request object, either of type
@@ -4666,7 +4947,11 @@ module Google
             # setting](https://developers.google.com/workspace/chat/update-space-notification-setting).
             #
             # Requires [user
-            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+            # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+            # with the [authorization
+            # scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+            #
+            #   - `https://www.googleapis.com/auth/chat.users.spacesettings`
             #
             # @overload update_space_notification_setting(request, options = nil)
             #   Pass arguments to `update_space_notification_setting` via a request object, either of type