@google-apps/chat 0.22.0 → 0.23.1

package/README.md

@@ -62,11 +62,13 @@ 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) |
 | get attachment | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_attachment.js) |
@@ -82,12 +84,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/apps/card/v1/card.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.
@@ -1197,6 +1197,26 @@ message SelectionInput {
     SWITCH = 2;
 
     // A dropdown menu. Users can select one item from the menu.
+    //
+    // For Google Chat apps, you can populate items using a dynamic data source
+    // and autosuggest items as users type in the menu. For example, users can
+    // start typing the name of a Google Chat space and the widget autosuggests
+    // the space. To dynamically populate items for a dropdown menu, use one of
+    // the following types of data sources:
+    //
+    //  * Google Workspace data: Items are populated using data from Google
+    //    Workspace, such as Google Workspace users or Google Chat spaces.
+    //  * External data: Items are populated from an external data
+    //    source outside of Google Workspace.
+    //
+    // For examples of how to implement dropdown menus for Chat apps, see
+    // [Add a dropdown
+    // menu](https://developers.google.com/workspace/chat/design-interactive-card-dialog#dropdown-menu)
+    // and [Dynamically populate drop-down
+    // menus](https://developers.google.com/workspace/chat/design-interactive-card-dialog#dynamic-dropdown-menu).
+    //
+    // [Google Workspace add-ons and Chat
+    // apps](https://developers.google.com/workspace/extend):
     DROPDOWN = 3;
 
     // A menu with a text box. Users can type and select one or more items.

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.
   //
@@ -1074,12 +1077,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 +1127,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 +1196,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/message.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.
@@ -292,6 +292,23 @@ message QuotedMessageMetadata {
     pattern: "spaces/{space}/messages/{message}/quotedMessageMetadata/{quoted_message_metadata}"
   };
 
+  // The quote type of the quoted message.
+  enum QuoteType {
+    // Reserved. This value is unused.
+    QUOTE_TYPE_UNSPECIFIED = 0;
+
+    // If quote_type is `REPLY`, you can do the following:
+    //
+    // * If you're replying in a thread, you can quote another message in that
+    // thread.
+    //
+    // * If you're creating a root message, you can quote another root message
+    // in that space.
+    //
+    // You can't quote a message reply from a different thread.
+    REPLY = 1;
+  }
+
   // Required. Resource name of the message that is quoted.
   //
   // Format: `spaces/{space}/messages/{message}`
@@ -310,6 +327,63 @@ message QuotedMessageMetadata {
   // message, the request fails.
   google.protobuf.Timestamp last_update_time = 2
       [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Specifies the quote type. If not set, defaults to REPLY in the
+  // message read/write path for backward compatibility.
+  QuoteType quote_type = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Output only. A snapshot of the quoted message's content.
+  QuotedMessageSnapshot quoted_message_snapshot = 5
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Metadata about the source space of the quoted message.
+  // Populated only for FORWARD quote type.
+  ForwardedMetadata forwarded_metadata = 6
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Provides a snapshot of the content of the quoted message at the time of
+// quoting or forwarding
+message QuotedMessageSnapshot {
+  // Output only. The quoted message's author name.
+  // Populated for both REPLY & FORWARD quote types.
+  string sender = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Snapshot of the quoted message's text content.
+  string text = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Contains the quoted message `text` with markups added to
+  // support rich formatting like hyperlinks,custom emojis, markup, etc.
+  // Populated only for FORWARD quote type.
+  string formatted_text = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Annotations parsed from the text body of the quoted message.
+  // Populated only for FORWARD quote type.
+  repeated Annotation annotations = 4
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Attachments that were part of the quoted message. These are
+  // copies of the quoted message's attachment metadata. Populated only for
+  // FORWARD quote type.
+  repeated Attachment attachments = 5
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Metadata about the source space from which a message was forwarded.
+message ForwardedMetadata {
+  // Output only. The resource name of the source space.
+  // Format: spaces/{space}
+  string space = 1 [
+    (google.api.field_behavior) = OUTPUT_ONLY,
+    (google.api.resource_reference) = { type: "chat.googleapis.com/Space" }
+  ];
+
+  // Output only. The display name of the source space or DM at the time of
+  // forwarding. For `SPACE`, this is the space name. For `DIRECT_MESSAGE`, this
+  // is the other participant's name (e.g., "User A"). For `GROUP_CHAT`, this is
+  // a generated name based on members' first names, limited to 5 including the
+  // creator (e.g., "User A, User B").
+  string space_display_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // A thread in a Google Chat space. For example usage, see