google-apps-chat-v1 0.12.0 → 0.14.0

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

@@ -356,10 +356,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.
               #
@@ -513,7 +524,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
@@ -684,11 +701,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
@@ -869,11 +898,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
@@ -983,9 +1022,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.
               #
@@ -1084,9 +1128,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.
@@ -1199,9 +1249,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.
@@ -1303,8 +1359,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
@@ -1388,7 +1449,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
@@ -1483,9 +1550,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)
@@ -1612,7 +1684,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)
@@ -1827,11 +1905,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
@@ -1921,28 +2017,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.
@@ -2087,7 +2204,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
@@ -2139,7 +2261,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
@@ -2238,12 +2360,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
@@ -2409,13 +2545,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
@@ -2509,9 +2654,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).
               #
@@ -2608,14 +2758,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
@@ -2718,21 +2873,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).
               #
@@ -2773,8 +2942,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
@@ -2875,13 +3042,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
@@ -2987,12 +3163,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
@@ -3014,9 +3209,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.
               #
@@ -3100,7 +3299,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
@@ -3187,7 +3393,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
@@ -3334,7 +3547,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
@@ -3424,7 +3643,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
@@ -3512,7 +3735,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
@@ -3606,7 +3834,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
@@ -3730,7 +3963,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
@@ -3820,7 +4057,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
@@ -3917,7 +4159,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
@@ -4029,7 +4275,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
@@ -4133,7 +4384,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
@@ -4227,7 +4491,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
@@ -4389,7 +4666,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
@@ -4477,7 +4758,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