@google-apps/chat 0.24.0 → 0.26.0

package/README.md

@@ -100,7 +100,6 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
 | update space notification setting | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.update_space_notification_setting.js) |
 | update space read state | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.update_space_read_state.js) |
 | upload attachment | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.upload_attachment.js) |
-| chat | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/snippet_metadata_google.chat.v1.json) |
 
 
 ## Supported Node.js Versions
@@ -134,7 +133,7 @@ More Information: [Google Cloud Platform Launch Stages][launch_stages]
 
 ## Contributing
 
-Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/CONTRIBUTING.md).
+Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/google-cloud-node/blob/main/CONTRIBUTING.md).
 
 Please note that this `README.md`
 and a variety of configuration files in this repository (including `.nycrc` and `tsconfig.json`)
@@ -144,7 +143,7 @@ are generated from a central template.
 
 Apache Version 2.0
 
-See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/LICENSE)
+See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/LICENSE)
 
 [shell_img]: https://gstatic.com/cloudssh/images/open-btn.png
 [projects]: https://console.cloud.google.com/project

package/build/protos/google/chat/v1/audience.proto

@@ -0,0 +1,48 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.chat.v1;
+
+option csharp_namespace = "Google.Apps.Chat.V1";
+option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
+option java_multiple_files = true;
+option java_outer_classname = "AudienceProto";
+option java_package = "com.google.chat.v1";
+option objc_class_prefix = "DYNAPIProto";
+option php_namespace = "Google\\Apps\\Chat\\V1";
+option ruby_package = "Google::Apps::Chat::V1";
+
+// A target audience in Google Chat. A target audience represents a group of
+// users within a Google Workspace organization, defined by an administrator.
+// Target audiences are used to configure access and visibility settings for
+// resources, such as making a space discoverable to a specific group of users.
+//
+// For more details, see [Target
+// audiences](https://support.google.com/a/answer/9934697) and [Make a space
+// discoverable to a target
+// audience](https://developers.google.com/workspace/chat/space-target-audience).
+message Audience {
+  // The resource name of the [target
+  // audience](https://support.google.com/a/answer/9934697) who can discover
+  // or join the space. For details, see [Make a space
+  // discoverable to a target
+  // audience](https://developers.google.com/workspace/chat/space-target-audience).
+  // Format: `audiences/{audience}`
+  //
+  // To use the default target audience for the Google Workspace organization,
+  // set to `audiences/default`.
+  string name = 1;
+}

package/build/protos/google/chat/v1/availability.proto

