@google-apps/chat 0.25.0 → 0.26.0

package/build/protos/protos.json

@@ -3631,10 +3631,220 @@
                     }
                   }
                 },
+                "Audience": {
+                  "fields": {
+                    "name": {
+                      "type": "string",
+                      "id": 1
+                    }
+                  }
+                },
+                "Availability": {
+                  "options": {
+                    "(google.api.resource).type": "chat.googleapis.com/Availability",
+                    "(google.api.resource).pattern": "users/{user}/availability",
+                    "(google.api.resource).plural": "availabilities",
+                    "(google.api.resource).singular": "availability"
+                  },
+                  "oneofs": {
+                    "stateMetadata": {
+                      "oneof": [
+                        "doNotDisturbMetadata"
+                      ]
+                    }
+                  },
+                  "fields": {
+                    "name": {
+                      "type": "string",
+                      "id": 1,
+                      "options": {
+                        "(google.api.field_behavior)": "IDENTIFIER"
+                      }
+                    },
+                    "state": {
+                      "type": "State",
+                      "id": 2,
+                      "options": {
+                        "(google.api.field_behavior)": "OUTPUT_ONLY"
+                      }
+                    },
+                    "doNotDisturbMetadata": {
+                      "type": "DoNotDisturbMetadata",
+                      "id": 3,
+                      "options": {
+                        "(google.api.field_behavior)": "OUTPUT_ONLY"
+                      }
+                    },
+                    "customStatus": {
+                      "type": "CustomStatus",
+                      "id": 4,
+                      "options": {
+                        "(google.api.field_behavior)": "OPTIONAL"
+                      }
+                    }
+                  },
+                  "nested": {
+                    "State": {
+                      "values": {
+                        "STATE_UNSPECIFIED": 0,
+                        "ACTIVE": 1,
+                        "IDLE": 2,
+                        "AWAY": 3,
+                        "DO_NOT_DISTURB": 4
+                      }
+                    }
+                  }
+                },
+                "CustomStatus": {
+                  "oneofs": {
+                    "expiration": {
+                      "oneof": [
+                        "expireTime",
+                        "ttl"
+                      ]
+                    }
+                  },
+                  "fields": {
+                    "text": {
+                      "type": "string",
+                      "id": 1,
+                      "options": {
+                        "(google.api.field_behavior)": "REQUIRED"
+                      }
+                    },
+                    "emoji": {
+                      "type": "Emoji",
+                      "id": 2,
+                      "options": {
+                        "(google.api.field_behavior)": "REQUIRED"
+                      }
+                    },
+                    "expireTime": {
+                      "type": "google.protobuf.Timestamp",
+                      "id": 3
+                    },
+                    "ttl": {
+                      "type": "google.protobuf.Duration",
+                      "id": 4,
+                      "options": {
+                        "(google.api.field_behavior)": "INPUT_ONLY"
+                      }
+                    }
+                  }
+                },
+                "DoNotDisturbMetadata": {
+                  "fields": {
+                    "expirationTime": {
+                      "type": "google.protobuf.Timestamp",
+                      "id": 1,
+                      "options": {
+                        "(google.api.field_behavior)": "OUTPUT_ONLY"
+                      }
+                    }
+                  }
+                },
+                "GetAvailabilityRequest": {
+                  "fields": {
+                    "name": {
+                      "type": "string",
+                      "id": 1,
+                      "options": {
+                        "(google.api.field_behavior)": "REQUIRED",
+                        "(google.api.resource_reference).type": "chat.googleapis.com/Availability"
+                      }
+                    }
+                  }
+                },
+                "UpdateAvailabilityRequest": {
+                  "fields": {
+                    "availability": {
+                      "type": "Availability",
+                      "id": 1,
+                      "options": {
+                        "(google.api.field_behavior)": "REQUIRED"
+                      }
+                    },
+                    "updateMask": {
+                      "type": "google.protobuf.FieldMask",
+                      "id": 2,
+                      "options": {
+                        "(google.api.field_behavior)": "REQUIRED"
+                      }
+                    }
+                  }
+                },
+                "MarkAsActiveRequest": {
+                  "oneofs": {
+                    "expiration": {
+                      "oneof": [
+                        "expireTime",
+                        "ttl"
+                      ]
+                    }
+                  },
+                  "fields": {
+                    "name": {
+                      "type": "string",
+                      "id": 1,
+                      "options": {
+                        "(google.api.field_behavior)": "REQUIRED",
+                        "(google.api.resource_reference).type": "chat.googleapis.com/Availability"
+                      }
+                    },
+                    "expireTime": {
+                      "type": "google.protobuf.Timestamp",
+                      "id": 2
+                    },
+                    "ttl": {
+                      "type": "google.protobuf.Duration",
+                      "id": 3
+                    }
+                  }
+                },
+                "MarkAsAwayRequest": {
+                  "fields": {
+                    "name": {
+                      "type": "string",
+                      "id": 1,
+                      "options": {
+                        "(google.api.field_behavior)": "REQUIRED",
+                        "(google.api.resource_reference).type": "chat.googleapis.com/Availability"
+                      }
+                    }
+                  }
+                },
+                "MarkAsDoNotDisturbRequest": {
+                  "oneofs": {
+                    "expiration": {
+                      "oneof": [
+                        "expireTime",
+                        "ttl"
+                      ]
+                    }
+                  },
+                  "fields": {
+                    "name": {
+                      "type": "string",
+                      "id": 1,
+                      "options": {
+                        "(google.api.field_behavior)": "REQUIRED",
+                        "(google.api.resource_reference).type": "chat.googleapis.com/Availability"
+                      }
+                    },
+                    "expireTime": {
+                      "type": "google.protobuf.Timestamp",
+                      "id": 2
+                    },
+                    "ttl": {
+                      "type": "google.protobuf.Duration",
+                      "id": 3
+                    }
+                  }
+                },
                 "ChatService": {
                   "options": {
                     "(google.api.default_host)": "chat.googleapis.com",
-                    "(google.api.oauth_scopes)": "https://www.googleapis.com/auth/chat.admin.delete,https://www.googleapis.com/auth/chat.admin.memberships,https://www.googleapis.com/auth/chat.admin.memberships.readonly,https://www.googleapis.com/auth/chat.admin.spaces,https://www.googleapis.com/auth/chat.admin.spaces.readonly,https://www.googleapis.com/auth/chat.app.delete,https://www.googleapis.com/auth/chat.app.memberships,https://www.googleapis.com/auth/chat.app.memberships.readonly,https://www.googleapis.com/auth/chat.app.messages.readonly,https://www.googleapis.com/auth/chat.app.spaces,https://www.googleapis.com/auth/chat.app.spaces.create,https://www.googleapis.com/auth/chat.app.spaces.readonly,https://www.googleapis.com/auth/chat.bot,https://www.googleapis.com/auth/chat.customemojis,https://www.googleapis.com/auth/chat.customemojis.readonly,https://www.googleapis.com/auth/chat.delete,https://www.googleapis.com/auth/chat.import,https://www.googleapis.com/auth/chat.memberships,https://www.googleapis.com/auth/chat.memberships.app,https://www.googleapis.com/auth/chat.memberships.readonly,https://www.googleapis.com/auth/chat.messages,https://www.googleapis.com/auth/chat.messages.create,https://www.googleapis.com/auth/chat.messages.reactions,https://www.googleapis.com/auth/chat.messages.reactions.create,https://www.googleapis.com/auth/chat.messages.reactions.readonly,https://www.googleapis.com/auth/chat.messages.readonly,https://www.googleapis.com/auth/chat.spaces,https://www.googleapis.com/auth/chat.spaces.create,https://www.googleapis.com/auth/chat.spaces.readonly,https://www.googleapis.com/auth/chat.users.readstate,https://www.googleapis.com/auth/chat.users.readstate.readonly,https://www.googleapis.com/auth/chat.users.sections,https://www.googleapis.com/auth/chat.users.sections.readonly,https://www.googleapis.com/auth/chat.users.spacesettings"
+                    "(google.api.oauth_scopes)": "https://www.googleapis.com/auth/chat.admin.delete,https://www.googleapis.com/auth/chat.admin.memberships,https://www.googleapis.com/auth/chat.admin.memberships.readonly,https://www.googleapis.com/auth/chat.admin.spaces,https://www.googleapis.com/auth/chat.admin.spaces.readonly,https://www.googleapis.com/auth/chat.app.delete,https://www.googleapis.com/auth/chat.app.memberships,https://www.googleapis.com/auth/chat.app.memberships.readonly,https://www.googleapis.com/auth/chat.app.messages.readonly,https://www.googleapis.com/auth/chat.app.spaces,https://www.googleapis.com/auth/chat.app.spaces.create,https://www.googleapis.com/auth/chat.app.spaces.readonly,https://www.googleapis.com/auth/chat.bot,https://www.googleapis.com/auth/chat.customemojis,https://www.googleapis.com/auth/chat.customemojis.readonly,https://www.googleapis.com/auth/chat.delete,https://www.googleapis.com/auth/chat.import,https://www.googleapis.com/auth/chat.memberships,https://www.googleapis.com/auth/chat.memberships.app,https://www.googleapis.com/auth/chat.memberships.readonly,https://www.googleapis.com/auth/chat.messages,https://www.googleapis.com/auth/chat.messages.create,https://www.googleapis.com/auth/chat.messages.reactions,https://www.googleapis.com/auth/chat.messages.reactions.create,https://www.googleapis.com/auth/chat.messages.reactions.readonly,https://www.googleapis.com/auth/chat.messages.readonly,https://www.googleapis.com/auth/chat.spaces,https://www.googleapis.com/auth/chat.spaces.create,https://www.googleapis.com/auth/chat.spaces.readonly,https://www.googleapis.com/auth/chat.users.availability,https://www.googleapis.com/auth/chat.users.availability.readonly,https://www.googleapis.com/auth/chat.users.readstate,https://www.googleapis.com/auth/chat.users.readstate.readonly,https://www.googleapis.com/auth/chat.users.sections,https://www.googleapis.com/auth/chat.users.sections.readonly,https://www.googleapis.com/auth/chat.users.spacesettings"
                   },
                   "methods": {
                     "CreateMessage": {
@@ -4223,6 +4433,92 @@
                         }
                       ]
                     },
