@google-apps/chat 0.21.0 → 0.23.0

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/annotation.proto

@@ -152,6 +152,11 @@ message RichLinkMetadata {
     // A Chat space rich link type. For example, a space smart chip.
     CHAT_SPACE = 2;
 
+    // A Gmail message rich link type. Specifically, a Gmail chip from [Share to
+    // Chat](https://support.google.com/chat?p=chat_gmail). The API only
+    // supports reading messages with GMAIL_MESSAGE rich links.
+    GMAIL_MESSAGE = 3;
+
     // A Meet message rich link type. For example, a Meet chip.
     MEET_SPACE = 4;
 

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

@@ -47,9 +47,10 @@ message Attachment {
     UPLOADED_CONTENT = 2;
   }
 
-  // Optional. Resource name of the attachment, in the form
-  // `spaces/{space}/messages/{message}/attachments/{attachment}`.
-  string name = 1 [(google.api.field_behavior) = OPTIONAL];
+  // Identifier. Resource name of the attachment.
+  //
+  // Format: `spaces/{space}/messages/{message}/attachments/{attachment}`.
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
   // Output only. The original file name for the content, not the full path.
   string content_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY];

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

@@ -51,6 +51,7 @@ 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.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.bot,"
@@ -127,21 +128,34 @@ service ChatService {
   }
 
   // Lists messages in a space that the caller is a member of, including
-  // messages from blocked members and spaces. If you list messages from a
+  // messages from blocked members and spaces. System messages, like those
+  // announcing new space members, aren't included. If you list messages from a
   // space with no messages, the response is an empty object. When using a
   // REST/HTTP interface, the response contains an empty JSON object, `{}`.
   // For an example, see
   // [List
   // messages](https://developers.google.com/workspace/chat/api/guides/v1/messages/list).
   //
-  // Requires [user
-  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-  // with one of the following [authorization
-  // scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+  // Supports the following types of
+  // [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
   //
