@google-apps/chat 0.17.0 → 0.18.0

package/build/protos/google/chat/v1/chat_service.proto

@@ -49,6 +49,10 @@ service ChatService {
       "https://www.googleapis.com/auth/chat.admin.memberships.readonly,"
       "https://www.googleapis.com/auth/chat.admin.spaces,"
       "https://www.googleapis.com/auth/chat.admin.spaces.readonly,"
+      "https://www.googleapis.com/auth/chat.app.delete,"
+      "https://www.googleapis.com/auth/chat.app.memberships,"
+      "https://www.googleapis.com/auth/chat.app.spaces,"
+      "https://www.googleapis.com/auth/chat.app.spaces.create,"
       "https://www.googleapis.com/auth/chat.bot,"
       "https://www.googleapis.com/auth/chat.customemojis,"
       "https://www.googleapis.com/auth/chat.customemojis.readonly,"
@@ -73,10 +77,21 @@ service ChatService {
   // 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.
   //
@@ -120,7 +135,13 @@ service ChatService {
   // 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(ListMessagesRequest) returns (ListMessagesResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=spaces/*}/messages"
@@ -145,11 +166,23 @@ service ChatService {
   //
   // - [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(ListMembershipsRequest)
       returns (ListMembershipsResponse) {
     option (google.api.http) = {
@@ -167,11 +200,21 @@ service ChatService {
   //
   // - [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(GetMembershipRequest) returns (Membership) {
     option (google.api.http) = {
       get: "/v1/{name=spaces/*/members/*}"
@@ -188,9 +231,14 @@ service ChatService {
   //
   // - [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(GetMessageRequest) returns (Message) {
@@ -212,9 +260,15 @@ service ChatService {
   //
   // - [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.
@@ -239,9 +293,15 @@ service ChatService {
   //
   // - [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.
@@ -258,8 +318,13 @@ service ChatService {
   // 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(GetAttachmentRequest) returns (Attachment) {
     option (google.api.http) = {
       get: "/v1/{name=spaces/*/messages/*/attachments/*}"
@@ -272,7 +337,13 @@ service ChatService {
   // 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
@@ -295,9 +366,14 @@ service ChatService {
   //
   // - [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)
@@ -314,7 +390,13 @@ service ChatService {
   //
   // 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(SearchSpacesRequest) returns (SearchSpacesResponse) {
     option (google.api.http) = {
@@ -332,11 +414,29 @@ service ChatService {
   //
   // - [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(GetSpaceRequest) returns (Space) {
     option (google.api.http) = {
       get: "/v1/{name=spaces/*}"
@@ -344,27 +444,48 @@ service ChatService {
     option (google.api.method_signature) = "name";
   }
 
-  // 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(CreateSpaceRequest) returns (Space) {
     option (google.api.http) = {
       post: "/v1/spaces"
@@ -424,7 +545,12 @@ service ChatService {
   // 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(SetUpSpaceRequest) returns (Space) {
     option (google.api.http) = {
       post: "/v1/spaces:setup"
@@ -446,12 +572,26 @@ service ChatService {
   // - [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(UpdateSpaceRequest) returns (Space) {
     option (google.api.http) = {
       patch: "/v1/{space.name=spaces/*}"
@@ -471,13 +611,22 @@ service ChatService {
   //
   // - [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(DeleteSpaceRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1/{name=spaces/*}"
@@ -489,9 +638,14 @@ service ChatService {
   // [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(CompleteImportSpaceRequest)
@@ -517,14 +671,19 @@ service ChatService {
   // 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(FindDirectMessageRequest) returns (Space) {
     option (google.api.http) = {
       get: "/v1/spaces:findDirectMessage"
@@ -544,21 +703,35 @@ service ChatService {
   // - [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(CreateMembershipRequest) returns (Membership) {
@@ -577,13 +750,22 @@ service ChatService {
   //
   // - [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(UpdateMembershipRequest) returns (Membership) {
     option (google.api.http) = {
       patch: "/v1/{membership.name=spaces/*/members/*}"
@@ -602,12 +784,31 @@ service ChatService {
   // - [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(DeleteMembershipRequest) returns (Membership) {
     option (google.api.http) = {
       delete: "/v1/{name=spaces/*/members/*}"
@@ -620,7 +821,14 @@ service ChatService {
   // 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(CreateReactionRequest) returns (Reaction) {
     option (google.api.http) = {
       post: "/v1/{parent=spaces/*/messages/*}/reactions"
@@ -634,7 +842,14 @@ service ChatService {
   // 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(ListReactionsRequest) returns (ListReactionsResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=spaces/*/messages/*}/reactions"
@@ -647,7 +862,13 @@ service ChatService {
   // 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(DeleteReactionRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1/{name=spaces/*/messages/*/reactions/*}"
@@ -665,7 +886,11 @@ service ChatService {
   // 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(CreateCustomEmojiRequest) returns (CustomEmoji) {
     option (google.api.http) = {
       post: "/v1/customEmojis"
@@ -684,7 +909,12 @@ service ChatService {
   // 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(GetCustomEmojiRequest) returns (CustomEmoji) {
     option (google.api.http) = {
       get: "/v1/{name=customEmojis/*}"
@@ -702,7 +932,12 @@ service ChatService {
   // 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(ListCustomEmojisRequest)
       returns (ListCustomEmojisResponse) {
     option (google.api.http) = {
@@ -725,7 +960,11 @@ service ChatService {
   // 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(DeleteCustomEmojiRequest)
       returns (google.protobuf.Empty) {
     option (google.api.http) = {
@@ -740,7 +979,12 @@ service ChatService {
   // 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(GetSpaceReadStateRequest) returns (SpaceReadState) {
     option (google.api.http) = {
       get: "/v1/{name=users/*/spaces/*/spaceReadState}"
@@ -753,7 +997,11 @@ service ChatService {
   // 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(UpdateSpaceReadStateRequest)
       returns (SpaceReadState) {
     option (google.api.http) = {
@@ -769,7 +1017,12 @@ service ChatService {
   // 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(GetThreadReadStateRequest) returns (ThreadReadState) {
     option (google.api.http) = {
       get: "/v1/{name=users/*/spaces/*/threads/*/threadReadState}"
@@ -788,7 +1041,20 @@ service ChatService {
   // 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
@@ -810,7 +1076,20 @@ service ChatService {
   // `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
@@ -828,7 +1107,11 @@ service ChatService {
   // 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(GetSpaceNotificationSettingRequest)
       returns (SpaceNotificationSetting) {
     option (google.api.http) = {
@@ -842,7 +1125,11 @@ service ChatService {
   // 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(UpdateSpaceNotificationSettingRequest)
       returns (SpaceNotificationSetting) {
     option (google.api.http) = {