@@ -0,0 +1,232 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.chat.v1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/chat/v1/reaction.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Apps.Chat.V1";
+option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
+option java_multiple_files = true;
+option java_outer_classname = "AvailabilityProto";
+option java_package = "com.google.chat.v1";
+option objc_class_prefix = "DYNAPIProto";
+option php_namespace = "Google\\Apps\\Chat\\V1";
+option ruby_package = "Google::Apps::Chat::V1";
+
+// Represents a user's current availability information in Google Chat,
+// including their state (for example, Active, Away, Do Not Disturb) and any
+// custom status.
+message Availability {
+  option (google.api.resource) = {
+    type: "chat.googleapis.com/Availability"
+    pattern: "users/{user}/availability"
+    plural: "availabilities"
+    singular: "availability"
+  };
+
+  // Represents the current availability state of the user.
+  enum State {
+    // Default value. The state is unspecified.
+    STATE_UNSPECIFIED = 0;
+
+    // The user is currently active, based on recent activity.
+    ACTIVE = 1;
+
+    // The user is currently idle. This state indicates a period of inactivity
+    // after being ACTIVE, before potentially transitioning to AWAY.
+    IDLE = 2;
+
+    // The user is currently away. This can be either automatically set after
+    // a period of inactivity in ACTIVE or IDLE state, or it can be manually set
+    // by the user. When manually set via `MarkAsAway`, this state persists
+    // regardless of user activity.
+    AWAY = 3;
+
+    // The user is in Do Not Disturb state, which is manually set.
+    DO_NOT_DISTURB = 4;
+  }
+
+  // Identifier. Resource name of the user's availability.
+  //
+  // 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`.
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Output only. The user's current availability state.
+  State state = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Additional metadata associated with the user's availability state.
+  oneof state_metadata {
+    // Output only. Metadata if the user state is set to DO_NOT_DISTURB.
+    DoNotDisturbMetadata do_not_disturb_metadata = 3
+        [(google.api.field_behavior) = OUTPUT_ONLY];
+  }
+
+  // Optional. The user's custom status.
+  CustomStatus custom_status = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Represents a user's custom status in Google Chat.
+// This includes a short text message with an optional emoji that a user sets to
+// give more context about their availability.
+message CustomStatus {
+  // Required. The text of the custom status. This will be a string with maximum
+  // length of 64.
+  string text = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The emoji of the custom status. Only Unicode emojis are
+  // supported; custom emojis are not supported.
+  Emoji emoji = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // The expiration time of the custom status. It can be specified as either
+  // an absolute timestamp or a time-to-live duration.
+  oneof expiration {
+    // The timestamp when the custom status expires.
+    google.protobuf.Timestamp expire_time = 3;
+
+    // Input only. The time-to-live duration after which the custom status
+    // expires.
+    google.protobuf.Duration ttl = 4 [(google.api.field_behavior) = INPUT_ONLY];
+  }
+}
+
+// Metadata associated with the `DO_NOT_DISTURB` availability state,
+// specifying when the state is set to expire.
+message DoNotDisturbMetadata {
+  // Output only. Timestamp until which the user should be marked as
+  // DO_NOT_DISTURB. This can be maximum of 1 year in the future.
+  google.protobuf.Timestamp expiration_time = 1
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Request message for the `GetAvailability` method.
+message GetAvailabilityRequest {
+  // 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`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "chat.googleapis.com/Availability"
+    }
+  ];
+}
+
+// Request message for the `UpdateAvailability` method.
+message UpdateAvailabilityRequest {
+  // Required. The availability to update.
+  Availability availability = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The list of fields to update.
+  // The only field that can be updated is `custom_status`.
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for the `MarkAsActive` method.
+message MarkAsActiveRequest {
+  // 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`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "chat.googleapis.com/Availability"
+    }
+  ];
+
+  // The expiration for the ACTIVE availability state. The user will
+  // be marked as Away after expiration. If no expiration is provided, the
+  // ACTIVE state will expire 30 minutes from the current time.
+  oneof expiration {
+    // The absolute timestamp when the ACTIVE state expires.
+    google.protobuf.Timestamp expire_time = 2;
+
+    // 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.
+    google.protobuf.Duration ttl = 3;
+  }
+}
+
+// Request message for the `MarkAsAway` method.
+message MarkAsAwayRequest {
+  // 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`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "chat.googleapis.com/Availability"
+    }
+  ];
+}
+
+// Request message for the `MarkAsDoNotDisturb` method.
+message MarkAsDoNotDisturbRequest {
+  // 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`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "chat.googleapis.com/Availability"
+    }
+  ];
+
+  // Required. The expiration for the DND availability state. The user will be
+  // marked as Away after expiration. This can be at most 1 year from the
+  // current time.
+  oneof expiration {
+    // The absolute timestamp when the DND state expires.
+    google.protobuf.Timestamp expire_time = 2;
+
+    // The duration from the current time until the DND state expires.
+    google.protobuf.Duration ttl = 3;
+  }
+}

package/build/protos/google/chat/v1/chat_service.proto

@@ -19,6 +19,7 @@ package google.chat.v1;
 import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/chat/v1/attachment.proto";
+import "google/chat/v1/availability.proto";
 import "google/chat/v1/membership.proto";
 import "google/chat/v1/message.proto";
 import "google/chat/v1/reaction.proto";
