@google-apps/chat 0.23.0 → 0.24.0

package/README.md

@@ -62,13 +62,16 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
 | create membership | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.create_membership.js) |
 | create message | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.create_message.js) |
 | create reaction | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.create_reaction.js) |
+| create section | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.create_section.js) |
 | create space | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.create_space.js) |
 | delete custom emoji | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.delete_custom_emoji.js) |
 | delete membership | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.delete_membership.js) |
 | delete message | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.delete_message.js) |
 | delete reaction | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.delete_reaction.js) |
+| delete section | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.delete_section.js) |
 | delete space | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.delete_space.js) |
 | find direct message | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.find_direct_message.js) |
+| find group chats | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.find_group_chats.js) |
 | get attachment | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_attachment.js) |
 | get custom emoji | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_custom_emoji.js) |
 | get membership | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_membership.js) |
@@ -82,12 +85,17 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
 | list memberships | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.list_memberships.js) |
 | list messages | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.list_messages.js) |
 | list reactions | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.list_reactions.js) |
+| list section items | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.list_section_items.js) |
+| list sections | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.list_sections.js) |
 | 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) |
 | list spaces | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.list_spaces.js) |
+| move section item | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.move_section_item.js) |
+| position section | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.position_section.js) |
 | search spaces | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.search_spaces.js) |
 | 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) |
 | update membership | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.update_membership.js) |
 | update message | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.update_message.js) |
+| update section | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.update_section.js) |
 | update space | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.update_space.js) |
 | update space notification setting | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.update_space_notification_setting.js) |
 | update space read state | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.update_space_read_state.js) |

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 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/annotation.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 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/attachment.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 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/chat_service.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -22,6 +22,7 @@ import "google/chat/v1/attachment.proto";
 import "google/chat/v1/membership.proto";
 import "google/chat/v1/message.proto";
 import "google/chat/v1/reaction.proto";
+import "google/chat/v1/section.proto";
 import "google/chat/v1/space.proto";
 import "google/chat/v1/space_event.proto";
 import "google/chat/v1/space_notification_setting.proto";
