@google-apps/chat 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.7.0](https://github.com/googleapis/google-cloud-node/compare/chat-v0.6.0...chat-v0.7.0) (2024-07-22)
+
+
+### Features
+
+* [chat] add GetSpaceEvent and ListSpaceEvents APIs ([#5546](https://github.com/googleapis/google-cloud-node/issues/5546)) ([40e0811](https://github.com/googleapis/google-cloud-node/commit/40e0811598fbf2c92eee5875b2ab2c3e2be18064))
+
+## [0.6.0](https://github.com/googleapis/google-cloud-node/compare/chat-v0.5.0...chat-v0.6.0) (2024-07-10)
+
+
+### Features
+
+* [chat] Add doc for Discoverable Space support for GA launch ([#5525](https://github.com/googleapis/google-cloud-node/issues/5525)) ([9a80089](https://github.com/googleapis/google-cloud-node/commit/9a80089d974280420e269f24aba563f4adceb4c3))
+
 ## [0.5.0](https://github.com/googleapis/google-cloud-node/compare/chat-v0.4.0...chat-v0.5.0) (2024-05-21)
 
 

package/README.md

@@ -140,11 +140,13 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 | Chat_service.get_membership | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_membership.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.get_membership.js,packages/google-chat/samples/README.md) |
 | Chat_service.get_message | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_message.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.get_message.js,packages/google-chat/samples/README.md) |
 | Chat_service.get_space | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_space.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.get_space.js,packages/google-chat/samples/README.md) |
+| Chat_service.get_space_event | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_space_event.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.get_space_event.js,packages/google-chat/samples/README.md) |
 | Chat_service.get_space_read_state | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_space_read_state.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.get_space_read_state.js,packages/google-chat/samples/README.md) |
 | Chat_service.get_thread_read_state | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_thread_read_state.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.get_thread_read_state.js,packages/google-chat/samples/README.md) |
 | Chat_service.list_memberships | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.list_memberships.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.list_memberships.js,packages/google-chat/samples/README.md) |
 | Chat_service.list_messages | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.list_messages.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.list_messages.js,packages/google-chat/samples/README.md) |
 | Chat_service.list_reactions | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.list_reactions.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.list_reactions.js,packages/google-chat/samples/README.md) |
+| Chat_service.list_space_events | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.list_space_events.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.list_space_events.js,packages/google-chat/samples/README.md) |
 | Chat_service.list_spaces | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.list_spaces.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.list_spaces.js,packages/google-chat/samples/README.md) |
 | Chat_service.set_up_space | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.set_up_space.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.set_up_space.js,packages/google-chat/samples/README.md) |
 | Chat_service.update_membership | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.update_membership.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.update_membership.js,packages/google-chat/samples/README.md) |

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

@@ -48,7 +48,7 @@ message Attachment {
   }
 
   // Resource name of the attachment, in the form
-  // `spaces/*/messages/*/attachments/*`.
+  // `spaces/{space}/messages/{message}/attachments/{attachment}`.
   string name = 1;
 
   // Output only. The original file name for the content, not the full path.
