@google-apps/chat 0.5.0 → 0.7.0

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

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import type * as gax from 'google-gax';
 import type { Callback, CallOptions, Descriptors, ClientOptions, PaginationCallback } from 'google-gax';
 import { Transform } from 'stream';
@@ -397,7 +396,7 @@ export declare class ChatServiceClient {
      *   The request object that will be sent.
      * @param {string} request.name
      *   Required. Resource name of the attachment, in the form
-     *   `spaces/* /messages/* /attachments/*`.
+     *   `spaces/{space}/messages/{message}/attachments/{attachment}`.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Promise} - The promise which resolves to an array.
@@ -464,7 +463,7 @@ export declare class ChatServiceClient {
      * @param {Object} request
      *   The request object that will be sent.
      * @param {string} request.name
-     *   Required. Resource name of the space, in the form "spaces/*".
+     *   Required. Resource name of the space, in the form `spaces/{space}`.
      *
      *   Format: `spaces/{space}`
      * @param {object} [options]
@@ -546,6 +545,17 @@ export declare class ChatServiceClient {
      * 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.
@@ -607,8 +617,8 @@ export declare class ChatServiceClient {
      *   Specifying an existing request ID from the same Chat app with a different
      *   authenticated user returns an error.
      * @param {number[]} [request.memberships]
-     *   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).
      *
@@ -621,6 +631,10 @@ export declare class ChatServiceClient {
      *   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`.
      *
      *   Required when setting `Space.spaceType` to `GROUP_CHAT`, along with at
@@ -688,6 +702,7 @@ export declare class ChatServiceClient {
      *   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`
      *
@@ -696,12 +711,27 @@ export declare class ChatServiceClient {
      *   allows users to change their history
      *   setting](https://support.google.com/a/answer/7664184).
      *   Warning: mutually exclusive with all other field paths.)
-     *
-     *   - 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.)
+     *   `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: 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.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Promise} - The promise which resolves to an array.
@@ -845,7 +875,8 @@ export declare class ChatServiceClient {
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
      *
      * To specify the member to add, set the `membership.member.name` for the
-     * human or app member.
+     * 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
@@ -859,6 +890,15 @@ export declare class ChatServiceClient {
      * 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.
+     *
      * @param {Object} request
      *   The request object that will be sent.
      * @param {string} request.parent
@@ -1180,6 +1220,44 @@ export declare class ChatServiceClient {
     ]>;
     getThreadReadState(request: protos.google.chat.v1.IGetThreadReadStateRequest, options: CallOptions, callback: Callback<protos.google.chat.v1.IThreadReadState, protos.google.chat.v1.IGetThreadReadStateRequest | null | undefined, {} | null | undefined>): void;
     getThreadReadState(request: protos.google.chat.v1.IGetThreadReadStateRequest, callback: Callback<protos.google.chat.v1.IThreadReadState, protos.google.chat.v1.IGetThreadReadStateRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * Returns an event from a Google Chat space. The [event
+     * payload](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.oneof_payload)
+     * contains the most recent version of the resource that changed. For example,
+     * if you request an event about a new message but the message was later
+     * updated, the server returns the updated `Message` resource in the event
+     * payload.
+     *
+     * Requires [user
+     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+     * To get an event, the authenticated user must be a member of the space.
+     *
+     * For an example, see [Get details about an
+     * event from a Google Chat
+     * space](https://developers.google.com/workspace/chat/get-space-event).
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   Required. The resource name of the space event.
+     *
+     *   Format: `spaces/{space}/spaceEvents/{spaceEvent}`
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Promise} - The promise which resolves to an array.
+     *   The first element of the array is an object representing {@link protos.google.chat.v1.SpaceEvent|SpaceEvent}.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
+     *   for more details and examples.
+     * @example <caption>include:samples/generated/v1/chat_service.get_space_event.js</caption>
+     * region_tag:chat_v1_generated_ChatService_GetSpaceEvent_async
+     */
+    getSpaceEvent(request?: protos.google.chat.v1.IGetSpaceEventRequest, options?: CallOptions): Promise<[
+        protos.google.chat.v1.ISpaceEvent,
+        protos.google.chat.v1.IGetSpaceEventRequest | undefined,
+        {} | undefined
+    ]>;
+    getSpaceEvent(request: protos.google.chat.v1.IGetSpaceEventRequest, options: CallOptions, callback: Callback<protos.google.chat.v1.ISpaceEvent, protos.google.chat.v1.IGetSpaceEventRequest | null | undefined, {} | null | undefined>): void;
+    getSpaceEvent(request: protos.google.chat.v1.IGetSpaceEventRequest, callback: Callback<protos.google.chat.v1.ISpaceEvent, protos.google.chat.v1.IGetSpaceEventRequest | null | undefined, {} | null | undefined>): void;
     /**
      * Lists messages in a space that the caller is a member of, including
      * messages from blocked members and spaces. For an example, see
@@ -1523,16 +1601,23 @@ export declare class ChatServiceClient {
      *
      *   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:
@@ -1542,7 +1627,6 @@ export declare class ChatServiceClient {
      *   role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"
      *   ```
      *
-     *
      *   Invalid queries are rejected by the server with an `INVALID_ARGUMENT`
      *   error.
      * @param {boolean} [request.showGroups]
@@ -1617,16 +1701,23 @@ export declare class ChatServiceClient {
      *
      *   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:
@@ -1636,7 +1727,6 @@ export declare class ChatServiceClient {
      *   role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"
      *   ```
      *
-     *
      *   Invalid queries are rejected by the server with an `INVALID_ARGUMENT`
      *   error.
      * @param {boolean} [request.showGroups]
@@ -1706,16 +1796,23 @@ export declare class ChatServiceClient {
      *
      *   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:
@@ -1725,7 +1822,6 @@ export declare class ChatServiceClient {
      *   role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"
      *   ```
      *
-     *
      *   Invalid queries are rejected by the server with an `INVALID_ARGUMENT`
      *   error.
      * @param {boolean} [request.showGroups]
@@ -1775,6 +1871,9 @@ export declare class ChatServiceClient {
      * 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.
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -2186,6 +2285,291 @@ export declare class ChatServiceClient {
      * region_tag:chat_v1_generated_ChatService_ListReactions_async
      */
     listReactionsAsync(request?: protos.google.chat.v1.IListReactionsRequest, options?: CallOptions): AsyncIterable<protos.google.chat.v1.IReaction>;
+    /**
+     * Lists events from a Google Chat space. For each event, the
+     * [payload](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.oneof_payload)
+     * contains the most recent version of the Chat resource. For example, if you
+     * list events about new space members, the server returns `Membership`
+     * resources that contain the latest membership details. If new members were
+     * 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).
+     * To list events, the authenticated user 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).
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.parent
+     *   Required. Resource name of the [Google Chat
+     *   space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces)
+     *   where the events occurred.
+     *
+     *   Format: `spaces/{space}`.
+     * @param {number} request.pageSize
+     *   Optional. The maximum number of space events returned. The service might
+     *   return fewer than this value.
+     *
+     *   Negative values return an `INVALID_ARGUMENT` error.
+     * @param {string} request.pageToken
+     *   A page token, received from a previous list space events call. Provide this
+     *   to retrieve the subsequent page.
+     *
+     *   When paginating, all other parameters provided to list space events must
+     *   match the call that provided the page token. Passing different values to
+     *   the other parameters might lead to unexpected results.
+     * @param {string} request.filter
+     *   Required. A query filter.
+     *
+     *   You must specify at least one event type (`event_type`)
+     *   using the has `:` operator. To filter by multiple event types, use the `OR`
+     *   operator. Omit batch event types in your filter. The request automatically
+     *   returns any related batch events. For example, if you filter by new
+     *   reactions
+     *   (`google.workspace.chat.reaction.v1.created`), the server also returns
+     *   batch new reactions events
+     *   (`google.workspace.chat.reaction.v1.batchCreated`). For a list of supported
+     *   event types, see the [`SpaceEvents` reference
+     *   documentation](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.event_type).
+     *
+     *   Optionally, you can also filter by start time (`start_time`) and
+     *   end time (`end_time`):
+     *
+     *   * `start_time`: Exclusive timestamp from which to start listing space
+     *   events.
+     *    You can list events that occurred up to 28 days ago. If unspecified, lists
+     *    space events from the past 28 days.
+     *   * `end_time`: Inclusive timestamp until which space events are listed.
+     *    If unspecified, lists events up to the time of the request.
+     *
+     *   To specify a start or end time, use the equals `=` operator and format in
+     *   [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339). To filter by both
+     *   `start_time` and `end_time`, use the `AND` operator.
+     *
+     *   For example, the following queries are valid:
+     *
+     *   ```
+     *   start_time="2023-08-23T19:20:33+00:00" AND
+     *   end_time="2023-08-23T19:21:54+00:00"
+     *   ```
+     *   ```
+     *   start_time="2023-08-23T19:20:33+00:00" AND
+     *   (event_types:"google.workspace.chat.space.v1.updated" OR
+     *   event_types:"google.workspace.chat.message.v1.created")
+     *   ```
+     *
+     *   The following queries are invalid:
+     *
+     *   ```
+     *   start_time="2023-08-23T19:20:33+00:00" OR
+     *   end_time="2023-08-23T19:21:54+00:00"
+     *   ```
+     *   ```
+     *   event_types:"google.workspace.chat.space.v1.updated" AND
+     *   event_types:"google.workspace.chat.message.v1.created"
+     *   ```
+     *
+     *   Invalid queries are rejected by the server with an `INVALID_ARGUMENT`
+     *   error.
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Promise} - The promise which resolves to an array.
+     *   The first element of the array is Array of {@link protos.google.chat.v1.SpaceEvent|SpaceEvent}.
+     *   The client library will perform auto-pagination by default: it will call the API as many
+     *   times as needed and will merge results from all the pages into this array.
+     *   Note that it can affect your quota.
+     *   We recommend using `listSpaceEventsAsync()`
+     *   method described below for async iteration which you can stop as needed.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
+     *   for more details and examples.
+     */
+    listSpaceEvents(request?: protos.google.chat.v1.IListSpaceEventsRequest, options?: CallOptions): Promise<[
+        protos.google.chat.v1.ISpaceEvent[],
+        protos.google.chat.v1.IListSpaceEventsRequest | null,
+        protos.google.chat.v1.IListSpaceEventsResponse
+    ]>;
+    listSpaceEvents(request: protos.google.chat.v1.IListSpaceEventsRequest, options: CallOptions, callback: PaginationCallback<protos.google.chat.v1.IListSpaceEventsRequest, protos.google.chat.v1.IListSpaceEventsResponse | null | undefined, protos.google.chat.v1.ISpaceEvent>): void;
+    listSpaceEvents(request: protos.google.chat.v1.IListSpaceEventsRequest, callback: PaginationCallback<protos.google.chat.v1.IListSpaceEventsRequest, protos.google.chat.v1.IListSpaceEventsResponse | null | undefined, protos.google.chat.v1.ISpaceEvent>): void;
+    /**
+     * Equivalent to `method.name.toCamelCase()`, but returns a NodeJS Stream object.
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.parent
+     *   Required. Resource name of the [Google Chat
+     *   space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces)
+     *   where the events occurred.
+     *
+     *   Format: `spaces/{space}`.
+     * @param {number} request.pageSize
+     *   Optional. The maximum number of space events returned. The service might
+     *   return fewer than this value.
+     *
+     *   Negative values return an `INVALID_ARGUMENT` error.
+     * @param {string} request.pageToken
+     *   A page token, received from a previous list space events call. Provide this
+     *   to retrieve the subsequent page.
+     *
+     *   When paginating, all other parameters provided to list space events must
+     *   match the call that provided the page token. Passing different values to
+     *   the other parameters might lead to unexpected results.
+     * @param {string} request.filter
+     *   Required. A query filter.
+     *
+     *   You must specify at least one event type (`event_type`)
+     *   using the has `:` operator. To filter by multiple event types, use the `OR`
+     *   operator. Omit batch event types in your filter. The request automatically
+     *   returns any related batch events. For example, if you filter by new
+     *   reactions
+     *   (`google.workspace.chat.reaction.v1.created`), the server also returns
+     *   batch new reactions events
+     *   (`google.workspace.chat.reaction.v1.batchCreated`). For a list of supported
+     *   event types, see the [`SpaceEvents` reference
+     *   documentation](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.event_type).
+     *
+     *   Optionally, you can also filter by start time (`start_time`) and
+     *   end time (`end_time`):
+     *
+     *   * `start_time`: Exclusive timestamp from which to start listing space
+     *   events.
+     *    You can list events that occurred up to 28 days ago. If unspecified, lists
+     *    space events from the past 28 days.
+     *   * `end_time`: Inclusive timestamp until which space events are listed.
+     *    If unspecified, lists events up to the time of the request.
+     *
+     *   To specify a start or end time, use the equals `=` operator and format in
+     *   [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339). To filter by both
+     *   `start_time` and `end_time`, use the `AND` operator.
+     *
+     *   For example, the following queries are valid:
+     *
+     *   ```
+     *   start_time="2023-08-23T19:20:33+00:00" AND
+     *   end_time="2023-08-23T19:21:54+00:00"
+     *   ```
+     *   ```
+     *   start_time="2023-08-23T19:20:33+00:00" AND
+     *   (event_types:"google.workspace.chat.space.v1.updated" OR
+     *   event_types:"google.workspace.chat.message.v1.created")
+     *   ```
+     *
+     *   The following queries are invalid:
+     *
+     *   ```
+     *   start_time="2023-08-23T19:20:33+00:00" OR
+     *   end_time="2023-08-23T19:21:54+00:00"
+     *   ```
+     *   ```
+     *   event_types:"google.workspace.chat.space.v1.updated" AND
+     *   event_types:"google.workspace.chat.message.v1.created"
+     *   ```
+     *
+     *   Invalid queries are rejected by the server with an `INVALID_ARGUMENT`
+     *   error.
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Stream}
+     *   An object stream which emits an object representing {@link protos.google.chat.v1.SpaceEvent|SpaceEvent} on 'data' event.
+     *   The client library will perform auto-pagination by default: it will call the API as many
+     *   times as needed. Note that it can affect your quota.
+     *   We recommend using `listSpaceEventsAsync()`
+     *   method described below for async iteration which you can stop as needed.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
+     *   for more details and examples.
+     */
+    listSpaceEventsStream(request?: protos.google.chat.v1.IListSpaceEventsRequest, options?: CallOptions): Transform;
+    /**
+     * Equivalent to `listSpaceEvents`, but returns an iterable object.
+     *
+     * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.parent
+     *   Required. Resource name of the [Google Chat
+     *   space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces)
+     *   where the events occurred.
+     *
+     *   Format: `spaces/{space}`.
+     * @param {number} request.pageSize
+     *   Optional. The maximum number of space events returned. The service might
+     *   return fewer than this value.
+     *
+     *   Negative values return an `INVALID_ARGUMENT` error.
+     * @param {string} request.pageToken
+     *   A page token, received from a previous list space events call. Provide this
+     *   to retrieve the subsequent page.
+     *
+     *   When paginating, all other parameters provided to list space events must
+     *   match the call that provided the page token. Passing different values to
+     *   the other parameters might lead to unexpected results.
+     * @param {string} request.filter
+     *   Required. A query filter.
+     *
+     *   You must specify at least one event type (`event_type`)
+     *   using the has `:` operator. To filter by multiple event types, use the `OR`
+     *   operator. Omit batch event types in your filter. The request automatically
+     *   returns any related batch events. For example, if you filter by new
+     *   reactions
+     *   (`google.workspace.chat.reaction.v1.created`), the server also returns
+     *   batch new reactions events
+     *   (`google.workspace.chat.reaction.v1.batchCreated`). For a list of supported
+     *   event types, see the [`SpaceEvents` reference
+     *   documentation](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.event_type).
+     *
+     *   Optionally, you can also filter by start time (`start_time`) and
+     *   end time (`end_time`):
+     *
+     *   * `start_time`: Exclusive timestamp from which to start listing space
+     *   events.
+     *    You can list events that occurred up to 28 days ago. If unspecified, lists
+     *    space events from the past 28 days.
+     *   * `end_time`: Inclusive timestamp until which space events are listed.
+     *    If unspecified, lists events up to the time of the request.
+     *
+     *   To specify a start or end time, use the equals `=` operator and format in
+     *   [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339). To filter by both
+     *   `start_time` and `end_time`, use the `AND` operator.
+     *
+     *   For example, the following queries are valid:
+     *
+     *   ```
+     *   start_time="2023-08-23T19:20:33+00:00" AND
+     *   end_time="2023-08-23T19:21:54+00:00"
+     *   ```
+     *   ```
+     *   start_time="2023-08-23T19:20:33+00:00" AND
+     *   (event_types:"google.workspace.chat.space.v1.updated" OR
+     *   event_types:"google.workspace.chat.message.v1.created")
+     *   ```
+     *
+     *   The following queries are invalid:
+     *
+     *   ```
+     *   start_time="2023-08-23T19:20:33+00:00" OR
+     *   end_time="2023-08-23T19:21:54+00:00"
+     *   ```
+     *   ```
+     *   event_types:"google.workspace.chat.space.v1.updated" AND
+     *   event_types:"google.workspace.chat.message.v1.created"
+     *   ```
+     *
+     *   Invalid queries are rejected by the server with an `INVALID_ARGUMENT`
+     *   error.
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Object}
+     *   An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
+     *   When you iterate the returned iterable, each element will be an object representing
+     *   {@link protos.google.chat.v1.SpaceEvent|SpaceEvent}. The API will be called under the hood as needed, once per the page,
+     *   so you can stop the iteration when you don't need more results.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
+     *   for more details and examples.
+     * @example <caption>include:samples/generated/v1/chat_service.list_space_events.js</caption>
+     * region_tag:chat_v1_generated_ChatService_ListSpaceEvents_async
+     */
+    listSpaceEventsAsync(request?: protos.google.chat.v1.IListSpaceEventsRequest, options?: CallOptions): AsyncIterable<protos.google.chat.v1.ISpaceEvent>;
     /**
      * Return a fully-qualified attachment resource name string.
      *
@@ -2348,6 +2732,30 @@ export declare class ChatServiceClient {
      * @returns {string} A string representing the space.
      */
     matchSpaceFromSpaceName(spaceName: string): string | number;
+    /**
+     * Return a fully-qualified spaceEvent resource name string.
+     *
+     * @param {string} space
+     * @param {string} space_event
+     * @returns {string} Resource name string.
+     */
+    spaceEventPath(space: string, spaceEvent: string): string;
+    /**
+     * Parse the space from SpaceEvent resource.
+     *
+     * @param {string} spaceEventName
+     *   A fully-qualified path representing SpaceEvent resource.
+     * @returns {string} A string representing the space.
+     */
+    matchSpaceFromSpaceEventName(spaceEventName: string): string | number;
+    /**
+     * Parse the space_event from SpaceEvent resource.
+     *
+     * @param {string} spaceEventName
+     *   A fully-qualified path representing SpaceEvent resource.
+     * @returns {string} A string representing the space_event.
+     */
+    matchSpaceEventFromSpaceEventName(spaceEventName: string): string | number;
     /**
      * Return a fully-qualified spaceReadState resource name string.
      *