google-apps-chat-v1 0.13.0 → 0.15.0

data/lib/google/chat/v1/chat_service_services_pb.rb

@@ -37,10 +37,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.
             #
@@ -77,7 +88,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)
             rpc :ListMessages, ::Google::Apps::Chat::V1::ListMessagesRequest, ::Google::Apps::Chat::V1::ListMessagesResponse
             # Lists memberships in a space. For an example, see [List users and Google
             # Chat apps in a
@@ -96,11 +113,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`
             rpc :ListMemberships, ::Google::Apps::Chat::V1::ListMembershipsRequest, ::Google::Apps::Chat::V1::ListMembershipsResponse
             # Returns details about a membership. For an example, see
             # [Get details about a user's or Google Chat app's
@@ -111,11 +140,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`
             rpc :GetMembership, ::Google::Apps::Chat::V1::GetMembershipRequest, ::Google::Apps::Chat::V1::Membership
             # Returns details about a message.
             # For an example, see [Get details about a
@@ -126,9 +165,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.
             rpc :GetMessage, ::Google::Apps::Chat::V1::GetMessageRequest, ::Google::Apps::Chat::V1::Message
@@ -144,9 +188,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.
@@ -160,9 +210,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.
@@ -173,15 +229,26 @@ 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`
             rpc :GetAttachment, ::Google::Apps::Chat::V1::GetAttachmentRequest, ::Google::Apps::Chat::V1::Attachment
             # Uploads an attachment. For an example, see
             # [Upload media as a file
             # 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
@@ -197,9 +264,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)
@@ -210,7 +282,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`.
             rpc :SearchSpaces, ::Google::Apps::Chat::V1::SearchSpacesRequest, ::Google::Apps::Chat::V1::SearchSpacesResponse
             # Returns details about a space. For an example, see
@@ -222,33 +300,72 @@ 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.
             rpc :GetSpace, ::Google::Apps::Chat::V1::GetSpaceRequest, ::Google::Apps::Chat::V1::Space
-            # 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.
             rpc :CreateSpace, ::Google::Apps::Chat::V1::CreateSpaceRequest, ::Google::Apps::Chat::V1::Space
             # Creates a space and adds specified users to it. The calling user is
             # automatically added to the space, and shouldn't be specified as a
@@ -301,7 +418,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`
             rpc :SetUpSpace, ::Google::Apps::Chat::V1::SetUpSpaceRequest, ::Google::Apps::Chat::V1::Space
             # Updates a space. For an example, see
             # [Update a
@@ -317,12 +439,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.
             rpc :UpdateSpace, ::Google::Apps::Chat::V1::UpdateSpaceRequest, ::Google::Apps::Chat::V1::Space
             # Deletes a named space. Always performs a cascading delete, which means
             # that the space's child resources—like messages posted in the space and
@@ -335,21 +471,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)
+            # 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`
             rpc :DeleteSpace, ::Google::Apps::Chat::V1::DeleteSpaceRequest, ::Google::Protobuf::Empty
             # Completes the
             # [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).
             rpc :CompleteImportSpace, ::Google::Apps::Chat::V1::CompleteImportSpaceRequest, ::Google::Apps::Chat::V1::CompleteImportSpaceResponse
@@ -368,14 +518,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`
             rpc :FindDirectMessage, ::Google::Apps::Chat::V1::FindDirectMessageRequest, ::Google::Apps::Chat::V1::Space
             # Creates a membership for the calling Chat app, a user, or a Google Group.
             # Creating memberships for other Chat apps isn't supported.
@@ -390,21 +545,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).
             rpc :CreateMembership, ::Google::Apps::Chat::V1::CreateMembershipRequest, ::Google::Apps::Chat::V1::Membership
@@ -416,13 +585,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`
             rpc :UpdateMembership, ::Google::Apps::Chat::V1::UpdateMembershipRequest, ::Google::Apps::Chat::V1::Membership
             # Deletes a membership. For an example, see
             # [Remove a user or a Google Chat app from a
@@ -434,33 +612,72 @@ 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.
             rpc :DeleteMembership, ::Google::Apps::Chat::V1::DeleteMembershipRequest, ::Google::Apps::Chat::V1::Membership
             # Creates a reaction and adds it to a message. For an example, see
             # [Add a reaction to a
             # 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)
             rpc :CreateReaction, ::Google::Apps::Chat::V1::CreateReactionRequest, ::Google::Apps::Chat::V1::Reaction
             # Lists reactions to a message. For an example, see
             # [List reactions for a
             # 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`
             rpc :ListReactions, ::Google::Apps::Chat::V1::ListReactionsRequest, ::Google::Apps::Chat::V1::ListReactionsResponse
             # Deletes a reaction to a message. For an example, see
             # [Delete a
             # 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)
             rpc :DeleteReaction, ::Google::Apps::Chat::V1::DeleteReactionRequest, ::Google::Protobuf::Empty
             # Creates a custom emoji.
             #
@@ -472,7 +689,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`
             rpc :CreateCustomEmoji, ::Google::Apps::Chat::V1::CreateCustomEmojiRequest, ::Google::Apps::Chat::V1::CustomEmoji
             # Returns details about a custom emoji.
             #
@@ -484,7 +705,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`
             rpc :GetCustomEmoji, ::Google::Apps::Chat::V1::GetCustomEmojiRequest, ::Google::Apps::Chat::V1::CustomEmoji
             # Lists custom emojis visible to the authenticated user.
             #
@@ -496,7 +722,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`
             rpc :ListCustomEmojis, ::Google::Apps::Chat::V1::ListCustomEmojisRequest, ::Google::Apps::Chat::V1::ListCustomEmojisResponse
             # Deletes a custom emoji. By default, users can only delete custom emoji they
             # created. [Emoji managers](https://support.google.com/a/answer/12850085)
@@ -512,7 +743,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`
             rpc :DeleteCustomEmoji, ::Google::Apps::Chat::V1::DeleteCustomEmojiRequest, ::Google::Protobuf::Empty
             # Returns details about a user's read state within a space, used to identify
             # read and unread messages. For an example, see [Get details about a user's
@@ -520,14 +755,23 @@ 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`
             rpc :GetSpaceReadState, ::Google::Apps::Chat::V1::GetSpaceReadStateRequest, ::Google::Apps::Chat::V1::SpaceReadState
             # Updates a user's read state within a space, used to identify read and
             # unread messages. For an example, see [Update a user's space read
             # 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`
             rpc :UpdateSpaceReadState, ::Google::Apps::Chat::V1::UpdateSpaceReadStateRequest, ::Google::Apps::Chat::V1::SpaceReadState
             # Returns details about a user's read state within a thread, used to identify
             # read and unread messages. For an example, see [Get details about a user's
@@ -535,7 +779,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`
             rpc :GetThreadReadState, ::Google::Apps::Chat::V1::GetThreadReadStateRequest, ::Google::Apps::Chat::V1::ThreadReadState
             # Returns an event from a Google Chat space. The [event
             # payload](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.oneof_payload)
@@ -548,7 +797,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
@@ -564,7 +826,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
@@ -575,14 +850,22 @@ 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`
             rpc :GetSpaceNotificationSetting, ::Google::Apps::Chat::V1::GetSpaceNotificationSettingRequest, ::Google::Apps::Chat::V1::SpaceNotificationSetting
             # Updates the space notification setting. For an example, see [Update
             # the caller's space notification
             # 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`
             rpc :UpdateSpaceNotificationSetting, ::Google::Apps::Chat::V1::UpdateSpaceNotificationSettingRequest, ::Google::Apps::Chat::V1::SpaceNotificationSetting
           end