@google-apps/chat 0.21.0 → 0.23.0

package/build/protos/protos.json

@@ -2903,6 +2903,7 @@
                         "RICH_LINK_TYPE_UNSPECIFIED": 0,
                         "DRIVE_FILE": 1,
                         "CHAT_SPACE": 2,
+                        "GMAIL_MESSAGE": 3,
                         "MEET_SPACE": 4,
                         "CALENDAR_EVENT": 5
                       }
@@ -3029,7 +3030,7 @@
                       "type": "string",
                       "id": 1,
                       "options": {
-                        "(google.api.field_behavior)": "OPTIONAL"
+                        "(google.api.field_behavior)": "IDENTIFIER"
                       }
                     },
                     "contentName": {
@@ -3496,7 +3497,7 @@
                 "ChatService": {
                   "options": {
                     "(google.api.default_host)": "chat.googleapis.com",
-                    "(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.app.delete,https://www.googleapis.com/auth/chat.app.memberships,https://www.googleapis.com/auth/chat.app.spaces,https://www.googleapis.com/auth/chat.app.spaces.create,https://www.googleapis.com/auth/chat.bot,https://www.googleapis.com/auth/chat.customemojis,https://www.googleapis.com/auth/chat.customemojis.readonly,https://www.googleapis.com/auth/chat.delete,https://www.googleapis.com/auth/chat.import,https://www.googleapis.com/auth/chat.memberships,https://www.googleapis.com/auth/chat.memberships.app,https://www.googleapis.com/auth/chat.memberships.readonly,https://www.googleapis.com/auth/chat.messages,https://www.googleapis.com/auth/chat.messages.create,https://www.googleapis.com/auth/chat.messages.reactions,https://www.googleapis.com/auth/chat.messages.reactions.create,https://www.googleapis.com/auth/chat.messages.reactions.readonly,https://www.googleapis.com/auth/chat.messages.readonly,https://www.googleapis.com/auth/chat.spaces,https://www.googleapis.com/auth/chat.spaces.create,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.spacesettings"
+                    "(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.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,https://www.googleapis.com/auth/chat.customemojis,https://www.googleapis.com/auth/chat.customemojis.readonly,https://www.googleapis.com/auth/chat.delete,https://www.googleapis.com/auth/chat.import,https://www.googleapis.com/auth/chat.memberships,https://www.googleapis.com/auth/chat.memberships.app,https://www.googleapis.com/auth/chat.memberships.readonly,https://www.googleapis.com/auth/chat.messages,https://www.googleapis.com/auth/chat.messages.create,https://www.googleapis.com/auth/chat.messages.reactions,https://www.googleapis.com/auth/chat.messages.reactions.create,https://www.googleapis.com/auth/chat.messages.reactions.readonly,https://www.googleapis.com/auth/chat.messages.readonly,https://www.googleapis.com/auth/chat.spaces,https://www.googleapis.com/auth/chat.spaces.create,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.spacesettings"
                   },
                   "methods": {
                     "CreateMessage": {
@@ -4622,6 +4623,95 @@
                       "options": {
                         "(google.api.field_behavior)": "REQUIRED"
                       }
+                    },
+                    "quoteType": {
+                      "type": "QuoteType",
+                      "id": 4,
+                      "options": {
+                        "(google.api.field_behavior)": "OPTIONAL"
+                      }
+                    },
+                    "quotedMessageSnapshot": {
+                      "type": "QuotedMessageSnapshot",
+                      "id": 5,
+                      "options": {
+                        "(google.api.field_behavior)": "OUTPUT_ONLY"
+                      }
+                    },
+                    "forwardedMetadata": {
+                      "type": "ForwardedMetadata",
+                      "id": 6,
+                      "options": {
+                        "(google.api.field_behavior)": "OUTPUT_ONLY"
+                      }
+                    }
+                  },
+                  "nested": {
+                    "QuoteType": {
+                      "values": {
+                        "QUOTE_TYPE_UNSPECIFIED": 0,
+                        "REPLY": 1
+                      }
+                    }
+                  }
+                },
+                "QuotedMessageSnapshot": {
+                  "fields": {
+                    "sender": {
+                      "type": "string",
+                      "id": 1,
+                      "options": {
+                        "(google.api.field_behavior)": "OUTPUT_ONLY"
+                      }
+                    },
+                    "text": {
+                      "type": "string",
+                      "id": 2,
+                      "options": {
+                        "(google.api.field_behavior)": "OUTPUT_ONLY"
+                      }
+                    },
+                    "formattedText": {
+                      "type": "string",
+                      "id": 3,
+                      "options": {
+                        "(google.api.field_behavior)": "OUTPUT_ONLY"
+                      }
+                    },
+                    "annotations": {
+                      "rule": "repeated",
+                      "type": "Annotation",
+                      "id": 4,
+                      "options": {
+                        "(google.api.field_behavior)": "OUTPUT_ONLY"
+                      }
+                    },
+                    "attachments": {
+                      "rule": "repeated",
+                      "type": "Attachment",
+                      "id": 5,
+                      "options": {
+                        "(google.api.field_behavior)": "OUTPUT_ONLY"
+                      }
+                    }
+                  }
+                },
+                "ForwardedMetadata": {
+                  "fields": {
+                    "space": {
+                      "type": "string",
+                      "id": 1,
+                      "options": {
+                        "(google.api.field_behavior)": "OUTPUT_ONLY",
+                        "(google.api.resource_reference).type": "chat.googleapis.com/Space"
+                      }
+                    },
+                    "spaceDisplayName": {
+                      "type": "string",
+                      "id": 2,
+                      "options": {
+                        "(google.api.field_behavior)": "OUTPUT_ONLY"
+                      }
                     }
                   }
                 },

package/build/src/v1/chat_service_client.d.ts

@@ -302,8 +302,18 @@ export declare class ChatServiceClient {
      *
      * - [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)
@@ -879,8 +889,10 @@ export declare class ChatServiceClient {
      *
      *   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
+     *   {@link protos.google.chat.v1.Space.SpaceDetails|`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`.
@@ -924,8 +936,7 @@ export declare class ChatServiceClient {
      *   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`
@@ -1765,22 +1776,36 @@ export declare class ChatServiceClient {
      * 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`
      *
-     * To get an event, the authenticated user must be a member of the space.
+     * - [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 caller must be a member of the space.
      *
      * For an example, see [Get details about an
      * event from a Google Chat
@@ -1888,21 +1913,34 @@ export declare class ChatServiceClient {
     updateSpaceNotificationSetting(request: protos.google.chat.v1.IUpdateSpaceNotificationSettingRequest, callback: Callback<protos.google.chat.v1.ISpaceNotificationSetting, protos.google.chat.v1.IUpdateSpaceNotificationSettingRequest | null | undefined, {} | null | undefined>): void;
     /**
     * 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)
     *
     * @param {Object} request
     *   The request object that will be sent.
@@ -2728,7 +2766,9 @@ export declare class ChatServiceClient {
     listSpacesAsync(request?: protos.google.chat.v1.IListSpacesRequest, options?: CallOptions): AsyncIterable<protos.google.chat.v1.ISpace>;
     /**
     * 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
@@ -2739,8 +2779,6 @@ export declare class ChatServiceClient {
     *   - `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`.
-    *
     * @param {Object} request
     *   The request object that will be sent.
     * @param {boolean} request.useAdminAccess
@@ -3584,22 +3622,36 @@ export declare class ChatServiceClient {
     * 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/src/v1/chat_service_client.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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.
@@ -290,6 +290,7 @@ class ChatServiceClient {
             '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',