@google-apps/chat 0.17.0 → 0.19.0

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

@@ -120,10 +120,21 @@ export declare class ChatServiceClient {
      * Creates a message in a Google Chat space. For an example, see [Send a
      * message](https://developers.google.com/workspace/chat/create-messages).
      *
-     * The `create()` method requires either [user
+     * Supports the following types of
+     * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
+     *
+     * - [App
+     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+     * with the authorization scope:
+     *     - `https://www.googleapis.com/auth/chat.bot`
+     * - [User
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-     * or [app
-     * authentication](https://developers.google.com/workspace/chat/authorize-import).
+     * with one of the following authorization scopes:
+     *     - `https://www.googleapis.com/auth/chat.messages.create`
+     *     - `https://www.googleapis.com/auth/chat.messages`
+     *     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+     *     only)
+     *
      * Chat attributes the message sender differently depending on the type of
      * authentication that you use in your request.
      *
@@ -222,11 +233,21 @@ export declare class ChatServiceClient {
      *
      * - [App
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+     * with one of the following authorization scopes:
+     *     - `https://www.googleapis.com/auth/chat.bot`
+     *     - `https://www.googleapis.com/auth/chat.app.memberships` (requires
+     *     [administrator approval](https://support.google.com/a?p=chat-app-auth))
      *
      * - [User
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-     * You can authenticate and authorize this method with administrator
-     * privileges by setting the `use_admin_access` field in the request.
+     * with one of the following authorization scopes:
+     *     - `https://www.googleapis.com/auth/chat.memberships.readonly`
+     *     - `https://www.googleapis.com/auth/chat.memberships`
+     *     - User authentication grants administrator privileges when an
+     *     administrator account authenticates, `use_admin_access` is `true`, and
+     *     one of the following authorization scopes is used:
+     *         - `https://www.googleapis.com/auth/chat.admin.memberships.readonly`
+     *         - `https://www.googleapis.com/auth/chat.admin.memberships`
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -281,9 +302,14 @@ export declare class ChatServiceClient {
      *
      * - [App
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+     * with the authorization scope:
+     *     - `https://www.googleapis.com/auth/chat.bot`
      *
      * - [User
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+     * with one of the following authorization scopes:
+     *     - `https://www.googleapis.com/auth/chat.messages.readonly`
+     *     - `https://www.googleapis.com/auth/chat.messages`
      *
      * Note: Might return a message from a blocked member or space.
      *
@@ -327,9 +353,15 @@ export declare class ChatServiceClient {
      *
      * - [App
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+     * with the authorization scope:
+     *     - `https://www.googleapis.com/auth/chat.bot`
      *
      * - [User
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+     * with one of the following authorization scopes:
+     *     - `https://www.googleapis.com/auth/chat.messages`
+     *     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+     *     only)
      *
      * When using app authentication, requests can only update messages
      * created by the calling Chat app.
@@ -356,6 +388,8 @@ export declare class ChatServiceClient {
      *
      *   - `accessory_widgets`  (Requires [app
      *   authentication](/chat/api/guides/auth/service-accounts).)
+     *
+     *   - `quoted_message_metadata` (Only allows removal of the quoted message.)
      * @param {boolean} [request.allowMissing]
      *   Optional. If `true` and the message isn't found, a new message is created
      *   and `updateMask` is ignored. The specified message ID must be
@@ -387,9 +421,15 @@ export declare class ChatServiceClient {
      *
      * - [App
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+     * with the authorization scope:
+     *     - `https://www.googleapis.com/auth/chat.bot`
      *
      * - [User
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+     * with one of the following authorization scopes:
+     *     - `https://www.googleapis.com/auth/chat.messages`
+     *     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+     *     only)
      *
      * When using app authentication, requests can only delete messages
      * created by the calling Chat app.
@@ -436,8 +476,13 @@ export declare class ChatServiceClient {
      * For an example, see
      * [Get metadata about a message
      * attachment](https://developers.google.com/workspace/chat/get-media-attachments).
+     *
      * Requires [app
-     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
+     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+     * with the [authorization
+     * scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+     *
+     *   - `https://www.googleapis.com/auth/chat.bot`
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -466,7 +511,13 @@ export declare class ChatServiceClient {
      * attachment](https://developers.google.com/workspace/chat/upload-media-attachments).
      *
      * Requires user
-     * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-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.messages.create`
+     *   - `https://www.googleapis.com/auth/chat.messages`
+     *   - `https://www.googleapis.com/auth/chat.import` (import mode spaces only)
      *
      * You can upload attachments up to 200 MB. Certain file types aren't
      * supported. For details, see [File types blocked by Google
@@ -505,11 +556,29 @@ export declare class ChatServiceClient {
      *
      * - [App
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+     * with one of the following authorization scopes:
+     *     - `https://www.googleapis.com/auth/chat.bot`
+     *     - `https://www.googleapis.com/auth/chat.app.spaces` with [administrator
+     *     approval](https://support.google.com/a?p=chat-app-auth)
      *
      * - [User
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-     * You can authenticate and authorize this method with administrator
-     * privileges by setting the `use_admin_access` field in the request.
+     * with one of the following authorization scopes:
+     *     - `https://www.googleapis.com/auth/chat.spaces.readonly`
+     *     - `https://www.googleapis.com/auth/chat.spaces`
+     *     - User authentication grants administrator privileges when an
+     *     administrator account authenticates, `use_admin_access` is `true`, and
+     *     one of the following authorization scopes is used:
+     *         - `https://www.googleapis.com/auth/chat.admin.spaces.readonly`
+     *         - `https://www.googleapis.com/auth/chat.admin.spaces`
+     *
+     * App authentication has the following limitations:
+     *
+     * - `space.access_settings` is only populated when using the
+     * `chat.app.spaces` scope.
+     * - `space.predefind_permission_settings` and `space.permission_settings` are
+     * only populated when using the `chat.app.spaces` scope, and only for
+     * spaces the app created.
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -544,28 +613,49 @@ export declare class ChatServiceClient {
     getSpace(request: protos.google.chat.v1.IGetSpaceRequest, options: CallOptions, callback: Callback<protos.google.chat.v1.ISpace, protos.google.chat.v1.IGetSpaceRequest | null | undefined, {} | null | undefined>): void;
     getSpace(request: protos.google.chat.v1.IGetSpaceRequest, callback: Callback<protos.google.chat.v1.ISpace, protos.google.chat.v1.IGetSpaceRequest | null | undefined, {} | null | undefined>): void;
     /**
-     * Creates a space with no members. Can be used to create a named space, or a
+     * Creates a space. Can be used to create a named space, or a
      * group chat in `Import mode`. For an example, see [Create a
      * space](https://developers.google.com/workspace/chat/create-spaces).
      *
-     *  If you receive the error message `ALREADY_EXISTS` when creating
-     *  a space, try a different `displayName`. An existing space within
-     *  the Google Workspace organization might already use this display name.
-     *
      * Supports the following types of
      * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
      *
      * - [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)
+     * and one of the following authorization scopes:
+     *     - `https://www.googleapis.com/auth/chat.app.spaces.create`
+     *     - `https://www.googleapis.com/auth/chat.app.spaces`
      *
      * - [User
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+     * with one of the following authorization scopes:
+     *     - `https://www.googleapis.com/auth/chat.spaces.create`
+     *     - `https://www.googleapis.com/auth/chat.spaces`
+     *     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+     *     only)
      *
      * When authenticating as an app, the `space.customer` field must be set in
      * the request.
      *
+     * When authenticating as an app, the Chat app is added as a member of the
+     * space. However, unlike human authentication, the Chat app is not added as a
+     * space manager. By default, the Chat app can be removed from the space by
+     * all space members. To allow only space managers to remove the app from a
+     * space, set `space.permission_settings.manage_apps` to `managers_allowed`.
+     *
+     * Space membership upon creation depends on whether the space is created in
+     * `Import mode`:
+     *
+     * * **Import mode:** No members are created.
+     * * **All other modes:**  The calling user is added as a member. This is:
+     *     * The app itself when using app authentication.
+     *     * The human user when using user authentication.
+     *
+     *  If you receive the error message `ALREADY_EXISTS` when creating
+     *  a space, try a different `displayName`. An existing space within
+     *  the Google Workspace organization might already use this display name.
+     *
      * @param {Object} request
      *   The request object that will be sent.
      * @param {google.chat.v1.Space} request.space
@@ -655,7 +745,12 @@ export declare class ChatServiceClient {
      * might already use this display name.
      *
      * Requires [user
-     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-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.spaces.create`
+     *   - `https://www.googleapis.com/auth/chat.spaces`
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -694,7 +789,7 @@ export declare class ChatServiceClient {
      *   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).
+     *   The set currently allows up to 49 memberships (in addition to the caller).
      *
      *   For human membership, the `Membership.member` field must contain a `user`
      *   with `name` populated (format: `users/{user}`) and `type` set to
@@ -751,12 +846,26 @@ 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)
+     * and one of the following authorization scopes:
+     *     - `https://www.googleapis.com/auth/chat.app.spaces`
      *
      * - [User
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-     * You can authenticate and authorize this method with administrator
-     * privileges by setting the `use_admin_access` field in the request.
+     * with one of the following authorization scopes:
+     *     - `https://www.googleapis.com/auth/chat.spaces`
+     *     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+     *     only)
+     *     - User authentication grants administrator privileges when an
+     *     administrator account authenticates, `use_admin_access` is `true`, and
+     *     the following authorization scopes is used:
+     *         - `https://www.googleapis.com/auth/chat.admin.spaces`
+     *
+     * App authentication has the following limitations:
+     *
+     * - To update either `space.predefined_permission_settings` or
+     * `space.permission_settings`, the app must be the space creator.
+     * - Updating the `space.access_settings.audience` is not supported for app
+     * authentication.
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -867,13 +976,22 @@ 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 [administrator
+     * approval](https://support.google.com/a?p=chat-app-auth) and the
+     * authorization scope:
+     *     - `https://www.googleapis.com/auth/chat.app.delete` (only in
+     *     spaces the app created)
      *
      * - [User
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-     * You can authenticate and authorize this method with administrator
-     * privileges by setting the `use_admin_access` field in the request.
+     * with one of the following authorization scopes:
+     *     - `https://www.googleapis.com/auth/chat.delete`
+     *     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+     *     only)
+     *     - User authentication grants administrator privileges when an
+     *     administrator account authenticates, `use_admin_access` is `true`, and
+     *     the following authorization scope is used:
+     *         - `https://www.googleapis.com/auth/chat.admin.delete`
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -912,9 +1030,14 @@ export declare class ChatServiceClient {
      * [import process](https://developers.google.com/workspace/chat/import-data)
      * for the specified space and makes it visible to users.
      *
-     * Requires [app
-     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
-     * and domain-wide delegation. For more information, see [Authorize Google
+     * Requires [user
+     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+     * and domain-wide delegation with the [authorization
+     * scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+     *
+     *   - `https://www.googleapis.com/auth/chat.import`
+     *
+     * For more information, see [Authorize Google
      * Chat apps to import
      * data](https://developers.google.com/workspace/chat/authorize-import).
      *
@@ -956,14 +1079,19 @@ export declare class ChatServiceClient {
      * returns the direct message space between the specified user and the
      * authenticated user.
      *
-     * // Supports the following types of
+     * Supports the following types of
      * [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
      *
      * - [App
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+     * with the authorization scope:
+     *     - `https://www.googleapis.com/auth/chat.bot`
      *
      * - [User
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+     * with one of the following authorization scopes:
+     *     - `https://www.googleapis.com/auth/chat.spaces.readonly`
+     *     - `https://www.googleapis.com/auth/chat.spaces`
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -1011,21 +1139,35 @@ 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)
+     * and the authorization scope:
+     *     - `https://www.googleapis.com/auth/chat.app.memberships`
      *
      * - [User
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-     * You can authenticate and authorize this method with administrator
-     * privileges by setting the `use_admin_access` field in the request.
+     * with one of the following authorization scopes:
+     *     - `https://www.googleapis.com/auth/chat.memberships`
+     *     - `https://www.googleapis.com/auth/chat.memberships.app` (to add the
+     *     calling app to the space)
+     *     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+     *     only)
+     *     - User authentication grants administrator privileges when an
+     *     administrator account authenticates, `use_admin_access` is `true`, and
+     *     the following authorization scope is used:
+     *         - `https://www.googleapis.com/auth/chat.admin.memberships`
+     *
+     * App authentication is not supported for the following use cases:
+     *
+     * - Inviting users external to the Workspace organization that owns the
+     * space.
+     * - Adding a Google Group to a space.
+     * - Adding a Chat app to a space.
      *
      * For example usage, see:
      *
      * - [Invite or add a user to a
      * space](https://developers.google.com/workspace/chat/create-members#create-user-membership).
-     *
      * - [Invite or add a Google Group to a
      * space](https://developers.google.com/workspace/chat/create-members#create-group-membership).
-     *
      * - [Add the Chat app to a
      * space](https://developers.google.com/workspace/chat/create-members#create-membership-calling-api).
      *
@@ -1053,8 +1195,6 @@ export declare class ChatServiceClient {
      *   - When [authenticating as an
      *   app](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app),
      *   the `chat.app.memberships` authorization scope is required.
-     *   Authenticating as an app is available in [Developer
-     *   Preview](https://developers.google.com/workspace/preview).
      *
      *   - Set `user.type` to `HUMAN`, and set `user.name` with format
      *   `users/{user}`, where `{user}` can be the email address for the user. For
@@ -1113,13 +1253,22 @@ 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 [administrator
+     * approval](https://support.google.com/a?p=chat-app-auth) and the
+     * authorization scope:
+     *     - `https://www.googleapis.com/auth/chat.app.memberships` (only in
+     *     spaces the app created)
      *
      * - [User
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-     * You can authenticate and authorize this method with administrator
-     * privileges by setting the `use_admin_access` field in the request.
+     * with one of the following authorization scopes:
+     *     - `https://www.googleapis.com/auth/chat.memberships`
+     *     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+     *     only)
+     *     - User authentication grants administrator privileges when an
+     *     administrator account authenticates, `use_admin_access` is `true`, and
+     *     the following authorization scope is used:
+     *         - `https://www.googleapis.com/auth/chat.admin.memberships`
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -1170,12 +1319,31 @@ 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)
+     * and the authorization scope:
+     *     - `https://www.googleapis.com/auth/chat.app.memberships`
      *
      * - [User
      * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-     * You can authenticate and authorize this method with administrator
-     * privileges by setting the `use_admin_access` field in the request.
+     * with one of the following authorization scopes:
+     *     - `https://www.googleapis.com/auth/chat.memberships`
+     *     - `https://www.googleapis.com/auth/chat.memberships.app` (to remove
+     *     the calling app from the space)
+     *     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+     *     only)
+     *     - User authentication grants administrator privileges when an
+     *     administrator account authenticates, `use_admin_access` is `true`, and
+     *     the following authorization scope is used:
+     *         - `https://www.googleapis.com/auth/chat.admin.memberships`
+     *
+     * App authentication is not supported for the following use cases:
+     *
+     * - Removing a Google Group from a space.
+     * - Removing a Chat app from a space.
+     *
+     * To delete memberships for space managers, the requester
+     * must be a space manager. If you're using [app
+     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+     * the Chat app must be the space creator.
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -1184,9 +1352,13 @@ export declare class ChatServiceClient {
      *   human users' or their own memberships. Chat apps can't delete other apps'
      *   memberships.
      *
-     *   When deleting a human membership, requires the `chat.memberships` scope and
-     *   `spaces/{space}/members/{member}` format. You can use the email as an
-     *   alias for `{member}`. For example,
+     *   When deleting a human membership, requires the `chat.memberships` scope
+     *   with [user
+     *   authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+     *   or the `chat.memberships.app` scope with [app
+     *   authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+     *   and the `spaces/{space}/members/{member}` format.
+     *   You can use the 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.
      *
@@ -1228,7 +1400,14 @@ export declare class ChatServiceClient {
      * message](https://developers.google.com/workspace/chat/create-reactions).
      *
      * Requires [user
-     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-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.messages.reactions.create`
+     *   - `https://www.googleapis.com/auth/chat.messages.reactions`
+     *   - `https://www.googleapis.com/auth/chat.messages`
+     *   - `https://www.googleapis.com/auth/chat.import` (import mode spaces only)
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -1260,7 +1439,13 @@ export declare class ChatServiceClient {
      * reaction](https://developers.google.com/workspace/chat/delete-reactions).
      *
      * Requires [user
-     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-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.messages.reactions`
+     *   - `https://www.googleapis.com/auth/chat.messages`
+     *   - `https://www.googleapis.com/auth/chat.import` (import mode spaces only)
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -1295,7 +1480,11 @@ export declare class ChatServiceClient {
      * permissions](https://support.google.com/a/answer/12850085).
      *
      * Requires [user
-     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-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.customemojis`
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -1328,7 +1517,12 @@ export declare class ChatServiceClient {
      * permissions](https://support.google.com/a/answer/12850085).
      *
      * Requires [user
-     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-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.customemojis.readonly`
+     *   - `https://www.googleapis.com/auth/chat.customemojis`
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -1371,7 +1565,11 @@ export declare class ChatServiceClient {
      * permissions](https://support.google.com/a/answer/12850085).
      *
      * Requires [user
-     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-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.customemojis`
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -1406,7 +1604,12 @@ export declare class ChatServiceClient {
      * state](https://developers.google.com/workspace/chat/get-space-read-state).
      *
      * Requires [user
-     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-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.users.readstate.readonly`
+     *   - `https://www.googleapis.com/auth/chat.users.readstate`
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -1448,7 +1651,11 @@ export declare class ChatServiceClient {
      * state](https://developers.google.com/workspace/chat/update-space-read-state).
      *
      * Requires [user
-     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-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.readstate`
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -1505,7 +1712,12 @@ export declare class ChatServiceClient {
      * state](https://developers.google.com/workspace/chat/get-thread-read-state).
      *
      * Requires [user
-     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-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.users.readstate.readonly`
+     *   - `https://www.googleapis.com/auth/chat.users.readstate`
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -1554,7 +1766,20 @@ export declare class ChatServiceClient {
      * object of the Space event data for this request.
      *
      * Requires [user
-     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+     * with an [authorization
+     * scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes)
+     * appropriate for reading the requested data:
+     *
+     *   - `https://www.googleapis.com/auth/chat.spaces.readonly`
+     *   - `https://www.googleapis.com/auth/chat.spaces`
+     *   - `https://www.googleapis.com/auth/chat.messages.readonly`
+     *   - `https://www.googleapis.com/auth/chat.messages`
+     *   - `https://www.googleapis.com/auth/chat.messages.reactions.readonly`
+     *   - `https://www.googleapis.com/auth/chat.messages.reactions`
+     *   - `https://www.googleapis.com/auth/chat.memberships.readonly`
+     *   - `https://www.googleapis.com/auth/chat.memberships`
+     *
      * To get an event, the authenticated user must be a member of the space.
      *
      * For an example, see [Get details about an
@@ -1589,7 +1814,11 @@ export declare class ChatServiceClient {
      * setting](https://developers.google.com/workspace/chat/get-space-notification-setting).
      *
      * Requires [user
-     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-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.spacesettings`
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -1622,7 +1851,11 @@ export declare class ChatServiceClient {
      * setting](https://developers.google.com/workspace/chat/update-space-notification-setting).
      *
      * Requires [user
-     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-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.spacesettings`
      *
      * @param {Object} request
      *   The request object that will be sent.
@@ -1663,7 +1896,13 @@ export declare class ChatServiceClient {
     * messages](https://developers.google.com/workspace/chat/api/guides/v1/messages/list).
     *
     * Requires [user
-    * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+    * 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.messages.readonly`
+    *   - `https://www.googleapis.com/auth/chat.messages`
+    *   - `https://www.googleapis.com/auth/chat.import` (import mode spaces only)
     *
     * @param {Object} request
     *   The request object that will be sent.
@@ -1955,11 +2194,23 @@ export declare class ChatServiceClient {
     *
     * - [App
     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+    * with one of the following authorization scopes:
+    *     - `https://www.googleapis.com/auth/chat.bot`
+    *     - `https://www.googleapis.com/auth/chat.app.memberships` (requires
+    *     [administrator approval](https://support.google.com/a?p=chat-app-auth))
     *
     * - [User
     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-    * You can authenticate and authorize this method with administrator
-    * privileges by setting the `use_admin_access` field in the request.
+    * with one of the following authorization scopes:
+    *     - `https://www.googleapis.com/auth/chat.memberships.readonly`
+    *     - `https://www.googleapis.com/auth/chat.memberships`
+    *     - `https://www.googleapis.com/auth/chat.import` (import mode spaces
+    *     only)
+    *     - User authentication grants administrator privileges when an
+    *     administrator account authenticates, `use_admin_access` is `true`, and
+    *     one of the following authorization scopes is used:
+    *         - `https://www.googleapis.com/auth/chat.admin.memberships.readonly`
+    *         - `https://www.googleapis.com/auth/chat.admin.memberships`
     *
     * @param {Object} request
     *   The request object that will be sent.
@@ -2298,9 +2549,14 @@ export declare class ChatServiceClient {
     *
     * - [App
     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+    * with the authorization scope:
+    *     - `https://www.googleapis.com/auth/chat.bot`
     *
     * - [User
     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+    * with one of the following authorization scopes:
+    *     - `https://www.googleapis.com/auth/chat.spaces.readonly`
+    *     - `https://www.googleapis.com/auth/chat.spaces`
     *
     * 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)
@@ -2476,7 +2732,13 @@ export declare class ChatServiceClient {
     *
     * Requires [user
     * authentication with administrator
-    * privileges](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user#admin-privileges).
+    * privileges](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user#admin-privileges)
+    * and one of the following [authorization
+    * scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+    *
+    *   - `https://www.googleapis.com/auth/chat.admin.spaces.readonly`
+    *   - `https://www.googleapis.com/auth/chat.admin.spaces`
+    *
     * In the request, set `use_admin_access` to `true`.
     *
     * @param {Object} request
@@ -2910,7 +3172,14 @@ export declare class ChatServiceClient {
     * message](https://developers.google.com/workspace/chat/list-reactions).
     *
     * Requires [user
-    * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-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.messages.reactions.readonly`
+    *   - `https://www.googleapis.com/auth/chat.messages.reactions`
+    *   - `https://www.googleapis.com/auth/chat.messages.readonly`
+    *   - `https://www.googleapis.com/auth/chat.messages`
     *
     * @param {Object} request
     *   The request object that will be sent.
@@ -3159,7 +3428,12 @@ export declare class ChatServiceClient {
     * permissions](https://support.google.com/a/answer/12850085).
     *
     * Requires [user
-    * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-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.customemojis.readonly`
+    *   - `https://www.googleapis.com/auth/chat.customemojis`
     *
     * @param {Object} request
     *   The request object that will be sent.
@@ -3311,7 +3585,20 @@ export declare class ChatServiceClient {
     * `Membership` resource.
     *
     * Requires [user
-    * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+    * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+    * with an [authorization
+    * scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes)
+    * appropriate for reading the requested data:
+    *
+    *   - `https://www.googleapis.com/auth/chat.spaces.readonly`
+    *   - `https://www.googleapis.com/auth/chat.spaces`
+    *   - `https://www.googleapis.com/auth/chat.messages.readonly`
+    *   - `https://www.googleapis.com/auth/chat.messages`
+    *   - `https://www.googleapis.com/auth/chat.messages.reactions.readonly`
+    *   - `https://www.googleapis.com/auth/chat.messages.reactions`
+    *   - `https://www.googleapis.com/auth/chat.memberships.readonly`
+    *   - `https://www.googleapis.com/auth/chat.memberships`
+    *
     * To list events, the authenticated user must be a member of the space.
     *
     * For an example, see [List events from a Google Chat