-  //   - `https://www.googleapis.com/auth/chat.messages.readonly`
-  //   - `https://www.googleapis.com/auth/chat.messages`
-  //   - `https://www.googleapis.com/auth/chat.import` (import mode spaces only)
+  // - [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:
+  //     - `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.
+  //
+  // - [User
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+  // with one of the following authorization scopes:
+  //     - `https://www.googleapis.com/auth/chat.messages.readonly`
+  //     - `https://www.googleapis.com/auth/chat.messages`
+  //     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+  //     only)
   rpc ListMessages(ListMessagesRequest) returns (ListMessagesResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=spaces/*}/messages"
@@ -231,8 +245,18 @@ service ChatService {
   //
   // - [App
   // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
-  // with the authorization scope:
-  //     - `https://www.googleapis.com/auth/chat.bot`
+  // with one of the following authorization scopes:
+  //     - `https://www.googleapis.com/auth/chat.bot`: When using this
+  //     authorization scope, this method returns details about a message the
+  //     Chat app has access to, like direct messages and [slash
+  //     commands](https://developers.google.com/workspace/chat/slash-commands)
+  //     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)).
+  //     When using this authentication scope,
+  //     this method returns details about a public message in a space.
   //
   // - [User
   // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
@@ -386,7 +410,9 @@ service ChatService {
   }
 
   // Returns a list of spaces in a Google Workspace organization based on an
-  // administrator's search.
+  // administrator's search. In the request, set `use_admin_access` to `true`.
+  // For an example, see [Search for and manage
+  // spaces](https://developers.google.com/workspace/chat/search-manage-admin).
   //
   // Requires [user
   // authentication with administrator
@@ -396,8 +422,6 @@ service ChatService {
   //
   //   - `https://www.googleapis.com/auth/chat.admin.spaces.readonly`
   //   - `https://www.googleapis.com/auth/chat.admin.spaces`
-  //
-  // In the request, set `use_admin_access` to `true`.
   rpc SearchSpaces(SearchSpacesRequest) returns (SearchSpacesResponse) {
     option (google.api.http) = {
       get: "/v1/spaces:search"
@@ -1040,22 +1064,36 @@ service ChatService {
   // Note: The `permissionSettings` field is not returned in the Space
   // object of the Space event data for this request.
   //
-  // Requires [user
-  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-  // with an [authorization
+  // Supports the following types of
+  // [authentication](https://developers.google.com/workspace/chat/authenticate-authorize)
+  // with an
+  // [authorization
   // scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes)
   // appropriate for reading the requested data:
   //
-  //   - `https://www.googleapis.com/auth/chat.spaces.readonly`
-  //   - `https://www.googleapis.com/auth/chat.spaces`
-  //   - `https://www.googleapis.com/auth/chat.messages.readonly`
-  //   - `https://www.googleapis.com/auth/chat.messages`
-  //   - `https://www.googleapis.com/auth/chat.messages.reactions.readonly`
-  //   - `https://www.googleapis.com/auth/chat.messages.reactions`
-  //   - `https://www.googleapis.com/auth/chat.memberships.readonly`
-  //   - `https://www.googleapis.com/auth/chat.memberships`
+  // - [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:
+  //     - `https://www.googleapis.com/auth/chat.app.spaces`
+  //     - `https://www.googleapis.com/auth/chat.app.messages.readonly`
+  //     - `https://www.googleapis.com/auth/chat.app.memberships`
+  //
+  // - [User
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+  // with one of the following authorization scopes:
+  //     - `https://www.googleapis.com/auth/chat.spaces.readonly`
+  //     - `https://www.googleapis.com/auth/chat.spaces`
+  //     - `https://www.googleapis.com/auth/chat.messages.readonly`
+  //     - `https://www.googleapis.com/auth/chat.messages`
+  //     - `https://www.googleapis.com/auth/chat.messages.reactions.readonly`
+  //     - `https://www.googleapis.com/auth/chat.messages.reactions`
+  //     - `https://www.googleapis.com/auth/chat.memberships.readonly`
+  //     - `https://www.googleapis.com/auth/chat.memberships`
   //
-  // To get an event, the authenticated user must be a member of the space.
+  // To get an event, the authenticated caller must be a member of the space.
   //
   // For an example, see [Get details about an
   // event from a Google Chat
@@ -1075,22 +1113,36 @@ service ChatService {
   // 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)
-  // with an [authorization
+  // Supports the following types of
+  // [authentication](https://developers.google.com/workspace/chat/authenticate-authorize)
+  // with an
+  // [authorization
   // scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes)
   // appropriate for reading the requested data:
   //
-  //   - `https://www.googleapis.com/auth/chat.spaces.readonly`
-  //   - `https://www.googleapis.com/auth/chat.spaces`
-  //   - `https://www.googleapis.com/auth/chat.messages.readonly`
-  //   - `https://www.googleapis.com/auth/chat.messages`
-  //   - `https://www.googleapis.com/auth/chat.messages.reactions.readonly`
-  //   - `https://www.googleapis.com/auth/chat.messages.reactions`
-  //   - `https://www.googleapis.com/auth/chat.memberships.readonly`
-  //   - `https://www.googleapis.com/auth/chat.memberships`
+  // - [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:
+  //     - `https://www.googleapis.com/auth/chat.app.spaces`
+  //     - `https://www.googleapis.com/auth/chat.app.messages.readonly`
+  //     - `https://www.googleapis.com/auth/chat.app.memberships`
+  //
+  // - [User
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+  // with one of the following authorization scopes:
+  //     - `https://www.googleapis.com/auth/chat.spaces.readonly`
+  //     - `https://www.googleapis.com/auth/chat.spaces`
+  //     - `https://www.googleapis.com/auth/chat.messages.readonly`
+  //     - `https://www.googleapis.com/auth/chat.messages`
+  //     - `https://www.googleapis.com/auth/chat.messages.reactions.readonly`
+  //     - `https://www.googleapis.com/auth/chat.messages.reactions`
+  //     - `https://www.googleapis.com/auth/chat.memberships.readonly`
+  //     - `https://www.googleapis.com/auth/chat.memberships`
   //
-  // To list events, the authenticated user must be a member of the space.
+  // To list events, the authenticated caller 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).

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

@@ -99,7 +99,7 @@ message MessageUpdatedEventData {
 //
 // Event type: `google.workspace.chat.message.v1.deleted`
 message MessageDeletedEventData {
-  // The deleted message. Only the `name`, `createTime`, `deleteTime`, and
+  // The deleted message. Only the `name`, `createTime`, and
   // `deletionMetadata` fields are populated.
   Message message = 1;
 }

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.
@@ -127,6 +127,8 @@ message Message {
   // This doesn't apply to Unicode emoji, such as `U+1F600` for a grinning
   // face emoji.
   //
+  // * Bullet list items using asterisks (`*`)—for example, `* item`.
+  //
   // For more information, see [View text formatting sent in a
   // message](https://developers.google.com/workspace/chat/format-messages#view_text_formatting_sent_in_a_message)
   string formatted_text = 43 [(google.api.field_behavior) = OUTPUT_ONLY];
@@ -223,8 +225,6 @@ message Message {
   // and omit the following:
   //
   // * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments)
-  // * [Accessory
-  // widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget)
   //
   // For details, see [Send a message
   // privately](https://developers.google.com/workspace/chat/create-messages#private).
@@ -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

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

@@ -370,7 +370,8 @@ message Space {
   // Private apps can also use the `customers/my_customer` alias to create
   // the space in the same Google Workspace organization as the app.
   //
-  // For DMs, this field isn't populated.
+  // This field isn't populated for direct messages (DMs) or when the space is
+  // created by non-Google Workspace users.
   optional string customer = 24 [
     (google.api.field_behavior) = IMMUTABLE,
     (google.api.field_behavior) = OPTIONAL
@@ -563,8 +564,10 @@ message UpdateSpaceRequest {
   //
   // You can update the following fields for a space:
   //
-  // `space_details`: Updates the space's description. Supports up to 150
-  // characters.
+  // `space_details`: Updates the space's description and guidelines. You must
+  // pass both description and guidelines in the update request as
+  // [`SpaceDetails`][google.chat.v1.Space.SpaceDetails]. If you only want to
+  // update one of the fields, pass the existing value for the other field.
   //
   // `display_name`: Only supports updating the display name for spaces where
   // `spaceType` field is `SPACE`.
@@ -608,8 +611,7 @@ message UpdateSpaceRequest {
   // of a space.
   // When updating permission settings, you can only specify
   // `permissionSettings` field masks; you cannot update other field masks
-  // at the same time. `permissionSettings` is not supported with
-  // `useAdminAccess`.
+  // at the same time.
   // The supported field masks include:
   //
   // - `permission_settings.manageMembersAndGroups`