@google-apps/chat 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [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)
+
+
+### Features
+
+* [chat] update Nodejs generator to send API versions in headers for GAPICs ([#5345](https://github.com/googleapis/google-cloud-node/issues/5345)) ([e99879b](https://github.com/googleapis/google-cloud-node/commit/e99879b86eef7eb62f828fe4c3061a2077d714cc))
+* [Many APIs] update Nodejs generator to send API versions in headers for GAPICs ([#5351](https://github.com/googleapis/google-cloud-node/issues/5351)) ([01f48fc](https://github.com/googleapis/google-cloud-node/commit/01f48fce63ec4ddf801d59ee2b8c0db9f6fb8372))
+* [Many APIs] update Nodejs generator to send API versions in headers for GAPICs ([#5354](https://github.com/googleapis/google-cloud-node/issues/5354)) ([a9784ed](https://github.com/googleapis/google-cloud-node/commit/a9784ed3db6ee96d171762308bbbcd57390b6866))
+
 ## [0.4.0](https://github.com/googleapis/google-cloud-node/compare/chat-v0.3.0...chat-v0.4.0) (2024-04-23)
 
 

package/build/protos/google/apps/card/v1/card.proto

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// 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.

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

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// 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.
@@ -23,6 +23,7 @@ option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "ActionStatusProto";
 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";
 

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

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// 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.
@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.chat.v1;
 
+import "google/api/resource.proto";
 import "google/chat/v1/attachment.proto";
 import "google/chat/v1/user.proto";
 
@@ -24,6 +25,7 @@ option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "AnnotationProto";
 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";
 

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

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// 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.
@@ -24,6 +24,7 @@ option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "AttachmentProto";
 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";
 
@@ -47,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.
@@ -102,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

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// 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.
@@ -33,6 +33,7 @@ option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "ChatServiceProto";
 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";
 
@@ -41,6 +42,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,"
@@ -59,7 +65,8 @@ service ChatService {
       "https://www.googleapis.com/auth/chat.users.readstate,"
       "https://www.googleapis.com/auth/chat.users.readstate.readonly";
 
-  // Creates a message in a Google Chat space. For an example, see [Send a
+  // Creates a message in a Google Chat space. The maximum message size,
+  // including text and cards, is 32,000 bytes. For an example, see [Send a
   // message](https://developers.google.com/workspace/chat/create-messages).
   //
   // Calling this method requires
@@ -250,6 +257,10 @@ 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"
@@ -300,17 +311,28 @@ service ChatService {
   // members](https://developers.google.com/workspace/chat/set-up-spaces).
   //
   // To specify the human members to add, add memberships with the appropriate
-  // `member.name` in the `SetUpSpaceRequest`. To add a human user, use
-  // `users/{user}`, where `{user}` can be the email address for the user. For
-  // users in the same Workspace organization `{user}` can also be the `id` for
-  // the person from the People API, or the `id` for the user in the Directory
-  // API. For example, if the People API Person 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`.
-  //
-  // For a space or group chat, if the caller blocks or is blocked by some
-  // members, then those members aren't added to the created space.
+  // `membership.member.name`. To add a human user, use `users/{user}`, where
+  // `{user}` can be the email address for the user. For users in the same
+  // Workspace organization `{user}` can also be the `id` for the person from
+  // the People API, or the `id` for the user in the Directory API. For example,
+  // if the People API Person 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 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.
   //
   // To create a direct message (DM) between the calling user and another human
   // user, specify exactly one membership to represent the human user. If
@@ -423,8 +445,9 @@ service ChatService {
   // directly to the specified space. Requires [user
   // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   //
-  // To specify the member to add, set the `membership.member.name` in the
-  // `CreateMembershipRequest`:
+  // To specify the member to add, set the `membership.member.name` for the
+  // 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
@@ -437,6 +460,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"
@@ -445,8 +477,11 @@ service ChatService {
     option (google.api.method_signature) = "parent,membership";
   }
 
-  // Updates a membership. Requires [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // Updates a membership. For an example, see [Update a user's membership in
+  // a space](https://developers.google.com/workspace/chat/update-members).
+  //
+  // Requires [user
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   rpc UpdateMembership(UpdateMembershipRequest) returns (Membership) {
     option (google.api.http) = {
       patch: "/v1/{membership.name=spaces/*/members/*}"
@@ -508,7 +543,9 @@ service ChatService {
   }
 
   // Returns details about a user's read state within a space, used to identify
-  // read and unread messages.
+  // read and unread messages. For an example, see [Get details about a user's
+  // space read
+  // state](https://developers.google.com/workspace/chat/get-space-read-state).
   //
   // Requires [user
   // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -520,7 +557,8 @@ service ChatService {
   }
 
   // Updates a user's read state within a space, used to identify read and
-  // unread messages.
+  // 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).
@@ -534,7 +572,9 @@ service ChatService {
   }
 
   // Returns details about a user's read state within a thread, used to identify
-  // read and unread messages.
+  // read and unread messages. For an example, see [Get details about a user's
+  // thread read
+  // state](https://developers.google.com/workspace/chat/get-thread-read-state).
   //
   // Requires [user
   // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).

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

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// 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.
@@ -23,6 +23,7 @@ option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "ContextualAddOnProto";
 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";
 

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

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// 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.
@@ -21,6 +21,7 @@ option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "DeletionMetadataProto";
 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";
 

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

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// 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.
@@ -21,6 +21,7 @@ option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "GroupProto";
 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";
 

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

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// 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.
@@ -21,6 +21,7 @@ option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "HistoryStateProto";
 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";
 

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

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// 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.
@@ -23,6 +23,7 @@ option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "MatchedUrlProto";
 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";
 

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

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// 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.
@@ -28,6 +28,7 @@ option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "MembershipProto";
 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";
 
@@ -105,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;
   }
 
@@ -216,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:
@@ -235,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];
@@ -275,8 +280,9 @@ message ListMembershipsResponse {
 message GetMembershipRequest {
   // Required. Resource name of the membership to retrieve.
   //
-  // To get the app's own membership, you can optionally use
-  // `spaces/{space}/members/app`.
+  // To get the app's own membership [by using user
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
+  // you can optionally use `spaces/{space}/members/app`.
   //
   // Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`
   //

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

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// 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.
@@ -37,6 +37,7 @@ option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "MessageProto";
 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";
 

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

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// 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.
@@ -25,6 +25,7 @@ option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "ReactionProto";
 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";
 
@@ -61,8 +62,8 @@ message Emoji {
 
 // Represents a custom emoji.
 message CustomEmoji {
-  // Unique key for the custom emoji resource.
-  string uid = 1;
+  // Output only. Unique key for the custom emoji resource.
+  string uid = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // The number of people who reacted to a message with a specific emoji.

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

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// 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.
@@ -21,6 +21,7 @@ option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "SlashCommandProto";
 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";
 

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

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// 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.
@@ -27,6 +27,7 @@ option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "SpaceProto";
 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";
 
@@ -102,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}`
@@ -184,14 +218,21 @@ message Space {
     (google.api.field_behavior) = OPTIONAL
   ];
 
-  // Output only. Whether the Chat app was installed by a Google Workspace
-  // administrator. Administrators can install a Chat app for their domain,
-  // organizational unit, or a group of users.
+  // Output only. For direct message (DM) spaces with a Chat app, whether the
+  // space was created by a Google Workspace administrator. Administrators can
+  // install and set up a direct message with a Chat app on behalf of users in
+  // their organization.
   //
-  // Administrators can only install Chat apps for direct messaging between
-  // users and the app. To support admin install, your app must feature direct
-  // messaging.
+  // 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;
 }
 

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

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// 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.
@@ -26,6 +26,7 @@ option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "SpaceReadStateProto";
 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";
 

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

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// 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.
@@ -25,6 +25,7 @@ option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "SpaceSetupProto";
 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";
 
@@ -63,19 +64,23 @@ message SetUpSpaceRequest {
   // authenticated user returns an error.
   string request_id = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. The Google Chat users to invite to join the space. Omit the
-  // calling user, as they are added automatically.
+  // Optional. The Google Chat users or groups to invite to join the space. Omit
+  // the calling user, as they are added automatically.
   //
   // The set currently allows up to 20 memberships (in addition to the caller).
   //
-  // The `Membership.member` field must contain a `user` with `name` populated
-  // (format: `users/{user}`) and `type` set to `User.Type.HUMAN`. You can only
-  // add human users when setting up a space (adding Chat apps is only supported
-  // for direct message setup with the calling app). You can also add members
-  // using the user's email as an alias for {user}. For example, the `user.name`
-  // can be `users/example@gmail.com`." To invite Gmail users or users from
-  // external Google Workspace domains, user's email must be used for
-  // `{user}`.
+  // For human membership, the `Membership.member` field must contain a `user`
+  // with `name` populated (format: `users/{user}`) and `type` set to
+  // `User.Type.HUMAN`. You can only add human users when setting up a space
+  // (adding Chat apps is only supported for direct message setup with the
+  // calling app). You can also add members using the user's email as an alias
+  // for {user}. For example, the `user.name` can be `users/example@gmail.com`.
+  // To invite Gmail users or users from external Google Workspace domains,
+  // user's email must be used for `{user}`.
+  //
+  // For Google group membership, the `Membership.group_member` field must
+  // contain a `group` with `name` populated (format `groups/{group}`). You
+  // can only add Google groups when setting `Space.spaceType` to `SPACE`.
   //
   // Optional when setting `Space.spaceType` to `SPACE`.
   //