+                    "GetAvailability": {
+                      "requestType": "GetAvailabilityRequest",
+                      "responseType": "Availability",
+                      "options": {
+                        "(google.api.http).get": "/v1/{name=users/*/availability}",
+                        "(google.api.method_signature)": "name"
+                      },
+                      "parsedOptions": [
+                        {
+                          "(google.api.http)": {
+                            "get": "/v1/{name=users/*/availability}"
+                          }
+                        },
+                        {
+                          "(google.api.method_signature)": "name"
+                        }
+                      ]
+                    },
+                    "MarkAsActive": {
+                      "requestType": "MarkAsActiveRequest",
+                      "responseType": "Availability",
+                      "options": {
+                        "(google.api.http).post": "/v1/{name=users/*/availability}:markAsActive",
+                        "(google.api.http).body": "*"
+                      },
+                      "parsedOptions": [
+                        {
+                          "(google.api.http)": {
+                            "post": "/v1/{name=users/*/availability}:markAsActive",
+                            "body": "*"
+                          }
+                        }
+                      ]
+                    },
+                    "MarkAsAway": {
+                      "requestType": "MarkAsAwayRequest",
+                      "responseType": "Availability",
+                      "options": {
+                        "(google.api.http).post": "/v1/{name=users/*/availability}:markAsAway",
+                        "(google.api.http).body": "*"
+                      },
+                      "parsedOptions": [
+                        {
+                          "(google.api.http)": {
+                            "post": "/v1/{name=users/*/availability}:markAsAway",
+                            "body": "*"
+                          }
+                        }
+                      ]
+                    },
+                    "MarkAsDoNotDisturb": {
+                      "requestType": "MarkAsDoNotDisturbRequest",
+                      "responseType": "Availability",
+                      "options": {
+                        "(google.api.http).post": "/v1/{name=users/*/availability}:markAsDoNotDisturb",
+                        "(google.api.http).body": "*"
+                      },
+                      "parsedOptions": [
+                        {
+                          "(google.api.http)": {
+                            "post": "/v1/{name=users/*/availability}:markAsDoNotDisturb",
+                            "body": "*"
+                          }
+                        }
+                      ]
+                    },
+                    "UpdateAvailability": {
+                      "requestType": "UpdateAvailabilityRequest",
+                      "responseType": "Availability",
+                      "options": {
+                        "(google.api.http).patch": "/v1/{availability.name=users/*/availability}",
+                        "(google.api.http).body": "availability",
+                        "(google.api.method_signature)": "availability,update_mask"
+                      },
+                      "parsedOptions": [
+                        {
+                          "(google.api.http)": {
+                            "patch": "/v1/{availability.name=users/*/availability}",
+                            "body": "availability"
+                          }
+                        },
+                        {
+                          "(google.api.method_signature)": "availability,update_mask"
+                        }
+                      ]
+                    },
                     "GetSpaceEvent": {
                       "requestType": "GetSpaceEventRequest",
                       "responseType": "SpaceEvent",
@@ -5983,6 +6279,13 @@
                           "options": {
                             "(google.api.field_behavior)": "OPTIONAL"
                           }
+                        },
+                        "accessPermissionSettings": {
+                          "type": "AccessPermissionSettings",
+                          "id": 5,
+                          "options": {
+                            "(google.api.field_behavior)": "OPTIONAL"
+                          }
                         }
                       },
                       "nested": {
@@ -5995,6 +6298,51 @@
                         }
                       }
                     },
