@google-apps/chat 0.23.0 → 0.24.0

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

@@ -207,6 +207,10 @@ export declare class ChatServiceClient {
      *
      *   For details, see [Name a
      *   message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
+     * @param {google.chat.v1.CreateMessageNotificationOptions} [request.createMessageNotificationOptions]
+     *   Optional. Controls the notification behavior when the message is posted.
+     *   To learn more, see [Force notifications or send silent
+     *   messages](https://developer.google.com/workspace/chat/create-messages#force-notify-silent).
      * @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.
@@ -310,8 +314,7 @@ export declare class ChatServiceClient {
      *     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.
      *
@@ -1786,12 +1789,13 @@ export declare class ChatServiceClient {
      * - [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)
@@ -1911,6 +1915,201 @@ export declare class ChatServiceClient {
     ]>;
     updateSpaceNotificationSetting(request: protos.google.chat.v1.IUpdateSpaceNotificationSettingRequest, options: CallOptions, callback: Callback<protos.google.chat.v1.ISpaceNotificationSetting, protos.google.chat.v1.IUpdateSpaceNotificationSettingRequest | null | undefined, {} | null | undefined>): void;
     updateSpaceNotificationSetting(request: protos.google.chat.v1.IUpdateSpaceNotificationSettingRequest, callback: Callback<protos.google.chat.v1.ISpaceNotificationSetting, protos.google.chat.v1.IUpdateSpaceNotificationSettingRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * 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`
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.parent
+     *   Required. The parent resource name where the section is created.
+     *
+     *   Format: `users/{user}`
+     * @param {google.chat.v1.Section} request.section
+     *   Required. The section to create.
+     * @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.Section|Section}.
+     *   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.create_section.js</caption>
+     * region_tag:chat_v1_generated_ChatService_CreateSection_async
+     */
+    createSection(request?: protos.google.chat.v1.ICreateSectionRequest, options?: CallOptions): Promise<[
+        protos.google.chat.v1.ISection,
+        protos.google.chat.v1.ICreateSectionRequest | undefined,
+        {} | undefined
+    ]>;
+    createSection(request: protos.google.chat.v1.ICreateSectionRequest, options: CallOptions, callback: Callback<protos.google.chat.v1.ISection, protos.google.chat.v1.ICreateSectionRequest | null | undefined, {} | null | undefined>): void;
+    createSection(request: protos.google.chat.v1.ICreateSectionRequest, callback: Callback<protos.google.chat.v1.ISection, protos.google.chat.v1.ICreateSectionRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * 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`
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   Required. The name of the section to delete.
+     *
+     *   Format: `users/{user}/sections/{section}`
+     * @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.protobuf.Empty|Empty}.
+     *   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.delete_section.js</caption>
+     * region_tag:chat_v1_generated_ChatService_DeleteSection_async
+     */
+    deleteSection(request?: protos.google.chat.v1.IDeleteSectionRequest, options?: CallOptions): Promise<[
+        protos.google.protobuf.IEmpty,
+        protos.google.chat.v1.IDeleteSectionRequest | undefined,
+        {} | undefined
+    ]>;
+    deleteSection(request: protos.google.chat.v1.IDeleteSectionRequest, options: CallOptions, callback: Callback<protos.google.protobuf.IEmpty, protos.google.chat.v1.IDeleteSectionRequest | null | undefined, {} | null | undefined>): void;
+    deleteSection(request: protos.google.chat.v1.IDeleteSectionRequest, callback: Callback<protos.google.protobuf.IEmpty, protos.google.chat.v1.IDeleteSectionRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * 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`
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {google.chat.v1.Section} request.section
+     *   Required. The section to update.
+     * @param {google.protobuf.FieldMask} request.updateMask
+     *   Required. The mask to specify which fields to update.
+     *
+     *   Currently supported field paths:
+     *
+     *   - `display_name`
+     * @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.Section|Section}.
+     *   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.update_section.js</caption>
+     * region_tag:chat_v1_generated_ChatService_UpdateSection_async
+     */
+    updateSection(request?: protos.google.chat.v1.IUpdateSectionRequest, options?: CallOptions): Promise<[
+        protos.google.chat.v1.ISection,
+        protos.google.chat.v1.IUpdateSectionRequest | undefined,
+        {} | undefined
+    ]>;
+    updateSection(request: protos.google.chat.v1.IUpdateSectionRequest, options: CallOptions, callback: Callback<protos.google.chat.v1.ISection, protos.google.chat.v1.IUpdateSectionRequest | null | undefined, {} | null | undefined>): void;
+    updateSection(request: protos.google.chat.v1.IUpdateSectionRequest, callback: Callback<protos.google.chat.v1.ISection, protos.google.chat.v1.IUpdateSectionRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * 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`
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   Required. The resource name of the section to position.
+     *
+     *   Format: `users/{user}/sections/{section}`
+     * @param {number} [request.sortOrder]
+     *   Optional. The absolute position of the section in the list of sections.
+     *   The position must be greater than 0. If the position is greater than the
+     *   number of sections, the section will be appended to the end of the list.
+     *   This operation inserts the section at the given position and shifts the
+     *   original section at that position, and those below it, to the next
+     *   position.
+     * @param {google.chat.v1.PositionSectionRequest.Position} [request.relativePosition]
+     *   Optional. The relative position of the section in the list of sections.
+     * @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.PositionSectionResponse|PositionSectionResponse}.
+     *   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.position_section.js</caption>
+     * region_tag:chat_v1_generated_ChatService_PositionSection_async
+     */
+    positionSection(request?: protos.google.chat.v1.IPositionSectionRequest, options?: CallOptions): Promise<[
+        protos.google.chat.v1.IPositionSectionResponse,
+        protos.google.chat.v1.IPositionSectionRequest | undefined,
+        {} | undefined
+    ]>;
+    positionSection(request: protos.google.chat.v1.IPositionSectionRequest, options: CallOptions, callback: Callback<protos.google.chat.v1.IPositionSectionResponse, protos.google.chat.v1.IPositionSectionRequest | null | undefined, {} | null | undefined>): void;
+    positionSection(request: protos.google.chat.v1.IPositionSectionRequest, callback: Callback<protos.google.chat.v1.IPositionSectionResponse, protos.google.chat.v1.IPositionSectionRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * 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`
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   Required. The resource name of the section item to move.
+     *
+     *   Format: `users/{user}/sections/{section}/items/{item}`
+     * @param {string} request.targetSection
+     *   Required. The resource name of the section to move the section item to.
+     *
+     *   Format: `users/{user}/sections/{section}`
+     * @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.MoveSectionItemResponse|MoveSectionItemResponse}.
+     *   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.move_section_item.js</caption>
+     * region_tag:chat_v1_generated_ChatService_MoveSectionItem_async
+     */
+    moveSectionItem(request?: protos.google.chat.v1.IMoveSectionItemRequest, options?: CallOptions): Promise<[
+        protos.google.chat.v1.IMoveSectionItemResponse,
+        protos.google.chat.v1.IMoveSectionItemRequest | undefined,
+        {} | undefined
+    ]>;
+    moveSectionItem(request: protos.google.chat.v1.IMoveSectionItemRequest, options: CallOptions, callback: Callback<protos.google.chat.v1.IMoveSectionItemResponse, protos.google.chat.v1.IMoveSectionItemRequest | null | undefined, {} | null | undefined>): void;
+    moveSectionItem(request: protos.google.chat.v1.IMoveSectionItemRequest, callback: Callback<protos.google.chat.v1.IMoveSectionItemResponse, protos.google.chat.v1.IMoveSectionItemRequest | null | undefined, {} | null | undefined>): void;
     /**
     * Lists messages in a space that the caller is a member of, including
     * messages from blocked members and spaces. System messages, like those
@@ -1927,9 +2126,8 @@ export declare class ChatServiceClient {
     * - [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.
@@ -3205,6 +3403,207 @@ export declare class ChatServiceClient {
      */
     searchSpacesAsync(request?: protos.google.chat.v1.ISearchSpacesRequest, options?: CallOptions): AsyncIterable<protos.google.chat.v1.ISpace>;
     /**
+    * Returns all spaces with `spaceType == GROUP_CHAT`, whose
+    * human memberships contain exactly the calling user, and the users specified
+    * in `FindGroupChatsRequest.users`. Only members that have joined the
+    * conversation are supported. For an example, see [Find group
+    * chats](https://developers.google.com/workspace/chat/find-group-chats).
+    *
+    * If the calling user blocks, or is blocked by, some users, and no spaces
+    * with the entire specified set of users are found, this method returns
+    * spaces that don't include the blocked or blocking users.
+    *
+    * The specified set of users must contain only human (non-app) memberships.
+    * A request that contains non-human users doesn't return any spaces.
+    *
+    * Requires [user
+    * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+    * with one of the following [authorization
+    * scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+    *
+    *   - `https://www.googleapis.com/auth/chat.memberships.readonly`
+    *   - `https://www.googleapis.com/auth/chat.memberships`
+    *
+    * @param {Object} request
+    *   The request object that will be sent.
+    * @param {string[]} [request.users]
+    *   Optional. Resource names of all human users in group chat with the calling
+    *   user. Chat apps can't be included in the request.
+    *
+    *   The maximum number of users that can be specified in a single request is
+    *   `49`.
+    *
+    *   Format: `users/{user}`, where `{user}` is either the `id` for the
+    *   [person](https://developers.google.com/people/api/rest/v1/people) from the
+    *   People API, or the `id` for the
+    *   [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users)
+    *   in the Directory API. For example, to find all group chats with the calling
+    *   user and two other users, with People API profile IDs `123456789` and
+    *   `987654321`, you can use `users/123456789` and `users/987654321`.
+    *   You can also use the email as an alias for `{user}`. For example,
+    *   `users/example@gmail.com` where `example@gmail.com` is the email of the
+    *   Google Chat user.
+    * @param {number} [request.pageSize]
+    *   Optional. The maximum number of spaces to return. The service might return
+    *   fewer than this value.
+    *
+    *   If unspecified, at most 10 spaces are returned.
+    *
+    *   The maximum value is 30. If you use a value more than 30, it's
+    *   automatically changed to 30.
+    *
+    *   Negative values return an `INVALID_ARGUMENT` error.
+    * @param {string} [request.pageToken]
+    *   Optional. A page token, received from a previous call to find group chats.
+    *   Provide this parameter to retrieve the subsequent page.
+    *
+    *   When paginating, all other parameters provided should match the call that
+    *   provided the token. Passing different values may lead to unexpected
+    *   results.
+    * @param {google.chat.v1.SpaceView} request.spaceView
+    *   Requested space view type. If unset, defaults to
+    *   `SPACE_VIEW_RESOURCE_NAME_ONLY`. Requests that specify
+    *   `SPACE_VIEW_EXPANDED` must include scopes that allow reading space data,
+    *   for example,
+    *   https://www.googleapis.com/auth/chat.spaces or
+    *   https://www.googleapis.com/auth/chat.spaces.readonly.
+    * @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.Space|Space}.
+    *   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 `findGroupChatsAsync()`
+    *   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.
+    */
+    findGroupChats(request?: protos.google.chat.v1.IFindGroupChatsRequest, options?: CallOptions): Promise<[
+        protos.google.chat.v1.ISpace[],
+        protos.google.chat.v1.IFindGroupChatsRequest | null,
+        protos.google.chat.v1.IFindGroupChatsResponse
+    ]>;
+    findGroupChats(request: protos.google.chat.v1.IFindGroupChatsRequest, options: CallOptions, callback: PaginationCallback<protos.google.chat.v1.IFindGroupChatsRequest, protos.google.chat.v1.IFindGroupChatsResponse | null | undefined, protos.google.chat.v1.ISpace>): void;
+    findGroupChats(request: protos.google.chat.v1.IFindGroupChatsRequest, callback: PaginationCallback<protos.google.chat.v1.IFindGroupChatsRequest, protos.google.chat.v1.IFindGroupChatsResponse | null | undefined, protos.google.chat.v1.ISpace>): void;
+    /**
+     * Equivalent to `findGroupChats`, but returns a NodeJS Stream object.
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string[]} [request.users]
+     *   Optional. Resource names of all human users in group chat with the calling
+     *   user. Chat apps can't be included in the request.
+     *
+     *   The maximum number of users that can be specified in a single request is
+     *   `49`.
+     *
+     *   Format: `users/{user}`, where `{user}` is either the `id` for the
+     *   [person](https://developers.google.com/people/api/rest/v1/people) from the
+     *   People API, or the `id` for the
+     *   [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users)
+     *   in the Directory API. For example, to find all group chats with the calling
+     *   user and two other users, with People API profile IDs `123456789` and
+     *   `987654321`, you can use `users/123456789` and `users/987654321`.
+     *   You can also use the email as an alias for `{user}`. For example,
+     *   `users/example@gmail.com` where `example@gmail.com` is the email of the
+     *   Google Chat user.
+     * @param {number} [request.pageSize]
+     *   Optional. The maximum number of spaces to return. The service might return
+     *   fewer than this value.
+     *
+     *   If unspecified, at most 10 spaces are returned.
+     *
+     *   The maximum value is 30. If you use a value more than 30, it's
+     *   automatically changed to 30.
+     *
+     *   Negative values return an `INVALID_ARGUMENT` error.
+     * @param {string} [request.pageToken]
+     *   Optional. A page token, received from a previous call to find group chats.
+     *   Provide this parameter to retrieve the subsequent page.
+     *
+     *   When paginating, all other parameters provided should match the call that
+     *   provided the token. Passing different values may lead to unexpected
+     *   results.
+     * @param {google.chat.v1.SpaceView} request.spaceView
+     *   Requested space view type. If unset, defaults to
+     *   `SPACE_VIEW_RESOURCE_NAME_ONLY`. Requests that specify
+     *   `SPACE_VIEW_EXPANDED` must include scopes that allow reading space data,
+     *   for example,
+     *   https://www.googleapis.com/auth/chat.spaces or
+     *   https://www.googleapis.com/auth/chat.spaces.readonly.
+     * @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.Space|Space} 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 `findGroupChatsAsync()`
+     *   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.
+     */
+    findGroupChatsStream(request?: protos.google.chat.v1.IFindGroupChatsRequest, options?: CallOptions): Transform;
+    /**
+     * Equivalent to `findGroupChats`, 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.users]
+     *   Optional. Resource names of all human users in group chat with the calling
+     *   user. Chat apps can't be included in the request.
+     *
+     *   The maximum number of users that can be specified in a single request is
+     *   `49`.
+     *
+     *   Format: `users/{user}`, where `{user}` is either the `id` for the
+     *   [person](https://developers.google.com/people/api/rest/v1/people) from the
+     *   People API, or the `id` for the
+     *   [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users)
+     *   in the Directory API. For example, to find all group chats with the calling
+     *   user and two other users, with People API profile IDs `123456789` and
+     *   `987654321`, you can use `users/123456789` and `users/987654321`.
+     *   You can also use the email as an alias for `{user}`. For example,
+     *   `users/example@gmail.com` where `example@gmail.com` is the email of the
+     *   Google Chat user.
+     * @param {number} [request.pageSize]
+     *   Optional. The maximum number of spaces to return. The service might return
+     *   fewer than this value.
+     *
+     *   If unspecified, at most 10 spaces are returned.
+     *
+     *   The maximum value is 30. If you use a value more than 30, it's
+     *   automatically changed to 30.
+     *
+     *   Negative values return an `INVALID_ARGUMENT` error.
+     * @param {string} [request.pageToken]
+     *   Optional. A page token, received from a previous call to find group chats.
+     *   Provide this parameter to retrieve the subsequent page.
+     *
+     *   When paginating, all other parameters provided should match the call that
+     *   provided the token. Passing different values may lead to unexpected
+     *   results.
+     * @param {google.chat.v1.SpaceView} request.spaceView
+     *   Requested space view type. If unset, defaults to
+     *   `SPACE_VIEW_RESOURCE_NAME_ONLY`. Requests that specify
+     *   `SPACE_VIEW_EXPANDED` must include scopes that allow reading space data,
+     *   for example,
+     *   https://www.googleapis.com/auth/chat.spaces or
+     *   https://www.googleapis.com/auth/chat.spaces.readonly.
+     * @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.Space|Space}. 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.find_group_chats.js</caption>
+     * region_tag:chat_v1_generated_ChatService_FindGroupChats_async
+     */
+    findGroupChatsAsync(request?: protos.google.chat.v1.IFindGroupChatsRequest, options?: CallOptions): AsyncIterable<protos.google.chat.v1.ISpace>;
+    /**
     * Lists reactions to a message. For an example, see
     * [List reactions for a
     * message](https://developers.google.com/workspace/chat/list-reactions).
@@ -3632,12 +4031,13 @@ export declare class ChatServiceClient {
     * - [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)
@@ -3925,6 +4325,335 @@ export declare class ChatServiceClient {
      * region_tag:chat_v1_generated_ChatService_ListSpaceEvents_async
      */
     listSpaceEventsAsync(request?: protos.google.chat.v1.IListSpaceEventsRequest, options?: CallOptions): AsyncIterable<protos.google.chat.v1.ISpaceEvent>;
+    /**
+    * 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`
+    *
+    * @param {Object} request
+    *   The request object that will be sent.
+    * @param {string} request.parent
+    *   Required. The parent, which is the user resource name that owns this
+    *   collection of sections. Only supports listing sections for the calling
+    *   user. To refer to the calling user, set one of the following:
+    *
+    *   - The `me` alias. For example, `users/me`.
+    *
+    *   - Their Workspace email address. For example, `users/user@example.com`.
+    *
+    *   - Their user id. For example, `users/123456789`.
+    *
+    *   Format: `users/{user}`
+    * @param {number} [request.pageSize]
+    *   Optional. The maximum number of sections to return. The service may return
+    *   fewer than this value.
+    *
+    *   If unspecified, at most 10 sections will be returned.
+    *
+    *   The maximum value is 100. If you use a value more than 100, it's
+    *   automatically changed to 100.
+    *
+    *   Negative values return an `INVALID_ARGUMENT` error.
+    * @param {string} [request.pageToken]
+    *   Optional. A page token, received from a previous list sections call.
+    *   Provide this to retrieve the subsequent page.
+    *
+    *   When paginating, all other parameters provided should match the call that
+    *   provided the page token. Passing different values to the other parameters
+    *   might lead to unexpected results.
+    * @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.Section|Section}.
+    *   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 `listSectionsAsync()`
+    *   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.
+    */
+    listSections(request?: protos.google.chat.v1.IListSectionsRequest, options?: CallOptions): Promise<[
+        protos.google.chat.v1.ISection[],
+        protos.google.chat.v1.IListSectionsRequest | null,
+        protos.google.chat.v1.IListSectionsResponse
+    ]>;
+    listSections(request: protos.google.chat.v1.IListSectionsRequest, options: CallOptions, callback: PaginationCallback<protos.google.chat.v1.IListSectionsRequest, protos.google.chat.v1.IListSectionsResponse | null | undefined, protos.google.chat.v1.ISection>): void;
+    listSections(request: protos.google.chat.v1.IListSectionsRequest, callback: PaginationCallback<protos.google.chat.v1.IListSectionsRequest, protos.google.chat.v1.IListSectionsResponse | null | undefined, protos.google.chat.v1.ISection>): void;
+    /**
+     * Equivalent to `listSections`, but returns a NodeJS Stream object.
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.parent
+     *   Required. The parent, which is the user resource name that owns this
+     *   collection of sections. Only supports listing sections for the calling
+     *   user. To refer to the calling user, set one of the following:
+     *
+     *   - The `me` alias. For example, `users/me`.
+     *
+     *   - Their Workspace email address. For example, `users/user@example.com`.
+     *
+     *   - Their user id. For example, `users/123456789`.
+     *
+     *   Format: `users/{user}`
+     * @param {number} [request.pageSize]
+     *   Optional. The maximum number of sections to return. The service may return
+     *   fewer than this value.
+     *
+     *   If unspecified, at most 10 sections will be returned.
+     *
+     *   The maximum value is 100. If you use a value more than 100, it's
+     *   automatically changed to 100.
+     *
+     *   Negative values return an `INVALID_ARGUMENT` error.
+     * @param {string} [request.pageToken]
+     *   Optional. A page token, received from a previous list sections call.
+     *   Provide this to retrieve the subsequent page.
+     *
+     *   When paginating, all other parameters provided should match the call that
+     *   provided the page token. Passing different values to the other parameters
+     *   might lead to unexpected results.
+     * @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.Section|Section} 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 `listSectionsAsync()`
+     *   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.
+     */
+    listSectionsStream(request?: protos.google.chat.v1.IListSectionsRequest, options?: CallOptions): Transform;
+    /**
+     * Equivalent to `listSections`, 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. The parent, which is the user resource name that owns this
+     *   collection of sections. Only supports listing sections for the calling
+     *   user. To refer to the calling user, set one of the following:
+     *
+     *   - The `me` alias. For example, `users/me`.
+     *
+     *   - Their Workspace email address. For example, `users/user@example.com`.
+     *
+     *   - Their user id. For example, `users/123456789`.
+     *
+     *   Format: `users/{user}`
+     * @param {number} [request.pageSize]
+     *   Optional. The maximum number of sections to return. The service may return
+     *   fewer than this value.
+     *
+     *   If unspecified, at most 10 sections will be returned.
+     *
+     *   The maximum value is 100. If you use a value more than 100, it's
+     *   automatically changed to 100.
+     *
+     *   Negative values return an `INVALID_ARGUMENT` error.
+     * @param {string} [request.pageToken]
+     *   Optional. A page token, received from a previous list sections call.
+     *   Provide this to retrieve the subsequent page.
+     *
+     *   When paginating, all other parameters provided should match the call that
+     *   provided the page token. Passing different values to the other parameters
+     *   might lead to unexpected results.
+     * @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.Section|Section}. 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_sections.js</caption>
+     * region_tag:chat_v1_generated_ChatService_ListSections_async
+     */
+    listSectionsAsync(request?: protos.google.chat.v1.IListSectionsRequest, options?: CallOptions): AsyncIterable<protos.google.chat.v1.ISection>;
+    /**
+    * 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`
+    *
+    * @param {Object} request
+    *   The request object that will be sent.
+    * @param {string} request.parent
+    *   Required. The parent, which is the section resource name that owns this
+    *   collection of section items. Only supports listing section items for the
+    *   calling user.
+    *
+    *   When you're filtering by space, use the wildcard `-` to search across all
+    *   sections. For example, `users/{user}/sections/-`.
+    *
+    *   Format: `users/{user}/sections/{section}`
+    * @param {number} [request.pageSize]
+    *   Optional. The maximum number of section items to return. The service may
+    *   return fewer than this value.
+    *
+    *   If unspecified, at most 10 section items will be returned.
+    *
+    *   The maximum value is 100. If you use a value more than 100, it's
+    *   automatically changed to 100.
+    *
+    *   Negative values return an `INVALID_ARGUMENT` error.
+    * @param {string} [request.pageToken]
+    *   Optional. A page token, received from a previous list section items call.
+    *   Provide this to retrieve the subsequent page.
+    *
+    *   When paginating, all other parameters provided should match the call that
+    *   provided the page token. Passing different values to the other parameters
+    *   might lead to unexpected results.
+    * @param {string} [request.filter]
+    *   Optional. A query filter.
+    *
+    *   Currently only supports filtering by space.
+    *
+    *   For example, `space = spaces/{space}`.
+    *
+    *   Invalid queries are rejected 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.SectionItem|SectionItem}.
+    *   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 `listSectionItemsAsync()`
+    *   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.
+    */
+    listSectionItems(request?: protos.google.chat.v1.IListSectionItemsRequest, options?: CallOptions): Promise<[
+        protos.google.chat.v1.ISectionItem[],
+        protos.google.chat.v1.IListSectionItemsRequest | null,
+        protos.google.chat.v1.IListSectionItemsResponse
+    ]>;
+    listSectionItems(request: protos.google.chat.v1.IListSectionItemsRequest, options: CallOptions, callback: PaginationCallback<protos.google.chat.v1.IListSectionItemsRequest, protos.google.chat.v1.IListSectionItemsResponse | null | undefined, protos.google.chat.v1.ISectionItem>): void;
+    listSectionItems(request: protos.google.chat.v1.IListSectionItemsRequest, callback: PaginationCallback<protos.google.chat.v1.IListSectionItemsRequest, protos.google.chat.v1.IListSectionItemsResponse | null | undefined, protos.google.chat.v1.ISectionItem>): void;
+    /**
+     * Equivalent to `listSectionItems`, but returns a NodeJS Stream object.
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.parent
+     *   Required. The parent, which is the section resource name that owns this
+     *   collection of section items. Only supports listing section items for the
+     *   calling user.
+     *
+     *   When you're filtering by space, use the wildcard `-` to search across all
+     *   sections. For example, `users/{user}/sections/-`.
+     *
+     *   Format: `users/{user}/sections/{section}`
+     * @param {number} [request.pageSize]
+     *   Optional. The maximum number of section items to return. The service may
+     *   return fewer than this value.
+     *
+     *   If unspecified, at most 10 section items will be returned.
+     *
+     *   The maximum value is 100. If you use a value more than 100, it's
+     *   automatically changed to 100.
+     *
+     *   Negative values return an `INVALID_ARGUMENT` error.
+     * @param {string} [request.pageToken]
+     *   Optional. A page token, received from a previous list section items call.
+     *   Provide this to retrieve the subsequent page.
+     *
+     *   When paginating, all other parameters provided should match the call that
+     *   provided the page token. Passing different values to the other parameters
+     *   might lead to unexpected results.
+     * @param {string} [request.filter]
+     *   Optional. A query filter.
+     *
+     *   Currently only supports filtering by space.
+     *
+     *   For example, `space = spaces/{space}`.
+     *
+     *   Invalid queries are rejected 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.SectionItem|SectionItem} 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 `listSectionItemsAsync()`
+     *   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.
+     */
+    listSectionItemsStream(request?: protos.google.chat.v1.IListSectionItemsRequest, options?: CallOptions): Transform;
+    /**
+     * Equivalent to `listSectionItems`, 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. The parent, which is the section resource name that owns this
+     *   collection of section items. Only supports listing section items for the
+     *   calling user.
+     *
+     *   When you're filtering by space, use the wildcard `-` to search across all
+     *   sections. For example, `users/{user}/sections/-`.
+     *
+     *   Format: `users/{user}/sections/{section}`
+     * @param {number} [request.pageSize]
+     *   Optional. The maximum number of section items to return. The service may
+     *   return fewer than this value.
+     *
+     *   If unspecified, at most 10 section items will be returned.
+     *
+     *   The maximum value is 100. If you use a value more than 100, it's
+     *   automatically changed to 100.
+     *
+     *   Negative values return an `INVALID_ARGUMENT` error.
+     * @param {string} [request.pageToken]
+     *   Optional. A page token, received from a previous list section items call.
+     *   Provide this to retrieve the subsequent page.
+     *
+     *   When paginating, all other parameters provided should match the call that
+     *   provided the page token. Passing different values to the other parameters
+     *   might lead to unexpected results.
+     * @param {string} [request.filter]
+     *   Optional. A query filter.
+     *
+     *   Currently only supports filtering by space.
+     *
+     *   For example, `space = spaces/{space}`.
+     *
+     *   Invalid queries are rejected 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.SectionItem|SectionItem}. 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_section_items.js</caption>
+     * region_tag:chat_v1_generated_ChatService_ListSectionItems_async
+     */
+    listSectionItemsAsync(request?: protos.google.chat.v1.IListSectionItemsRequest, options?: CallOptions): AsyncIterable<protos.google.chat.v1.ISectionItem>;
     /**
      * Return a fully-qualified attachment resource name string.
      *
@@ -4087,6 +4816,63 @@ export declare class ChatServiceClient {
      * @returns {string} A string representing the reaction.
      */
     matchReactionFromReactionName(reactionName: string): string | number;
+    /**
+     * Return a fully-qualified section resource name string.
+     *
+     * @param {string} user
+     * @param {string} section
+     * @returns {string} Resource name string.
+     */
+    sectionPath(user: string, section: string): string;
+    /**
+     * Parse the user from Section resource.
+     *
+     * @param {string} sectionName
+     *   A fully-qualified path representing Section resource.
+     * @returns {string} A string representing the user.
+     */
+    matchUserFromSectionName(sectionName: string): string | number;
+    /**
+     * Parse the section from Section resource.
+     *
+     * @param {string} sectionName
+     *   A fully-qualified path representing Section resource.
+     * @returns {string} A string representing the section.
+     */
+    matchSectionFromSectionName(sectionName: string): string | number;
+    /**
+     * Return a fully-qualified sectionItem resource name string.
+     *
+     * @param {string} user
+     * @param {string} section
+     * @param {string} item
+     * @returns {string} Resource name string.
+     */
+    sectionItemPath(user: string, section: string, item: string): string;
+    /**
+     * Parse the user from SectionItem resource.
+     *
+     * @param {string} sectionItemName
+     *   A fully-qualified path representing SectionItem resource.
+     * @returns {string} A string representing the user.
+     */
+    matchUserFromSectionItemName(sectionItemName: string): string | number;
+    /**
+     * Parse the section from SectionItem resource.
+     *
+     * @param {string} sectionItemName
+     *   A fully-qualified path representing SectionItem resource.
+     * @returns {string} A string representing the section.
+     */
+    matchSectionFromSectionItemName(sectionItemName: string): string | number;
+    /**
+     * Parse the item from SectionItem resource.
+     *
+     * @param {string} sectionItemName
+     *   A fully-qualified path representing SectionItem resource.
+     * @returns {string} A string representing the item.
+     */
+    matchItemFromSectionItemName(sectionItemName: string): string | number;
     /**
      * Return a fully-qualified space resource name string.
      *