@@ -51,9 +52,11 @@ service ChatService {
       "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.memberships.readonly,"
       "https://www.googleapis.com/auth/chat.app.messages.readonly,"
       "https://www.googleapis.com/auth/chat.app.spaces,"
       "https://www.googleapis.com/auth/chat.app.spaces.create,"
+      "https://www.googleapis.com/auth/chat.app.spaces.readonly,"
       "https://www.googleapis.com/auth/chat.bot,"
       "https://www.googleapis.com/auth/chat.customemojis,"
       "https://www.googleapis.com/auth/chat.customemojis.readonly,"
@@ -73,6 +76,8 @@ service ChatService {
       "https://www.googleapis.com/auth/chat.spaces.readonly,"
       "https://www.googleapis.com/auth/chat.users.readstate,"
       "https://www.googleapis.com/auth/chat.users.readstate.readonly,"
+      "https://www.googleapis.com/auth/chat.users.sections,"
+      "https://www.googleapis.com/auth/chat.users.sections.readonly,"
       "https://www.googleapis.com/auth/chat.users.spacesettings";
 
   // Creates a message in a Google Chat space. For an example, see [Send a
@@ -142,9 +147,8 @@ 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 the authorization scope:
+  // approval](https://support.google.com/a?p=chat-app-auth)
+  // with the authorization scope:
   //     - `https://www.googleapis.com/auth/chat.app.messages.readonly`. When
   //     using this authentication scope, this method only returns public
   //     messages in a space. It doesn't include private messages.
@@ -253,8 +257,7 @@ service ChatService {
   //     that invoke the Chat app.
   //     - `https://www.googleapis.com/auth/chat.app.messages.readonly`
   //     with [administrator
-  //     approval](https://support.google.com/a?p=chat-app-auth) (available in
-  //     [Developer Preview](https://developers.google.com/workspace/preview)).
+  //     approval](https://support.google.com/a?p=chat-app-auth).
   //     When using this authentication scope,
   //     this method returns details about a public message in a space.
   //
@@ -714,6 +717,32 @@ service ChatService {
     };
   }
 
+  // Returns all spaces with `spaceType == GROUP_CHAT`, whose
+  // human memberships contain exactly the calling user, and the users specified
+  // in `FindGroupChatsRequest.users`. Only members that have joined the
+  // conversation are supported. For an example, see [Find group
+  // chats](https://developers.google.com/workspace/chat/find-group-chats).
+  //
+  // If the calling user blocks, or is blocked by, some users, and no spaces
+  // with the entire specified set of users are found, this method returns
+  // spaces that don't include the blocked or blocking users.
+  //
+  // The specified set of users must contain only human (non-app) memberships.
+  // A request that contains non-human users doesn't return any spaces.
+  //
+  // Requires [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.memberships.readonly`
+  //   - `https://www.googleapis.com/auth/chat.memberships`
+  rpc FindGroupChats(FindGroupChatsRequest) returns (FindGroupChatsResponse) {
+    option (google.api.http) = {
+      get: "/v1/spaces:findGroupChats"
+    };
+  }
+
   // Creates a membership for the calling Chat app, a user, or a Google Group.
   // Creating memberships for other Chat apps isn't supported.
   // When creating a membership, if the specified member has their auto-accept
@@ -1074,12 +1103,13 @@ 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 one of the following authorization scopes:
+  // approval](https://support.google.com/a?p=chat-app-auth)
+  // with one of the following authorization scopes:
   //     - `https://www.googleapis.com/auth/chat.app.spaces`
+  //     - `https://www.googleapis.com/auth/chat.app.spaces.readonly`
   //     - `https://www.googleapis.com/auth/chat.app.messages.readonly`
   //     - `https://www.googleapis.com/auth/chat.app.memberships`
+  //     - `https://www.googleapis.com/auth/chat.app.memberships.readonly`
   //
   // - [User
   // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
@@ -1123,12 +1153,13 @@ 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 one of the following authorization scopes:
+  // approval](https://support.google.com/a?p=chat-app-auth)
+  // with one of the following authorization scopes:
   //     - `https://www.googleapis.com/auth/chat.app.spaces`
+  //     - `https://www.googleapis.com/auth/chat.app.spaces.readonly`
   //     - `https://www.googleapis.com/auth/chat.app.messages.readonly`
   //     - `https://www.googleapis.com/auth/chat.app.memberships`
+  //     - `https://www.googleapis.com/auth/chat.app.memberships.readonly`
   //
   // - [User
   // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
@@ -1191,4 +1222,139 @@ service ChatService {
     option (google.api.method_signature) =
         "space_notification_setting,update_mask";
   }
+
+  // Creates a section in Google Chat. Sections help users group conversations
+  // and customize the list of spaces displayed in Chat navigation panel. Only
+  // sections of type `CUSTOM_SECTION` can be created. For details, see [Create
+  // and organize sections in Google
+  // Chat](https://support.google.com/chat/answer/16059854).
+  //
+  // Requires [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.sections`
+  rpc CreateSection(CreateSectionRequest) returns (Section) {
+    option (google.api.http) = {
+      post: "/v1/{parent=users/*}/sections"
+      body: "section"
+    };
+    option (google.api.method_signature) = "parent,section";
+  }
+
+  // Deletes a section of type `CUSTOM_SECTION`.
+  //
+  // If the section contains items, such as spaces, the items are moved to
+  // Google Chat's default sections and are not deleted.
+  //
+  // For details, see [Create and organize sections in Google
+  // Chat](https://support.google.com/chat/answer/16059854).
+  //
+  // Requires [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.sections`
+  rpc DeleteSection(DeleteSectionRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=users/*/sections/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Updates a section. Only sections of type `CUSTOM_SECTION` can be updated.
+  // For details, see [Create and organize sections in Google
+  // Chat](https://support.google.com/chat/answer/16059854).
+  //
+  // Requires [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.sections`
+  rpc UpdateSection(UpdateSectionRequest) returns (Section) {
+    option (google.api.http) = {
+      patch: "/v1/{section.name=users/*/sections/*}"
+      body: "section"
+    };
+    option (google.api.method_signature) = "section,update_mask";
+  }
+
+  // Lists sections available to the Chat user. Sections help users group their
+  // conversations and customize the list of spaces displayed in Chat
+  // navigation panel. For details, see [Create and organize sections in Google
+  // Chat](https://support.google.com/chat/answer/16059854).
+  //
+  // Requires [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.sections`
+  //   - `https://www.googleapis.com/auth/chat.users.sections.readonly`
+  rpc ListSections(ListSectionsRequest) returns (ListSectionsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=users/*}/sections"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Changes the sort order of a section. For details, see [Create and organize
+  // sections in Google Chat](https://support.google.com/chat/answer/16059854).
+  //
+  // Requires [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.sections`
+  rpc PositionSection(PositionSectionRequest)
+      returns (PositionSectionResponse) {
+    option (google.api.http) = {
+      post: "/v1/{name=users/*/sections/*}:position"
+      body: "*"
+    };
+  }
+
+  // Lists items in a section.
+  //
+  // Only spaces can be section items. For details, see [Create and organize
+  // sections in Google Chat](https://support.google.com/chat/answer/16059854).
+  //
+  // Requires [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.sections`
+  //   - `https://www.googleapis.com/auth/chat.users.sections.readonly`
+  rpc ListSectionItems(ListSectionItemsRequest)
+      returns (ListSectionItemsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=users/*/sections/*}/items"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Moves an item from one section to another. For example, if a section
+  // contains spaces, this method can be used to move a space to a different
+  // section. For details, see [Create and organize sections in Google
+  // Chat](https://support.google.com/chat/answer/16059854).
+  //
+  // Requires [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.sections`
+  rpc MoveSectionItem(MoveSectionItemRequest)
+      returns (MoveSectionItemResponse) {
+    option (google.api.http) = {
+      post: "/v1/{name=users/*/sections/*/items/*}:move"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name,target_section";
+  }
 }

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 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/deletion_metadata.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 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/event_payload.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 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/group.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 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/history_state.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 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/matched_url.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 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/membership.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 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/message.proto

@@ -204,6 +204,10 @@ message Message {
   // `false`.
   bool thread_reply = 25 [(google.api.field_behavior) = OUTPUT_ONLY];
 
+  // Output only. Whether this is a silent message. Silent messages are messages
+  // where Chat suppresses push notifications for recipients.
+  bool silent = 46 [(google.api.field_behavior) = OUTPUT_ONLY];
+
   // Optional. A custom ID for the message. You can use field to identify a
   // message, or to get, delete, or update a message. To set a custom ID,
   // specify the
@@ -646,6 +650,43 @@ message CreateMessageRequest {
   // For details, see [Name a
   // message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
   string message_id = 9 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Controls the notification behavior when the message is posted.
+  // To learn more, see [Force notifications or send silent
+  // messages](https://developer.google.com/workspace/chat/create-messages#force-notify-silent).
+  CreateMessageNotificationOptions create_message_notification_options = 10
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Options for the notification behavior when the message is posted.
+message CreateMessageNotificationOptions {
+  // The notification types options for the message.
+  enum NotificationType {
+    // Default behavior. Notification behavior is similar to when the human user
+    // sends the message using the Chat UI: no notification is sent to the
+    // human sender.
+    NOTIFICATION_TYPE_NONE = 0;
+
+    // Force notify recipients. This bypasses users' space notification settings
+    // and [Chat Do Not Disturb
+    // settings](https://support.google.com/chat/answer/9093489). This option
+    // does not bypass device-level Do Not Disturb settings.
+    //
+    // Requires [app authentication]
+    // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
+    NOTIFICATION_TYPE_FORCE_NOTIFY = 2;
+
+    // Silence the notification as if the recipients have [Chat Do Not
+    // Disturb](https://support.google.com/chat/answer/9093489) enabled or
+    // have muted the space.
+    //
+    // Requires [app authentication]
+    // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
+    NOTIFICATION_TYPE_SILENT = 3;
+  }
+
+  // The notification type for the message.
+  NotificationType notification_type = 1;
 }
 
 // Lists messages in the specified space, that the user is a member of.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.