@@ -103,7 +103,7 @@ message AttachmentDataRef {
 // Request to get an attachment.
 message GetAttachmentRequest {
   // Required. Resource name of the attachment, in the form
-  // `spaces/*/messages/*/attachments/*`.
+  // `spaces/{space}/messages/{message}/attachments/{attachment}`.
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = { type: "chat.googleapis.com/Attachment" }

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

@@ -23,6 +23,7 @@ import "google/chat/v1/membership.proto";
 import "google/chat/v1/message.proto";
 import "google/chat/v1/reaction.proto";
 import "google/chat/v1/space.proto";
+import "google/chat/v1/space_event.proto";
 import "google/chat/v1/space_read_state.proto";
 import "google/chat/v1/space_setup.proto";
 import "google/chat/v1/thread_read_state.proto";
@@ -42,6 +43,11 @@ option ruby_package = "Google::Apps::Chat::V1";
 service ChatService {
   option (google.api.default_host) = "chat.googleapis.com";
   option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/chat.admin.delete,"
+      "https://www.googleapis.com/auth/chat.admin.memberships,"
+      "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.bot,"
       "https://www.googleapis.com/auth/chat.delete,"
       "https://www.googleapis.com/auth/chat.import,"
@@ -253,6 +259,9 @@ service ChatService {
   // Lists spaces visible to the caller or authenticated user. Group chats
   // and DMs aren't listed until the first message is sent.
   //
+  // 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)
+  // method using Workspace administrator privileges instead.
   rpc ListSpaces(ListSpacesRequest) returns (ListSpacesResponse) {
     option (google.api.http) = {
       get: "/v1/spaces"
@@ -311,6 +320,17 @@ service ChatService {
   // you can add the user to the space by setting the `membership.member.name`
   // to `users/user@example.com` or `users/123456789`.
   //
+  // To specify the Google groups to add, add memberships with the
+  // appropriate `membership.group_member.name`. To add or invite a Google
+  // group, use `groups/{group}`, where `{group}` is the `id` for the group from
+  // the Cloud Identity Groups API. For example, you can use [Cloud Identity
+  // Groups lookup
+  // API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup)
+  // to retrieve the ID `123456789` for group email `group@example.com`, then
+  // you can add the group to the space by setting the
+  // `membership.group_member.name` to `groups/123456789`. Group email is not
+  // supported, and Google groups can only be added as members in named spaces.
+  //
   // For a named space or group chat, if the caller blocks, or is blocked
   // by some members, or doesn't have permission to add some members, then
   // those members aren't added to the created space.
@@ -427,7 +447,8 @@ service ChatService {
   // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   //
   // To specify the member to add, set the `membership.member.name` for the
-  // human or app member.
+  // human or app member, or set the `membership.group_member.name` for the
+  // group member.
   //
   // - To add the calling app to a space or a direct message between two human
   //   users, use `users/app`. Unable to add other
@@ -440,6 +461,15 @@ service ChatService {
   // profile ID for `user@example.com` is `123456789`, you can add the user to
   // the space by setting the `membership.member.name` to
   // `users/user@example.com` or `users/123456789`.
+  //
+  // - To add or invite a Google group in a named space, use
+  // `groups/{group}`, where `{group}` is the `id` for the group from the Cloud
+  // Identity Groups API. For example, you can use [Cloud Identity Groups lookup
+  // API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup)
+  // to retrieve the ID `123456789` for group email `group@example.com`, then
+  // you can add or invite the group to a named space by setting the
+  // `membership.group_member.name` to `groups/123456789`. Group email is not
+  // supported, and Google groups can only be added as members in named spaces.
   rpc CreateMembership(CreateMembershipRequest) returns (Membership) {
     option (google.api.http) = {
       post: "/v1/{parent=spaces/*}/members"
@@ -555,4 +585,47 @@ service ChatService {
     };
     option (google.api.method_signature) = "name";
   }
+
+  // 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)
+  // contains the most recent version of the resource that changed. For example,
+  // if you request an event about a new message but the message was later
+  // updated, the server returns the updated `Message` resource in the event
+  // payload.
+  //
+  // Requires [user
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+  // To get an event, the authenticated user must be a member of the space.
+  //
+  // For an example, see [Get details about an
+  // event from a Google Chat
+  // space](https://developers.google.com/workspace/chat/get-space-event).
+  rpc GetSpaceEvent(GetSpaceEventRequest) returns (SpaceEvent) {
+    option (google.api.http) = {
+      get: "/v1/{name=spaces/*/spaceEvents/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Lists events from a Google Chat space. For each event, the
+  // [payload](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.oneof_payload)
+  // contains the most recent version of the Chat resource. For example, if you
+  // list events about new space members, the server returns `Membership`
+  // resources that contain the latest membership details. If new members were
+  // removed during the requested period, the event payload contains an empty
+  // `Membership` resource.
+  //
+  // Requires [user
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+  // To list events, the authenticated user must be a member of the space.
+  //
+  // For an example, see [List events from a Google Chat
+  // space](https://developers.google.com/workspace/chat/list-space-events).
+  rpc ListSpaceEvents(ListSpaceEventsRequest)
+      returns (ListSpaceEventsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=spaces/*}/spaceEvents"
+    };
+    option (google.api.method_signature) = "parent,filter";
+  }
 }

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

@@ -0,0 +1,177 @@
+// Copyright 2024 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.chat.v1;
+
+import "google/api/field_behavior.proto";
+import "google/chat/v1/membership.proto";
+import "google/chat/v1/message.proto";
+import "google/chat/v1/reaction.proto";
+import "google/chat/v1/space.proto";
+
+option csharp_namespace = "Google.Apps.Chat.V1";
+option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
+option java_multiple_files = true;
+option java_outer_classname = "EventPayloadProto";
+option java_package = "com.google.chat.v1";
+option objc_class_prefix = "DYNAPIProto";
+option php_namespace = "Google\\Apps\\Chat\\V1";
+option ruby_package = "Google::Apps::Chat::V1";
+
+// Event payload for a new membership.
+//
+// Event type: `google.workspace.chat.membership.v1.created`.
+message MembershipCreatedEventData {
+  // The new membership.
+  Membership membership = 1;
+}
+
+// Event payload for a deleted membership.
+//
+// Event type: `google.workspace.chat.membership.v1.deleted`
+message MembershipDeletedEventData {
+  // The deleted membership. Only the `name` and `state` fields are populated.
+  Membership membership = 1;
+}
+
+// Event payload for an updated membership.
+//
+// Event type: `google.workspace.chat.membership.v1.updated`
+message MembershipUpdatedEventData {
+  // The updated membership.
+  Membership membership = 1;
+}
+
+// Event payload for multiple new memberships.
+//
+// Event type: `google.workspace.chat.membership.v1.batchCreated`
+message MembershipBatchCreatedEventData {
+  // A list of new memberships.
+  repeated MembershipCreatedEventData memberships = 1;
+}
+
+// Event payload for multiple updated memberships.
+//
+// Event type: `google.workspace.chat.membership.v1.batchUpdated`
+message MembershipBatchUpdatedEventData {
+  // A list of updated memberships.
+  repeated MembershipUpdatedEventData memberships = 1;
+}
+
+// Event payload for multiple deleted memberships.
+//
+// Event type: `google.workspace.chat.membership.v1.batchDeleted`
+message MembershipBatchDeletedEventData {
+  // A list of deleted memberships.
+  repeated MembershipDeletedEventData memberships = 1;
+}
+
+// Event payload for a new message.
+//
+// Event type: `google.workspace.chat.message.v1.created`
+message MessageCreatedEventData {
+  // The new message.
+  Message message = 1;
+}
+
+// Event payload for an updated message.
+//
+// Event type: `google.workspace.chat.message.v1.updated`
+message MessageUpdatedEventData {
+  // The updated message.
+  Message message = 1;
+}
+
+// Event payload for a deleted message.
+//
+// Event type: `google.workspace.chat.message.v1.deleted`
+message MessageDeletedEventData {
+  // The deleted message. Only the `name`, `createTime`, `deleteTime`, and
+  // `deletionMetadata` fields are populated.
+  Message message = 1;
+}
+
+// Event payload for multiple new messages.
+//
+// Event type: `google.workspace.chat.message.v1.batchCreated`
+message MessageBatchCreatedEventData {
+  // A list of new messages.
+  repeated MessageCreatedEventData messages = 1;
+}
+
+// Event payload for multiple updated messages.
+//
+// Event type: `google.workspace.chat.message.v1.batchUpdated`
+message MessageBatchUpdatedEventData {
+  // A list of updated messages.
+  repeated MessageUpdatedEventData messages = 1;
+}
+
+// Event payload for multiple deleted messages.
+//
+// Event type: `google.workspace.chat.message.v1.batchDeleted`
+message MessageBatchDeletedEventData {
+  // A list of deleted messages.
+  repeated MessageDeletedEventData messages = 1;
+}
+
+// Event payload for an updated space.
+//
+// Event type: `google.workspace.chat.space.v1.updated`
+message SpaceUpdatedEventData {
+  // The updated space.
+  Space space = 1;
+}
+
+// Event payload for multiple updates to a space.
+//
+// Event type: `google.workspace.chat.space.v1.batchUpdated`
+message SpaceBatchUpdatedEventData {
+  // A list of updated spaces.
+  repeated SpaceUpdatedEventData spaces = 1;
+}
+
+// Event payload for a new reaction.
+//
+// Event type: `google.workspace.chat.reaction.v1.created`
+message ReactionCreatedEventData {
+  // The new reaction.
+  Reaction reaction = 1;
+}
+
+// Event payload for a deleted reaction.
+//
+// Type: `google.workspace.chat.reaction.v1.deleted`
+message ReactionDeletedEventData {
+  // The deleted reaction.
+  Reaction reaction = 1;
+}
+
+// Event payload for multiple new reactions.
+//
+// Event type: `google.workspace.chat.reaction.v1.batchCreated`
+message ReactionBatchCreatedEventData {
+  // A list of new reactions.
+  repeated ReactionCreatedEventData reactions = 1;
+}
+
+// Event payload for multiple deleted reactions.
+//
+// Event type: `google.workspace.chat.reaction.v1.batchDeleted`
+message ReactionBatchDeletedEventData {
+  // A list of deleted reactions.
+  repeated ReactionDeletedEventData reactions = 1;
+}

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

@@ -106,8 +106,6 @@ message Membership {
     User member = 3;
 
     // The Google Group the membership corresponds to.
-    // Only supports read operations. Other operations, like
-    // creating or updating a membership, aren't currently supported.
     Group group_member = 5;
   }
 
@@ -217,16 +215,23 @@ message ListMembershipsRequest {
   //
   // To filter by role, set `role` to `ROLE_MEMBER` or `ROLE_MANAGER`.
   //
-  // To filter by type, set `member.type` to `HUMAN` or `BOT`.
+  // To filter by type, set `member.type` to `HUMAN` or `BOT`. Developer
+  // Preview: You can also filter for `member.type` using the `!=` operator.
   //
   // To filter by both role and type, use the `AND` operator. To filter by
   // either role or type, use the `OR` operator.
   //
+  // Either `member.type = "HUMAN"` or `member.type != "BOT"` is required
+  // when `use_admin_access` is set to true. Other member type filters will be
+  // rejected.
+  //
   // For example, the following queries are valid:
   //
   // ```
   // role = "ROLE_MANAGER" OR role = "ROLE_MEMBER"
   // member.type = "HUMAN" AND role = "ROLE_MANAGER"
+  //
+  // member.type != "BOT"
   // ```
   //
   // The following queries are invalid:
@@ -236,7 +241,6 @@ message ListMembershipsRequest {
   // role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"
   // ```
   //
-  //
   // Invalid queries are rejected by the server with an `INVALID_ARGUMENT`
   // error.
   string filter = 5 [(google.api.field_behavior) = OPTIONAL];

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

@@ -103,6 +103,39 @@ message Space {
     string guidelines = 2;
   }
 
+  // Represents the [access
+  // setting](https://support.google.com/chat/answer/11971020) of the space.
+  message AccessSettings {
+    // Represents the access state of the space.
+    enum AccessState {
+      // Access state is unknown or not supported in this API.
+      ACCESS_STATE_UNSPECIFIED = 0;
+
+      // Space is discoverable by added or invited members or groups.
+      PRIVATE = 1;
+
+      // Space is discoverable by the selected [target
+      // audience](https://support.google.com/a/answer/9934697), as well as
+      // added or invited members or groups.
+      DISCOVERABLE = 2;
+    }
+
+    // Output only. Indicates the access state of the space.
+    AccessState access_state = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Optional. The resource name of the [target
+    // audience](https://support.google.com/a/answer/9934697) who can discover
+    // the space, join the space, and preview the messages in the space. For
+    // details, see [Make a space discoverable to a target
+    // audience](https://developers.google.com/workspace/chat/space-target-audience).
+    //
+    // Format: `audiences/{audience}`
+    //
+    // To use the default target audience for the Google Workspace organization,
+    // set to `audiences/default`.
+    string audience = 3 [(google.api.field_behavior) = OPTIONAL];
+  }
+
   // Resource name of the space.
   //
   // Format: `spaces/{space}`
@@ -192,6 +225,14 @@ message Space {
   //
   // To support admin install, your Chat app must feature direct messaging.
   bool admin_installed = 19 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Optional. Specifies the [access
+  // setting](https://support.google.com/chat/answer/11971020) of the space.
+  // Only populated when the `space_type` is `SPACE`.
+  AccessSettings access_settings = 23 [(google.api.field_behavior) = OPTIONAL];
+
+  // Output only. The URI for a user to access the space.
+  string space_uri = 25 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // A request to create a named space.
@@ -270,7 +311,7 @@ message ListSpacesResponse {
 
 // A request to return a single space.
 message GetSpaceRequest {
-  // Required. Resource name of the space, in the form "spaces/*".
+  // Required. Resource name of the space, in the form `spaces/{space}`.
   //
   // Format: `spaces/{space}`
   string name = 1 [
@@ -325,6 +366,7 @@ message UpdateSpaceRequest {
   // the display name is optional if the existing space already has the `SPACE`
   // type. Trying to update the space type in other ways results in an invalid
   // argument error).
+  // `space_type` is not supported with admin access.
   //
   // - `space_details`
   //
@@ -333,12 +375,27 @@ message UpdateSpaceRequest {
   // allows users to change their history
   // setting](https://support.google.com/a/answer/7664184).
   // Warning: mutually exclusive with all other field paths.)
+  // `space_history_state` is not supported with admin access.
+  //
+  // - `access_settings.audience` (Supports changing the [access
+  // setting](https://support.google.com/chat/answer/11971020) of who can
+  // discover the space, join the space, and preview the messages in space. If
+  // no audience is specified in the access setting, the space's access setting
+  // is updated to private. Warning: mutually exclusive with all other field
+  // paths.)
+  // `access_settings.audience` is not supported with admin access.
   //
-  // - Developer Preview: `access_settings.audience` (Supports changing the
-  // [access setting](https://support.google.com/chat/answer/11971020) of a
-  // space. If no audience is specified in the access setting, the space's
-  // access setting is updated to restricted. Warning: mutually exclusive with
-  // all other field paths.)
+  // - Developer Preview: Supports changing the [permission
+  // settings](https://support.google.com/chat/answer/13340792) of a space,
+  // supported field paths
+  // include: `permission_settings.manage_members_and_groups`,
+  // `permission_settings.modify_space_details`,
+  // `permission_settings.toggle_history`,
+  // `permission_settings.use_at_mention_all`,
+  // `permission_settings.manage_apps`, `permission_settings.manage_webhooks`,
+  // `permission_settings.reply_messages`
+  //  (Warning: mutually exclusive with all other non-permission settings field
+  // paths). `permission_settings` is not supported with admin access.
   google.protobuf.FieldMask update_mask = 2;
 }