@google-apps/chat 0.7.0 → 0.9.0

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

@@ -213,6 +213,19 @@ export declare class ChatServiceClient {
      *   you can use the user's email as an alias for `{member}`. For example,
      *   `spaces/{space}/members/example@gmail.com` where `example@gmail.com` is the
      *   email of the Google Chat user.
+     * @param {boolean} request.useAdminAccess
+     *   When `true`, the method runs using the user's Google Workspace
+     *   administrator privileges.
+     *
+     *   The calling user must be a Google Workspace administrator with the
+     *   [manage chat and spaces conversations
+     *   privilege](https://support.google.com/a/answer/13369245).
+     *
+     *   Requires the `chat.admin.memberships` or `chat.admin.memberships.readonly`
+     *   [OAuth 2.0
+     *   scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).
+     *
+     *   Getting app memberships in a space isn't supported when using 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.
@@ -466,6 +479,16 @@ export declare class ChatServiceClient {
      *   Required. Resource name of the space, in the form `spaces/{space}`.
      *
      *   Format: `spaces/{space}`
+     * @param {boolean} request.useAdminAccess
+     *   When `true`, the method runs using the user's Google Workspace
+     *   administrator privileges.
+     *
+     *   The calling user must be a Google Workspace administrator with the
+     *   [manage chat and spaces conversations
+     *   privilege](https://support.google.com/a/answer/13369245).
+     *
+     *   Requires the `chat.admin.spaces` or `chat.admin.spaces.readonly` [OAuth 2.0
+     *   scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).
      * @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.
@@ -732,6 +755,19 @@ export declare class ChatServiceClient {
      *   `permission_settings.reply_messages`
      *    (Warning: mutually exclusive with all other non-permission settings field
      *   paths). `permission_settings` is not supported with admin access.
+     * @param {boolean} request.useAdminAccess
+     *   When `true`, the method runs using the user's Google Workspace
+     *   administrator privileges.
+     *
+     *   The calling user must be a Google Workspace administrator with the
+     *   [manage chat and spaces conversations
+     *   privilege](https://support.google.com/a/answer/13369245).
+     *
+     *   Requires the `chat.admin.spaces` [OAuth 2.0
+     *   scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).
+     *
+     *   Some `FieldMask` values are not supported using admin access. For details,
+     *   see the description of `update_mask`.
      * @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.
@@ -764,6 +800,16 @@ export declare class ChatServiceClient {
      *   Required. Resource name of the space to delete.
      *
      *   Format: `spaces/{space}`
+     * @param {boolean} request.useAdminAccess
+     *   When `true`, the method runs using the user's Google Workspace
+     *   administrator privileges.
+     *
+     *   The calling user must be a Google Workspace administrator with the
+     *   [manage chat and spaces conversations
+     *   privilege](https://support.google.com/a/answer/13369245).
+     *
+     *   Requires the `chat.admin.delete` [OAuth 2.0
+     *   scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).
      * @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.
@@ -923,6 +969,20 @@ export declare class ChatServiceClient {
      *   `users/user@example.com` or `users/123456789`. When a Chat app creates a
      *   membership relation for itself, it must use the `chat.memberships.app`
      *   scope, set `user.type` to `BOT`, and set `user.name` to `users/app`.
+     * @param {boolean} request.useAdminAccess
+     *   When `true`, the method runs using the user's Google Workspace
+     *   administrator privileges.
+     *
+     *   The calling user must be a Google Workspace administrator with the
+     *   [manage chat and spaces conversations
+     *   privilege](https://support.google.com/a/answer/13369245).
+     *
+     *   Requires the `chat.admin.memberships` [OAuth 2.0
+     *   scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).
+     *
+     *   Creating app memberships or creating memberships for users outside the
+     *   administrator's Google Workspace organization isn't supported using 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.
@@ -958,6 +1018,16 @@ export declare class ChatServiceClient {
      *   Currently supported field paths:
      *
      *   - `role`
+     * @param {boolean} request.useAdminAccess
+     *   When `true`, the method runs using the user's Google Workspace
+     *   administrator privileges.
+     *
+     *   The calling user must be a Google Workspace administrator with the
+     *   [manage chat and spaces conversations
+     *   privilege](https://support.google.com/a/answer/13369245).
+     *
+     *   Requires the `chat.admin.memberships` [OAuth 2.0
+     *   scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).
      * @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.
@@ -999,6 +1069,18 @@ export declare class ChatServiceClient {
      *   and `spaces/{space}/members/app` format.
      *
      *   Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`.
+     * @param {boolean} request.useAdminAccess
+     *   When `true`, the method runs using the user's Google Workspace
+     *   administrator privileges.
+     *
+     *   The calling user must be a Google Workspace administrator with the
+     *   [manage chat and spaces conversations
+     *   privilege](https://support.google.com/a/answer/13369245).
+     *
+     *   Requires the `chat.admin.memberships` [OAuth 2.0
+     *   scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).
+     *
+     *   Deleting app memberships in a space isn't supported using 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.
@@ -1601,8 +1683,8 @@ 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`. Developer
-     *   Preview: You can also filter for `member.type` using the `!=` operator.
+     *   To filter by type, set `member.type` to `HUMAN` or `BOT`. 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.
@@ -1646,6 +1728,19 @@ export declare class ChatServiceClient {
      *
      *   Currently requires [user
      *   authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+     * @param {boolean} request.useAdminAccess
+     *   When `true`, the method runs using the user's Google Workspace
+     *   administrator privileges.
+     *
+     *   The calling user must be a Google Workspace administrator with the
+     *   [manage chat and spaces conversations
+     *   privilege](https://support.google.com/a/answer/13369245).
+     *
+     *   Requires either the `chat.admin.memberships.readonly` or
+     *   `chat.admin.memberships` [OAuth 2.0
+     *   scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).
+     *
+     *   Listing app memberships in a space isn't supported when using 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.
@@ -1701,8 +1796,8 @@ 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`. Developer
-     *   Preview: You can also filter for `member.type` using the `!=` operator.
+     *   To filter by type, set `member.type` to `HUMAN` or `BOT`. 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.
@@ -1746,6 +1841,19 @@ export declare class ChatServiceClient {
      *
      *   Currently requires [user
      *   authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+     * @param {boolean} request.useAdminAccess
+     *   When `true`, the method runs using the user's Google Workspace
+     *   administrator privileges.
+     *
+     *   The calling user must be a Google Workspace administrator with the
+     *   [manage chat and spaces conversations
+     *   privilege](https://support.google.com/a/answer/13369245).
+     *
+     *   Requires either the `chat.admin.memberships.readonly` or
+     *   `chat.admin.memberships` [OAuth 2.0
+     *   scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).
+     *
+     *   Listing app memberships in a space isn't supported when using admin access.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Stream}
@@ -1796,8 +1904,8 @@ 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`. Developer
-     *   Preview: You can also filter for `member.type` using the `!=` operator.
+     *   To filter by type, set `member.type` to `HUMAN` or `BOT`. 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.
@@ -1841,6 +1949,19 @@ export declare class ChatServiceClient {
      *
      *   Currently requires [user
      *   authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+     * @param {boolean} request.useAdminAccess
+     *   When `true`, the method runs using the user's Google Workspace
+     *   administrator privileges.
+     *
+     *   The calling user must be a Google Workspace administrator with the
+     *   [manage chat and spaces conversations
+     *   privilege](https://support.google.com/a/answer/13369245).
+     *
+     *   Requires either the `chat.admin.memberships.readonly` or
+     *   `chat.admin.memberships` [OAuth 2.0
+     *   scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).
+     *
+     *   Listing app memberships in a space isn't supported when using admin access.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Object}
@@ -2039,6 +2160,438 @@ export declare class ChatServiceClient {
      * region_tag:chat_v1_generated_ChatService_ListSpaces_async
      */
     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. Requires [user
+     * authentication with administrator
+     * privileges](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user#admin-privileges).
+     * In the request, set `use_admin_access` to `true`.
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {boolean} request.useAdminAccess
+     *   When `true`, the method runs using the user's Google Workspace
+     *   administrator privileges.
+     *
+     *   The calling user must be a Google Workspace administrator with the
+     *   [manage chat and spaces conversations
+     *   privilege](https://support.google.com/a/answer/13369245).
+     *
+     *   Requires either the `chat.admin.spaces.readonly` or `chat.admin.spaces`
+     *   [OAuth 2.0
+     *   scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).
+     *
+     *   This method currently only supports admin access, thus only `true` is
+     *   accepted for this field.
+     * @param {number} request.pageSize
+     *   The maximum number of spaces to return. The service may return fewer than
+     *   this value.
+     *
+     *   If unspecified, at most 100 spaces are returned.
+     *
+     *   The maximum value is 1000. If you use a value more than 1000, it's
+     *   automatically changed to 1000.
+     * @param {string} request.pageToken
+     *   A token, received from the previous search spaces call. Provide this
+     *   parameter 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.query
+     *   Required. A search query.
+     *
+     *   You can search by using the following parameters:
+     *
+     *   - `create_time`
+     *   - `customer`
+     *   - `display_name`
+     *   - `external_user_allowed`
+     *   - `last_active_time`
+     *   - `space_history_state`
+     *   - `space_type`
+     *
+     *   `create_time` and `last_active_time` accept a timestamp in
+     *   [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339) format and the supported
+     *   comparison operators are: `=`, `<`, `>`, `<=`, `>=`.
+     *
+     *   `customer` is required and is used to indicate which customer
+     *   to fetch spaces from. `customers/my_customer` is the only supported value.
+     *
+     *   `display_name` only accepts the `HAS` (`:`) operator. The text to
+     *   match is first tokenized into tokens and each token is prefix-matched
+     *   case-insensitively and independently as a substring anywhere in the space's
+     *   `display_name`. For example, `Fun Eve` matches `Fun event` or `The
+     *   evening was fun`, but not `notFun event` or `even`.
+     *
+     *   `external_user_allowed` accepts either `true` or `false`.
+     *
+     *   `space_history_state` only accepts values from the [`historyState`]
+     *   (https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces#Space.HistoryState)
+     *   field of a `space` resource.
+     *
+     *   `space_type` is required and the only valid value is `SPACE`.
+     *
+     *   Across different fields, only `AND` operators are supported. A valid
+     *   example is `space_type = "SPACE" AND display_name:"Hello"` and an invalid
+     *   example is `space_type = "SPACE" OR display_name:"Hello"`.
+     *
+     *   Among the same field,
+     *   `space_type` doesn't support `AND` or `OR` operators.
+     *   `display_name`, 'space_history_state', and 'external_user_allowed' only
+     *   support `OR` operators.
+     *   `last_active_time` and `create_time` support both `AND` and `OR` operators.
+     *   `AND` can only be used to represent an interval, such as `last_active_time
+     *   < "2022-01-01T00:00:00+00:00" AND last_active_time >
+     *   "2023-01-01T00:00:00+00:00"`.
+     *
+     *   The following example queries are valid:
+     *
+     *   ```
+     *   customer = "customers/my_customer" AND space_type = "SPACE"
+     *
+     *   customer = "customers/my_customer" AND space_type = "SPACE" AND
+     *   display_name:"Hello World"
+     *
+     *   customer = "customers/my_customer" AND space_type = "SPACE" AND
+     *   (last_active_time < "2020-01-01T00:00:00+00:00" OR last_active_time >
+     *   "2022-01-01T00:00:00+00:00")
+     *
+     *   customer = "customers/my_customer" AND space_type = "SPACE" AND
+     *   (display_name:"Hello World" OR display_name:"Fun event") AND
+     *   (last_active_time > "2020-01-01T00:00:00+00:00" AND last_active_time <
+     *   "2022-01-01T00:00:00+00:00")
+     *
+     *   customer = "customers/my_customer" AND space_type = "SPACE" AND
+     *   (create_time > "2019-01-01T00:00:00+00:00" AND create_time <
+     *   "2020-01-01T00:00:00+00:00") AND (external_user_allowed = "true") AND
+     *   (space_history_state = "HISTORY_ON" OR space_history_state = "HISTORY_OFF")
+     *   ```
+     * @param {string} [request.orderBy]
+     *   Optional. How the list of spaces is ordered.
+     *
+     *   Supported attributes to order by are:
+     *
+     *   - `membership_count.joined_direct_human_user_count` — Denotes the count of
+     *   human users that have directly joined a space.
+     *   - `last_active_time` — Denotes the time when last eligible item is added to
+     *   any topic of this space.
+     *   - `create_time` — Denotes the time of the space creation.
+     *
+     *   Valid ordering operation values are:
+     *
+     *   - `ASC` for ascending. Default value.
+     *
+     *   - `DESC` for descending.
+     *
+     *   The supported syntax are:
+     *
+     *   - `membership_count.joined_direct_human_user_count DESC`
+     *   - `membership_count.joined_direct_human_user_count ASC`
+     *   - `last_active_time DESC`
+     *   - `last_active_time ASC`
+     *   - `create_time DESC`
+     *   - `create_time ASC`
+     * @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 `searchSpacesAsync()`
+     *   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.
+     */
+    searchSpaces(request?: protos.google.chat.v1.ISearchSpacesRequest, options?: CallOptions): Promise<[
+        protos.google.chat.v1.ISpace[],
+        protos.google.chat.v1.ISearchSpacesRequest | null,
+        protos.google.chat.v1.ISearchSpacesResponse
+    ]>;
+    searchSpaces(request: protos.google.chat.v1.ISearchSpacesRequest, options: CallOptions, callback: PaginationCallback<protos.google.chat.v1.ISearchSpacesRequest, protos.google.chat.v1.ISearchSpacesResponse | null | undefined, protos.google.chat.v1.ISpace>): void;
+    searchSpaces(request: protos.google.chat.v1.ISearchSpacesRequest, callback: PaginationCallback<protos.google.chat.v1.ISearchSpacesRequest, protos.google.chat.v1.ISearchSpacesResponse | null | undefined, protos.google.chat.v1.ISpace>): void;
+    /**
+     * Equivalent to `method.name.toCamelCase()`, but returns a NodeJS Stream object.
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {boolean} request.useAdminAccess
+     *   When `true`, the method runs using the user's Google Workspace
+     *   administrator privileges.
+     *
+     *   The calling user must be a Google Workspace administrator with the
+     *   [manage chat and spaces conversations
+     *   privilege](https://support.google.com/a/answer/13369245).
+     *
+     *   Requires either the `chat.admin.spaces.readonly` or `chat.admin.spaces`
+     *   [OAuth 2.0
+     *   scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).
+     *
+     *   This method currently only supports admin access, thus only `true` is
+     *   accepted for this field.
+     * @param {number} request.pageSize
+     *   The maximum number of spaces to return. The service may return fewer than
+     *   this value.
+     *
+     *   If unspecified, at most 100 spaces are returned.
+     *
+     *   The maximum value is 1000. If you use a value more than 1000, it's
+     *   automatically changed to 1000.
+     * @param {string} request.pageToken
+     *   A token, received from the previous search spaces call. Provide this
+     *   parameter 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.query
+     *   Required. A search query.
+     *
+     *   You can search by using the following parameters:
+     *
+     *   - `create_time`
+     *   - `customer`
+     *   - `display_name`
+     *   - `external_user_allowed`
+     *   - `last_active_time`
+     *   - `space_history_state`
+     *   - `space_type`
+     *
+     *   `create_time` and `last_active_time` accept a timestamp in
+     *   [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339) format and the supported
+     *   comparison operators are: `=`, `<`, `>`, `<=`, `>=`.
+     *
+     *   `customer` is required and is used to indicate which customer
+     *   to fetch spaces from. `customers/my_customer` is the only supported value.
+     *
+     *   `display_name` only accepts the `HAS` (`:`) operator. The text to
+     *   match is first tokenized into tokens and each token is prefix-matched
+     *   case-insensitively and independently as a substring anywhere in the space's
+     *   `display_name`. For example, `Fun Eve` matches `Fun event` or `The
+     *   evening was fun`, but not `notFun event` or `even`.
+     *
+     *   `external_user_allowed` accepts either `true` or `false`.
+     *
+     *   `space_history_state` only accepts values from the [`historyState`]
+     *   (https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces#Space.HistoryState)
+     *   field of a `space` resource.
+     *
+     *   `space_type` is required and the only valid value is `SPACE`.
+     *
+     *   Across different fields, only `AND` operators are supported. A valid
+     *   example is `space_type = "SPACE" AND display_name:"Hello"` and an invalid
+     *   example is `space_type = "SPACE" OR display_name:"Hello"`.
+     *
+     *   Among the same field,
+     *   `space_type` doesn't support `AND` or `OR` operators.
+     *   `display_name`, 'space_history_state', and 'external_user_allowed' only
+     *   support `OR` operators.
+     *   `last_active_time` and `create_time` support both `AND` and `OR` operators.
+     *   `AND` can only be used to represent an interval, such as `last_active_time
+     *   < "2022-01-01T00:00:00+00:00" AND last_active_time >
+     *   "2023-01-01T00:00:00+00:00"`.
+     *
+     *   The following example queries are valid:
+     *
+     *   ```
+     *   customer = "customers/my_customer" AND space_type = "SPACE"
+     *
+     *   customer = "customers/my_customer" AND space_type = "SPACE" AND
+     *   display_name:"Hello World"
+     *
+     *   customer = "customers/my_customer" AND space_type = "SPACE" AND
+     *   (last_active_time < "2020-01-01T00:00:00+00:00" OR last_active_time >
+     *   "2022-01-01T00:00:00+00:00")
+     *
+     *   customer = "customers/my_customer" AND space_type = "SPACE" AND
+     *   (display_name:"Hello World" OR display_name:"Fun event") AND
+     *   (last_active_time > "2020-01-01T00:00:00+00:00" AND last_active_time <
+     *   "2022-01-01T00:00:00+00:00")
+     *
+     *   customer = "customers/my_customer" AND space_type = "SPACE" AND
+     *   (create_time > "2019-01-01T00:00:00+00:00" AND create_time <
+     *   "2020-01-01T00:00:00+00:00") AND (external_user_allowed = "true") AND
+     *   (space_history_state = "HISTORY_ON" OR space_history_state = "HISTORY_OFF")
+     *   ```
+     * @param {string} [request.orderBy]
+     *   Optional. How the list of spaces is ordered.
+     *
+     *   Supported attributes to order by are:
+     *
+     *   - `membership_count.joined_direct_human_user_count` — Denotes the count of
+     *   human users that have directly joined a space.
+     *   - `last_active_time` — Denotes the time when last eligible item is added to
+     *   any topic of this space.
+     *   - `create_time` — Denotes the time of the space creation.
+     *
+     *   Valid ordering operation values are:
+     *
+     *   - `ASC` for ascending. Default value.
+     *
+     *   - `DESC` for descending.
+     *
+     *   The supported syntax are:
+     *
+     *   - `membership_count.joined_direct_human_user_count DESC`
+     *   - `membership_count.joined_direct_human_user_count ASC`
+     *   - `last_active_time DESC`
+     *   - `last_active_time ASC`
+     *   - `create_time DESC`
+     *   - `create_time ASC`
+     * @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 `searchSpacesAsync()`
+     *   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.
+     */
+    searchSpacesStream(request?: protos.google.chat.v1.ISearchSpacesRequest, options?: CallOptions): Transform;
+    /**
+     * Equivalent to `searchSpaces`, 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 {boolean} request.useAdminAccess
+     *   When `true`, the method runs using the user's Google Workspace
+     *   administrator privileges.
+     *
+     *   The calling user must be a Google Workspace administrator with the
+     *   [manage chat and spaces conversations
+     *   privilege](https://support.google.com/a/answer/13369245).
+     *
+     *   Requires either the `chat.admin.spaces.readonly` or `chat.admin.spaces`
+     *   [OAuth 2.0
+     *   scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).
+     *
+     *   This method currently only supports admin access, thus only `true` is
+     *   accepted for this field.
+     * @param {number} request.pageSize
+     *   The maximum number of spaces to return. The service may return fewer than
+     *   this value.
+     *
+     *   If unspecified, at most 100 spaces are returned.
+     *
+     *   The maximum value is 1000. If you use a value more than 1000, it's
+     *   automatically changed to 1000.
+     * @param {string} request.pageToken
+     *   A token, received from the previous search spaces call. Provide this
+     *   parameter 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.query
+     *   Required. A search query.
+     *
+     *   You can search by using the following parameters:
+     *
+     *   - `create_time`
+     *   - `customer`
+     *   - `display_name`
+     *   - `external_user_allowed`
+     *   - `last_active_time`
+     *   - `space_history_state`
+     *   - `space_type`
+     *
+     *   `create_time` and `last_active_time` accept a timestamp in
+     *   [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339) format and the supported
+     *   comparison operators are: `=`, `<`, `>`, `<=`, `>=`.
+     *
+     *   `customer` is required and is used to indicate which customer
+     *   to fetch spaces from. `customers/my_customer` is the only supported value.
+     *
+     *   `display_name` only accepts the `HAS` (`:`) operator. The text to
+     *   match is first tokenized into tokens and each token is prefix-matched
+     *   case-insensitively and independently as a substring anywhere in the space's
+     *   `display_name`. For example, `Fun Eve` matches `Fun event` or `The
+     *   evening was fun`, but not `notFun event` or `even`.
+     *
+     *   `external_user_allowed` accepts either `true` or `false`.
+     *
+     *   `space_history_state` only accepts values from the [`historyState`]
+     *   (https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces#Space.HistoryState)
+     *   field of a `space` resource.
+     *
+     *   `space_type` is required and the only valid value is `SPACE`.
+     *
+     *   Across different fields, only `AND` operators are supported. A valid
+     *   example is `space_type = "SPACE" AND display_name:"Hello"` and an invalid
+     *   example is `space_type = "SPACE" OR display_name:"Hello"`.
+     *
+     *   Among the same field,
+     *   `space_type` doesn't support `AND` or `OR` operators.
+     *   `display_name`, 'space_history_state', and 'external_user_allowed' only
+     *   support `OR` operators.
+     *   `last_active_time` and `create_time` support both `AND` and `OR` operators.
+     *   `AND` can only be used to represent an interval, such as `last_active_time
+     *   < "2022-01-01T00:00:00+00:00" AND last_active_time >
+     *   "2023-01-01T00:00:00+00:00"`.
+     *
+     *   The following example queries are valid:
+     *
+     *   ```
+     *   customer = "customers/my_customer" AND space_type = "SPACE"
+     *
+     *   customer = "customers/my_customer" AND space_type = "SPACE" AND
+     *   display_name:"Hello World"
+     *
+     *   customer = "customers/my_customer" AND space_type = "SPACE" AND
+     *   (last_active_time < "2020-01-01T00:00:00+00:00" OR last_active_time >
+     *   "2022-01-01T00:00:00+00:00")
+     *
+     *   customer = "customers/my_customer" AND space_type = "SPACE" AND
+     *   (display_name:"Hello World" OR display_name:"Fun event") AND
+     *   (last_active_time > "2020-01-01T00:00:00+00:00" AND last_active_time <
+     *   "2022-01-01T00:00:00+00:00")
+     *
+     *   customer = "customers/my_customer" AND space_type = "SPACE" AND
+     *   (create_time > "2019-01-01T00:00:00+00:00" AND create_time <
+     *   "2020-01-01T00:00:00+00:00") AND (external_user_allowed = "true") AND
+     *   (space_history_state = "HISTORY_ON" OR space_history_state = "HISTORY_OFF")
+     *   ```
+     * @param {string} [request.orderBy]
+     *   Optional. How the list of spaces is ordered.
+     *
+     *   Supported attributes to order by are:
+     *
+     *   - `membership_count.joined_direct_human_user_count` — Denotes the count of
+     *   human users that have directly joined a space.
+     *   - `last_active_time` — Denotes the time when last eligible item is added to
+     *   any topic of this space.
+     *   - `create_time` — Denotes the time of the space creation.
+     *
+     *   Valid ordering operation values are:
+     *
+     *   - `ASC` for ascending. Default value.
+     *
+     *   - `DESC` for descending.
+     *
+     *   The supported syntax are:
+     *
+     *   - `membership_count.joined_direct_human_user_count DESC`
+     *   - `membership_count.joined_direct_human_user_count ASC`
+     *   - `last_active_time DESC`
+     *   - `last_active_time ASC`
+     *   - `create_time DESC`
+     *   - `create_time ASC`
+     * @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.search_spaces.js</caption>
+     * region_tag:chat_v1_generated_ChatService_SearchSpaces_async
+     */
+    searchSpacesAsync(request?: protos.google.chat.v1.ISearchSpacesRequest, options?: CallOptions): AsyncIterable<protos.google.chat.v1.ISpace>;
     /**
      * Lists reactions to a message. For an example, see
      * [List reactions for a