@google-apps/chat 0.23.1 → 0.25.0

package/README.md

@@ -71,6 +71,7 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
 | delete section | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.delete_section.js) |
 | delete space | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.delete_space.js) |
 | find direct message | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.find_direct_message.js) |
+| find group chats | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.find_group_chats.js) |
 | get attachment | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_attachment.js) |
 | get custom emoji | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_custom_emoji.js) |
 | get membership | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_membership.js) |
@@ -99,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
@@ -133,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`)
@@ -143,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/action_status.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -717,6 +717,32 @@ service ChatService {
     };
   }
 
+  // Returns all spaces with `spaceType == GROUP_CHAT`, whose
+  // human memberships contain exactly the calling user, and the users specified
+  // in `FindGroupChatsRequest.users`. Only members that have joined the
+  // conversation are supported. For an example, see [Find group
+  // chats](https://developers.google.com/workspace/chat/find-group-chats).
+  //
+  // If the calling user blocks, or is blocked by, some users, and no spaces
+  // with the entire specified set of users are found, this method returns
+  // spaces that don't include the blocked or blocking users.
+  //
+  // The specified set of users must contain only human (non-app) memberships.
+  // A request that contains non-human users doesn't return any spaces.
+  //
+  // Requires [user
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+  // with one of the following [authorization
+  // scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
+  //
+  //   - `https://www.googleapis.com/auth/chat.memberships.readonly`
+  //   - `https://www.googleapis.com/auth/chat.memberships`
+  rpc FindGroupChats(FindGroupChatsRequest) returns (FindGroupChatsResponse) {
+    option (google.api.http) = {
+      get: "/v1/spaces:findGroupChats"
+    };
+  }
+
   // Creates a membership for the calling Chat app, a user, or a Google Group.
   // Creating memberships for other Chat apps isn't supported.
   // When creating a membership, if the specified member has their auto-accept

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -204,6 +204,10 @@ message Message {
   // `false`.
   bool thread_reply = 25 [(google.api.field_behavior) = OUTPUT_ONLY];
 
+  // Output only. Whether this is a silent message. Silent messages are messages
+  // where Chat suppresses push notifications for recipients.
+  bool silent = 46 [(google.api.field_behavior) = OUTPUT_ONLY];
+
   // Optional. A custom ID for the message. You can use field to identify a
   // message, or to get, delete, or update a message. To set a custom ID,
   // specify the
@@ -277,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.
 //
@@ -297,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.
@@ -646,6 +651,43 @@ message CreateMessageRequest {
   // For details, see [Name a
   // message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
   string message_id = 9 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Controls the notification behavior when the message is posted.
+  // To learn more, see [Force notifications or send silent
+  // messages](https://developer.google.com/workspace/chat/create-messages#force-notify-silent).
+  CreateMessageNotificationOptions create_message_notification_options = 10
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Options for the notification behavior when the message is posted.
+message CreateMessageNotificationOptions {
+  // The notification types options for the message.
+  enum NotificationType {
+    // Default behavior. Notification behavior is similar to when the human user
+    // sends the message using the Chat UI: no notification is sent to the
+    // human sender.
+    NOTIFICATION_TYPE_NONE = 0;
+
+    // Force notify recipients. This bypasses users' space notification settings
+    // and [Chat Do Not Disturb
+    // settings](https://support.google.com/chat/answer/9093489). This option
+    // does not bypass device-level Do Not Disturb settings.
+    //
+    // Requires [app authentication]
+    // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
+    NOTIFICATION_TYPE_FORCE_NOTIFY = 2;
+
+    // Silence the notification as if the recipients have [Chat Do Not
+    // Disturb](https://support.google.com/chat/answer/9093489) enabled or
+    // have muted the space.
+    //
+    // Requires [app authentication]
+    // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
+    NOTIFICATION_TYPE_SILENT = 3;
+  }
+
+  // The notification type for the message.
+  NotificationType notification_type = 1;
 }
 
 // Lists messages in the specified space, that the user is a member of.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
@@ -552,6 +552,65 @@ message FindDirectMessageRequest {
   string name = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
+// A request to get group chat spaces based on user resources.
+message FindGroupChatsRequest {
+  // Optional. Resource names of all human users in group chat with the calling
+  // user. Chat apps can't be included in the request.
+  //
+  // The maximum number of users that can be specified in a single request is
+  // `49`.
+  //
+  // Format: `users/{user}`, where `{user}` is either the `id` for the
+  // [person](https://developers.google.com/people/api/rest/v1/people) from the
+  // People API, or the `id` for the
+  // [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users)
+  // in the Directory API. For example, to find all group chats with the calling
+  // user and two other users, with People API profile IDs `123456789` and
+  // `987654321`, you can use `users/123456789` and `users/987654321`.
+  // You can also use the email as an alias for `{user}`. For example,
+  // `users/example@gmail.com` where `example@gmail.com` is the email of the
+  // Google Chat user.
+  repeated string users = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The maximum number of spaces to return. The service might return
+  // fewer than this value.
+  //
+  // If unspecified, at most 10 spaces are returned.
+  //
+  // The maximum value is 30. If you use a value more than 30, it's
+  // automatically changed to 30.
+  //
+  // Negative values return an `INVALID_ARGUMENT` error.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A page token, received from a previous call to find group chats.
+  // Provide this parameter to retrieve the subsequent page.
+  //
+  // When paginating, all other parameters provided should match the call that
+  // provided the token. Passing different values may lead to unexpected
+  // results.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Requested space view type. If unset, defaults to
+  // `SPACE_VIEW_RESOURCE_NAME_ONLY`. Requests that specify
+  // `SPACE_VIEW_EXPANDED` must include scopes that allow reading space data,
+  // for example,
+  // https://www.googleapis.com/auth/chat.spaces or
+  // https://www.googleapis.com/auth/chat.spaces.readonly.
+  SpaceView space_view = 4;
+}
+
+// A response containing group chat spaces with exactly the calling user and the
+// requested users.
+message FindGroupChatsResponse {
+  // List of spaces in the requested (or first) page.
+  repeated Space spaces = 1;
+
+  // A token that you can send as `pageToken` to retrieve the next page of
+  // results. If empty, there are no subsequent pages.
+  string next_page_token = 2;
+}
+
 // A request to update a single space.
 message UpdateSpaceRequest {
   // Required. Space with fields to be updated. `Space.name` must be
@@ -822,3 +881,24 @@ message CompleteImportSpaceResponse {
   // The import mode space.
   Space space = 1;
 }
+
+// A view that specifies which fields should be populated on the
+// [`Space`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces)
+// resource.
+// To ensure compatibility with future releases, we recommend that your code
+// account for additional values.
+enum SpaceView {
+  // The default / unset value.
+  SPACE_VIEW_UNSPECIFIED = 0;
+
+  // Populates only the Space resource name.
+  SPACE_VIEW_RESOURCE_NAME_ONLY = 3;
+
+  // Populates Space resource fields.  Note: the `permissionSettings` field
+  // will not be populated.
+  // Requests that specify SPACE_VIEW_EXPANDED must include scopes that allow
+  // reading space data, for example,
+  // https://www.googleapis.com/auth/chat.spaces or
+  // https://www.googleapis.com/auth/chat.spaces.readonly.
+  SPACE_VIEW_EXPANDED = 4;
+}

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.