+                    "AccessPermissionSettings": {
+                      "fields": {
+                        "discoverSpaceSetting": {
+                          "type": "AccessPermissionSetting",
+                          "id": 1,
+                          "options": {
+                            "(google.api.field_behavior)": "OPTIONAL"
+                          }
+                        },
+                        "joinSpaceSetting": {
+                          "type": "AccessPermissionSetting",
+                          "id": 2,
+                          "options": {
+                            "(google.api.field_behavior)": "OPTIONAL"
+                          }
+                        }
+                      }
+                    },
+                    "AccessPermissionSetting": {
+                      "fields": {
+                        "principals": {
+                          "rule": "repeated",
+                          "type": "Principal",
+                          "id": 1,
+                          "options": {
+                            "(google.api.field_behavior)": "UNORDERED_LIST"
+                          }
+                        }
+                      }
+                    },
+                    "Principal": {
+                      "oneofs": {
+                        "principalType": {
+                          "oneof": [
+                            "audience"
+                          ]
+                        }
+                      },
+                      "fields": {
+                        "audience": {
+                          "type": "Audience",
+                          "id": 1
+                        }
+                      }
+                    },
                     "PredefinedPermissionSettings": {
                       "values": {
                         "PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED": 0,

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

@@ -934,6 +934,24 @@ export declare class ChatServiceClient {
      *   users](https://developers.google.com/workspace/chat/space-target-audience).
      *   `access_settings.audience` is not supported with `useAdminAccess`.
      *
+     *   `access_settings.access_permission_settings`: Updates the [access
+     *   permission
+     *   settings](https://support.google.com/chat/answer/11971020) of who can
+     *   discover and join the space where `spaceType` field is `SPACE`. Principals
+     *   allowed to join the space must also be allowed to discover it. To update
+     *   access permission settings for a space, the authenticating user must be a
+     *   space manager or assistant manager and omit all other field masks in the
+     *   request. You can't update this field if the space is in [import
+     *   mode](https://developers.google.com/workspace/chat/import-data-overview).
+     *   To learn more, see [Make a space discoverable to specific
+     *   users](https://developers.google.com/workspace/chat/space-target-audience).
+     *   `access_settings.access_permission_settings` is not supported with
+     *   `useAdminAccess`.
+     *   The supported field masks include:
+     *
+     *   - `access_settings.access_permission_settings.discoverSpaceSetting`
+     *   - `access_settings.access_permission_settings.joinSpaceSetting`
+     *
      *   `permission_settings`: Supports changing the
      *   [permission settings](https://support.google.com/chat/answer/13340792)
      *   of a space.
@@ -1768,6 +1786,224 @@ export declare class ChatServiceClient {
     ]>;
     getThreadReadState(request: protos.google.chat.v1.IGetThreadReadStateRequest, options: CallOptions, callback: Callback<protos.google.chat.v1.IThreadReadState, protos.google.chat.v1.IGetThreadReadStateRequest | null | undefined, {} | null | undefined>): void;
     getThreadReadState(request: protos.google.chat.v1.IGetThreadReadStateRequest, callback: Callback<protos.google.chat.v1.IThreadReadState, protos.google.chat.v1.IGetThreadReadStateRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * Returns availability information for a human user in Google Chat. For
+     * example, this can be used to check if a user is online or away, or to
+     * retrieve their custom status message.
+     *
+     * This method only retrieves the authenticated user's availability.
+     *
+     * 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.users.availability.readonly`
+     *   - `https://www.googleapis.com/auth/chat.users.availability`
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   Required. The resource name of the availability to retrieve.
+     *
+     *   Format: users/{user}/availability
+     *
+     *   `{user}` is the id for the Person in the People API or Admin SDK directory
+     *   API. For example, `users/123456789`.
+     *
+     *   The user's email address or `me` can also be used as an alias to refer to
+     *   the caller.  For example, `users/user@example.com` or `users/me`.
+     * @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.Availability|Availability}.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
+     *   for more details and examples.
+     * @example <caption>include:samples/generated/v1/chat_service.get_availability.js</caption>
+     * region_tag:chat_v1_generated_ChatService_GetAvailability_async
+     */
+    getAvailability(request?: protos.google.chat.v1.IGetAvailabilityRequest, options?: CallOptions): Promise<[
+        protos.google.chat.v1.IAvailability,
+        protos.google.chat.v1.IGetAvailabilityRequest | undefined,
+        {} | undefined
+    ]>;
+    getAvailability(request: protos.google.chat.v1.IGetAvailabilityRequest, options: CallOptions, callback: Callback<protos.google.chat.v1.IAvailability, protos.google.chat.v1.IGetAvailabilityRequest | null | undefined, {} | null | undefined>): void;
+    getAvailability(request: protos.google.chat.v1.IGetAvailabilityRequest, callback: Callback<protos.google.chat.v1.IAvailability, protos.google.chat.v1.IGetAvailabilityRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * Marks user as `ACTIVE` in Google Chat.
+     *
+     * Sets the user's availability state to `ACTIVE`. The `ACTIVE` state
+     * lasts until the specified expiration, at which point the user's state
+     * becomes `AWAY`. Note that if the user is actively using Chat, the `ACTIVE`
+     * state duration may extend beyond the provided expiration.
+     *
+     * This method only updates the authenticated user's availability.
+     *
+     * Requires [user
+     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+     * with [authorization
+     * scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+     *
+     *   - `https://www.googleapis.com/auth/chat.users.availability`
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   Required. The resource name of the availability to mark as active.
+     *   Format: users/{user}/availability
+     *
+     *   `{user}` is the id for the Person in the People API or Admin SDK directory
+     *   API. For example, `users/123456789`.
+     *
+     *   The user's email address or `me` can also be used as an alias to refer to
+     *   the caller.  For example, `users/user@example.com` or `users/me`.
+     * @param {google.protobuf.Timestamp} request.expireTime
+     *   The absolute timestamp when the ACTIVE state expires.
+     * @param {google.protobuf.Duration} request.ttl
+     *   The duration from the current time until the ACTIVE state expires.
+     *   Using a short TTL can effectively reset the user's state to be based
+     *   on activity after this brief duration.
+     * @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.Availability|Availability}.
+     *   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.mark_as_active.js</caption>
+     * region_tag:chat_v1_generated_ChatService_MarkAsActive_async
+     */
+    markAsActive(request?: protos.google.chat.v1.IMarkAsActiveRequest, options?: CallOptions): Promise<[
+        protos.google.chat.v1.IAvailability,
+        protos.google.chat.v1.IMarkAsActiveRequest | undefined,
+        {} | undefined
+    ]>;
+    markAsActive(request: protos.google.chat.v1.IMarkAsActiveRequest, options: CallOptions, callback: Callback<protos.google.chat.v1.IAvailability, protos.google.chat.v1.IMarkAsActiveRequest | null | undefined, {} | null | undefined>): void;
+    markAsActive(request: protos.google.chat.v1.IMarkAsActiveRequest, callback: Callback<protos.google.chat.v1.IAvailability, protos.google.chat.v1.IMarkAsActiveRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * Marks user as `AWAY` in Google Chat.
+     *
+     * Sets the user's state to away and is not affected by the user's
+     * activity.
+     *
+     * This method only updates the authenticated user's availability.
+     *
+     * Requires [user
+     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+     * with [authorization
+     * scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+     *
+     *   - `https://www.googleapis.com/auth/chat.users.availability`
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   Required. The resource name of the availability to mark as away.
+     *   Format: users/{user}/availability
+     *
+     *   `{user}` is the id for the Person in the People API or Admin SDK directory
+     *   API. For example, `users/123456789`.
+     *
+     *   The user's email address or `me` can also be used as an alias to refer to
+     *   the caller.  For example, `users/user@example.com` or `users/me`.
+     * @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.Availability|Availability}.
+     *   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.mark_as_away.js</caption>
+     * region_tag:chat_v1_generated_ChatService_MarkAsAway_async
+     */
+    markAsAway(request?: protos.google.chat.v1.IMarkAsAwayRequest, options?: CallOptions): Promise<[
+        protos.google.chat.v1.IAvailability,
+        protos.google.chat.v1.IMarkAsAwayRequest | undefined,
+        {} | undefined
+    ]>;
+    markAsAway(request: protos.google.chat.v1.IMarkAsAwayRequest, options: CallOptions, callback: Callback<protos.google.chat.v1.IAvailability, protos.google.chat.v1.IMarkAsAwayRequest | null | undefined, {} | null | undefined>): void;
+    markAsAway(request: protos.google.chat.v1.IMarkAsAwayRequest, callback: Callback<protos.google.chat.v1.IAvailability, protos.google.chat.v1.IMarkAsAwayRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * Marks user as `DO_NOT_DISTURB` in Google Chat.
+     *
+     * Sets a user's availability state to `DO_NOT_DISTURB` until a specified
+     * expiration time.
+     * When in `DO_NOT_DISTURB`, users typically won't receive notifications.
+     *
+     * This method only updates the authenticated user's availability.
+     *
+     * Requires [user
+     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+     * with [authorization
+     * scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+     *
+     *   - `https://www.googleapis.com/auth/chat.users.availability`
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   Required. The resource name of the availability to mark as Do Not Disturb.
+     *   Format: users/{user}/availability
+     *
+     *   `{user}` is the id for the Person in the People API or Admin SDK directory
+     *   API. For example, `users/123456789`.
+     *
+     *   The user's email address or `me` can also be used as an alias to refer to
+     *   the caller.  For example, `users/user@example.com` or `users/me`.
+     * @param {google.protobuf.Timestamp} request.expireTime
+     *   The absolute timestamp when the DND state expires.
+     * @param {google.protobuf.Duration} request.ttl
+     *   The duration from the current time until the DND state expires.
+     * @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.Availability|Availability}.
+     *   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.mark_as_do_not_disturb.js</caption>
+     * region_tag:chat_v1_generated_ChatService_MarkAsDoNotDisturb_async
+     */
+    markAsDoNotDisturb(request?: protos.google.chat.v1.IMarkAsDoNotDisturbRequest, options?: CallOptions): Promise<[
+        protos.google.chat.v1.IAvailability,
+        protos.google.chat.v1.IMarkAsDoNotDisturbRequest | undefined,
+        {} | undefined
+    ]>;
+    markAsDoNotDisturb(request: protos.google.chat.v1.IMarkAsDoNotDisturbRequest, options: CallOptions, callback: Callback<protos.google.chat.v1.IAvailability, protos.google.chat.v1.IMarkAsDoNotDisturbRequest | null | undefined, {} | null | undefined>): void;
+    markAsDoNotDisturb(request: protos.google.chat.v1.IMarkAsDoNotDisturbRequest, callback: Callback<protos.google.chat.v1.IAvailability, protos.google.chat.v1.IMarkAsDoNotDisturbRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * Updates availability information for a human user. Only the `custom_status`
+     * field can be updated through this method.
+     *
+     * This method only updates the authenticated user's availability.
+     *
+     * 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.users.availability`
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {google.chat.v1.Availability} request.availability
+     *   Required. The availability to update.
+     * @param {google.protobuf.FieldMask} request.updateMask
+     *   Required. The list of fields to update.
+     *   The only field that can be updated is `custom_status`.
+     * @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.Availability|Availability}.
+     *   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_availability.js</caption>
+     * region_tag:chat_v1_generated_ChatService_UpdateAvailability_async
+     */
+    updateAvailability(request?: protos.google.chat.v1.IUpdateAvailabilityRequest, options?: CallOptions): Promise<[
+        protos.google.chat.v1.IAvailability,
+        protos.google.chat.v1.IUpdateAvailabilityRequest | undefined,
+        {} | undefined
+    ]>;
+    updateAvailability(request: protos.google.chat.v1.IUpdateAvailabilityRequest, options: CallOptions, callback: Callback<protos.google.chat.v1.IAvailability, protos.google.chat.v1.IUpdateAvailabilityRequest | null | undefined, {} | null | undefined>): void;
+    updateAvailability(request: protos.google.chat.v1.IUpdateAvailabilityRequest, callback: Callback<protos.google.chat.v1.IAvailability, protos.google.chat.v1.IUpdateAvailabilityRequest | null | undefined, {} | null | undefined>): void;
     /**
      * Returns an event from a Google Chat space. The [event
      * payload](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.oneof_payload)
@@ -4687,6 +4923,21 @@ export declare class ChatServiceClient {
      * @returns {string} A string representing the attachment.
      */
     matchAttachmentFromAttachmentName(attachmentName: string): string | number;
+    /**
+     * Return a fully-qualified availability resource name string.
+     *
+     * @param {string} user
+     * @returns {string} Resource name string.
+     */
+    availabilityPath(user: string): string;
+    /**
+     * Parse the user from Availability resource.
+     *
+     * @param {string} availabilityName
+     *   A fully-qualified path representing Availability resource.
+     * @returns {string} A string representing the user.
+     */
+    matchUserFromAvailabilityName(availabilityName: string): string | number;
     /**
      * Return a fully-qualified customEmoji resource name string.
      *