@@ -74,6 +75,8 @@ service ChatService {
       "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,"
@@ -1083,6 +1086,108 @@ service ChatService {
     option (google.api.method_signature) = "name";
   }
 
+  // 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`
+  rpc GetAvailability(GetAvailabilityRequest) returns (Availability) {
+    option (google.api.http) = {
+      get: "/v1/{name=users/*/availability}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // 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`
+  rpc MarkAsActive(MarkAsActiveRequest) returns (Availability) {
+    option (google.api.http) = {
+      post: "/v1/{name=users/*/availability}:markAsActive"
+      body: "*"
+    };
+  }
+
+  // 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`
+  rpc MarkAsAway(MarkAsAwayRequest) returns (Availability) {
+    option (google.api.http) = {
+      post: "/v1/{name=users/*/availability}:markAsAway"
+      body: "*"
+    };
+  }
+
+  // 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`
+  rpc MarkAsDoNotDisturb(MarkAsDoNotDisturbRequest) returns (Availability) {
+    option (google.api.http) = {
+      post: "/v1/{name=users/*/availability}:markAsDoNotDisturb"
+      body: "*"
+    };
+  }
+
+  // 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`
+  rpc UpdateAvailability(UpdateAvailabilityRequest) returns (Availability) {
+    option (google.api.http) = {
+      patch: "/v1/{availability.name=users/*/availability}"
+      body: "availability"
+    };
+    option (google.api.method_signature) = "availability,update_mask";
+  }
+
   // Returns an event from a Google Chat space. The [event
   // payload](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.oneof_payload)
   // contains the most recent version of the resource that changed. For example,

package/build/protos/google/chat/v1/message.proto

@@ -281,10 +281,6 @@ message AttachedGif {
 
 // Information about a message that another message quotes.
 //
-// When you create a message, you can quote messages within the same
-// thread, or quote a root message to create a new root message.
-// However, you can't quote a message reply from a different thread.
-//
 // When you update a message, you can't add or replace the
 // `quotedMessageMetadata` field, but you can remove it.
 //
@@ -301,16 +297,21 @@ message QuotedMessageMetadata {
     // Reserved. This value is unused.
     QUOTE_TYPE_UNSPECIFIED = 0;
 
-    // If quote_type is `REPLY`, you can do the following:
+    // When `quote_type` is `REPLY`, you can do the following:
     //
     // * If you're replying in a thread, you can quote another message in that
     // thread.
     //
     // * If you're creating a root message, you can quote another root message
     // in that space.
-    //
-    // You can't quote a message reply from a different thread.
     REPLY = 1;
+
+    // When `quote_type` is `FORWARD`, you can quote a:
+    //
+    // * Message from a different space.
+    //
+    // * Message reply from a different thread in the same space.
+    FORWARD = 2;
   }
 
   // Required. Resource name of the message that is quoted.

package/build/protos/google/chat/v1/space.proto

@@ -18,6 +18,7 @@ package google.chat.v1;
 
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
+import "google/chat/v1/audience.proto";
 import "google/chat/v1/history_state.proto";
 import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
@@ -171,6 +172,42 @@ message Space {
     // Setting the target audience requires [user
     // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
     string audience = 3 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. Access permission settings for the space.
+    //
+    // To set the target audience when creating a space, specify the
+    // `accessSettings.audience` field in your request.
+    AccessPermissionSettings access_permission_settings = 5
+        [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // Access permission settings for a space.
+  message AccessPermissionSettings {
+    // Optional. Access permission setting for discovering the space.
+    AccessPermissionSetting discover_space_setting = 1
+        [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. Access permission setting for joining the space.
+    AccessPermissionSetting join_space_setting = 2
+        [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // An access permission setting.
+  message AccessPermissionSetting {
+    // Optional. Unordered list. Allowed principals for this permission.
+    repeated Principal principals = 1 [
+      (google.api.field_behavior) = OPTIONAL,
+      (google.api.field_behavior) = UNORDERED_LIST
+    ];
+  }
+
+  // A principal representing an entity granted access.
+  message Principal {
+    // The type of principal.
+    oneof principal_type {
+      // An audience.
+      Audience audience = 1;
+    }
   }
 
   // Predefined permission settings that you can only specify when creating a
@@ -665,6 +702,24 @@ message UpdateSpaceRequest {
   // 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.