google-apps-chat-v1 0.28.0 → 0.30.0

data/proto_docs/google/chat/v1/space.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2024 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.
@@ -298,6 +298,17 @@ module Google
           # @!attribute [rw] join_space_setting
           #   @return [::Google::Apps::Chat::V1::Space::AccessPermissionSetting]
           #     Optional. Access permission setting for joining the space.
+          # @!attribute [rw] view_space_membership_setting
+          #   @return [::Google::Apps::Chat::V1::Space::AccessPermissionSetting]
+          #     Optional. Access permission setting for viewing space membership.
+          #     Must be specified together with
+          #     `PermissionSettings.view_space_membership` in the update mask and request
+          #     body when updating who can view space membership. When granting view
+          #     access to a target audience, you must also grant
+          #     `PermissionSettings.view_space_membership` to all members in the same
+          #     request. To remove an existing target audience (for example, to restrict
+          #     view access to space managers or assistant managers only), specify an
+          #     empty `AccessPermissionSetting` (with no `principals`).
           class AccessPermissionSettings
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -338,7 +349,7 @@ module Google
           #     Optional. Setting for toggling space history on and off.
           # @!attribute [rw] use_at_mention_all
           #   @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
-          #     Optional. Setting for using @all in a space.
+          #     Optional. Setting for using `@all` in a space.
           # @!attribute [rw] manage_apps
           #   @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
           #     Optional. Setting for managing apps in a space.
@@ -351,6 +362,19 @@ module Google
           # @!attribute [rw] reply_messages
           #   @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
           #     Optional. Setting for replying to messages in a space.
+          # @!attribute [rw] view_space_membership
+          #   @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
+          #     Optional. Setting for viewing space membership.
+          #     Must be specified together with
+          #     `AccessPermissionSettings.view_space_membership_setting` in the update
+          #     mask and request body when updating who can view space membership.
+          #     When restricting view access to specific roles (for example, space
+          #     managers or assistant managers only), specify the desired role
+          #     permissions here and provide an empty
+          #     `AccessPermissionSettings.view_space_membership_setting` in the same
+          #     request. If a target audience is configured in
+          #     `AccessPermissionSettings.view_space_membership_setting`, this setting
+          #     must be granted to all members.
           class PermissionSettings
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -464,12 +488,24 @@ module Google
         #     field will be ignored.
         # @!attribute [rw] request_id
         #   @return [::String]
-        #     Optional. A unique identifier for this request.
-        #     A random UUID is recommended.
-        #     Specifying an existing request ID returns the space created with that ID
-        #     instead of creating a new space.
-        #     Specifying an existing request ID from the same Chat app with a different
-        #     authenticated user returns an error.
+        #     Optional. A unique ID for this request. A random UUID is recommended.
+        #     Specifying a request ID makes the request idempotent, which ensures that
+        #     multiple identical requests with the same request ID result in only a
+        #     single space being created. Subsequent requests with the same request ID
+        #     return the existing space and do not update the space, even if the
+        #     requested details differ from the current state.
+        #
+        #     To use this field effectively:
+        #
+        #     - Ensure that subsequent requests are identical and use the same
+        #     authentication credentials as the original request.
+        #     - If a space was already created with the provided request ID, the request
+        #     returns that space. Note that the returned space might not be fully
+        #     populated; the API echoes the space in your request with the
+        #     system-assigned resource name populated. To retrieve the latest metadata
+        #     for the space, call `GetSpace`.
+        #     - Reusing an existing request ID with a different authenticated user
+        #     results in an error.
         class CreateSpaceRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -715,6 +751,7 @@ module Google
         #
         #     - `access_settings.access_permission_settings.discoverSpaceSetting`
         #     - `access_settings.access_permission_settings.joinSpaceSetting`
+        #     - `access_settings.access_permission_settings.viewSpaceMembershipSetting`
         #
         #     `permission_settings`: Supports changing the
         #     [permission settings](https://support.google.com/chat/answer/13340792)
@@ -731,6 +768,7 @@ module Google
         #     - `permission_settings.manageApps`
         #     - `permission_settings.manageWebhooks`
         #     - `permission_settings.replyMessages`
+        #     - `permission_settings.viewSpaceMembership`
         # @!attribute [rw] use_admin_access
         #   @return [::Boolean]
         #     Optional. When `true`, the method runs using the user's Google Workspace
@@ -763,9 +801,6 @@ module Google
         #     Requires either the `chat.admin.spaces.readonly` or `chat.admin.spaces`
         #     [OAuth 2.0
         #     scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).
-        #
-        #     This method currently only supports admin access, thus only `true` is
-        #     accepted for this field.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     The maximum number of spaces to return. The service may return fewer than
@@ -773,8 +808,9 @@ module Google
         #
         #     If unspecified, at most 100 spaces are returned.
         #
-        #     The maximum value is 1000. If you use a value more than 1000, it's
-        #     automatically changed to 1000.
+        #     The maximum value is 1000 when `useAdminAccess` is set to `true`.
+        #     Otherwise, the maximum value is 100. If you use a value more than the
+        #     maximum value, it's automatically changed to the maximum value.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     A token, received from the previous search spaces call. Provide this
@@ -787,7 +823,8 @@ module Google
         #   @return [::String]
         #     Required. A search query.
         #
-        #     You can search by using the following parameters:
+        #     You can search by using the following parameters when `useAdminAccess`
+        #     is set to `true`:
         #
         #     - `create_time`
         #     - `customer`
@@ -797,18 +834,27 @@ module Google
         #     - `space_history_state`
         #     - `space_type`
         #
+        #     When `useAdminAccess` is set to `false`:
+        #
+        #     - `display_name`
+        #     - `external_user_allowed`
+        #     - `space_type`
+        #
         #     `create_time` and `last_active_time` accept a timestamp in
         #     [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339) format and the supported
         #     comparison operators are: `=`, `<`, `>`, `<=`, `>=`.
         #
-        #     `customer` is required and is used to indicate which customer
-        #     to fetch spaces from. `customers/my_customer` is the only supported value.
+        #     `customer` is required when `useAdminAccess` is set to `true`, and is
+        #     used to indicate which customer to fetch spaces from.
+        #     `customers/my_customer` is the only supported value.
         #
         #     `display_name` only accepts the `HAS` (`:`) operator. The text to
         #     match is first tokenized into tokens and each token is prefix-matched
         #     case-insensitively and independently as a substring anywhere in the space's
         #     `display_name`. For example, `Fun Eve` matches `Fun event` or `The
-        #     evening was fun`, but not `notFun event` or `even`.
+        #     evening was fun`, but not `notFun event` or `even`. When `useAdminAccess`
+        #     is set to `false`, `display_name` is required to retrieve meaningful
+        #     results. Otherwise, the default behavior is to return an empty response.
         #
         #     `external_user_allowed` accepts either `true` or `false`.
         #
@@ -831,7 +877,8 @@ module Google
         #     < "2022-01-01T00:00:00+00:00" AND last_active_time >
         #     "2023-01-01T00:00:00+00:00"`.
         #
-        #     The following example queries are valid:
+        #     The following example queries are valid when `useAdminAccess` is set to
+        #     `true`:
         #
         #     ```
         #     customer = "customers/my_customer" AND space_type = "SPACE"
@@ -853,6 +900,26 @@ module Google
         #     "2020-01-01T00:00:00+00:00") AND (external_user_allowed = "true") AND
         #     (space_history_state = "HISTORY_ON" OR space_history_state = "HISTORY_OFF")
         #     ```
+        #
+        #     The following example queries are valid when `useAdminAccess` is set to
+        #     `false`:
+        #
+        #     ```
+        #     display_name:"Hello World" AND space_type = "SPACE"
+        #
+        #     (display_name:"Hello" OR display_name:"Fun") AND space_type = "SPACE"
+        #
+        #     (external_user_allowed = "true" AND space_type = "SPACE") // Returns an
+        #     empty response.
+        #
+        #     (external_user_allowed = "true" AND display_name:"Hello" AND space_type =
+        #     "SPACE")
+        #     ```
+        #
+        #     The maximum query length is 1,000 characters.
+        #
+        #     Invalid queries are rejected by the server with an `INVALID_ARGUMENT`
+        #     error.
         # @!attribute [rw] order_by
         #   @return [::String]
         #     Optional. How the list of spaces is ordered.
@@ -865,13 +932,17 @@ module Google
         #     any topic of this space.
         #     - `create_time` — Denotes the time of the space creation.
         #
+        #     When `useAdminAccess` is `false`, only `create_time` and `relevance` are
+        #     supported for ordering. Only `DESC` is supported for these fields in
+        #     non-admin searches.
+        #
         #     Valid ordering operation values are:
         #
         #     - `ASC` for ascending. Default value.
         #
         #     - `DESC` for descending.
         #
-        #     The supported syntax are:
+        #     The supported syntax are when `useAdminAccess` is set to `true`:
         #
         #     - `membership_count.joined_direct_human_user_count DESC`
         #     - `membership_count.joined_direct_human_user_count ASC`
@@ -879,6 +950,12 @@ module Google
         #     - `last_active_time ASC`
         #     - `create_time DESC`
         #     - `create_time ASC`
+        #
+        #     When `useAdminAccess` is set to `false`:
+        #
+        #     - `create_time DESC`
+        #     - `relevance DESC`
+        #        [Developer Preview](https://developers.google.com/workspace/preview).
         class SearchSpacesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -886,19 +963,39 @@ module Google
 
         # Response with a list of spaces corresponding to the search spaces request.
         # @!attribute [rw] spaces
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Array<::Google::Apps::Chat::V1::Space>]
-        #     A page of the requested spaces.
+        #     Deprecated: Please use the new `results` field instead.
+        #     A page of the requested spaces. This field will be populated only when
+        #     `useAdminAccess` is set to `true` and deprecated in favor of the new
+        #     `results` field.
         # @!attribute [rw] next_page_token
         #   @return [::String]
         #     A token that can be used to retrieve the next page. If this field is empty,
         #     there are no subsequent pages.
+        #
+        #     Only populated when `useAdminAccess` is set to `true`.
         # @!attribute [rw] total_size
         #   @return [::Integer]
         #     The total number of spaces that match the query, across all pages. If the
         #     result is over 10,000 spaces, this value is an estimate.
+        #
+        #     Only populated when `useAdminAccess` is set to `true`.
+        # @!attribute [r] results
+        #   @return [::Array<::Google::Apps::Chat::V1::SearchSpacesResponse::SearchSpaceResult>]
+        #     Output only. The list of search results that matched the query.
         class SearchSpacesResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # A single result item from a space search.
+          # @!attribute [r] space
+          #   @return [::Google::Apps::Chat::V1::Space]
+          #     Output only. The matched space.
+          class SearchSpaceResult
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
 
         # Request for deleting a space.

data/proto_docs/google/chat/v1/space_event.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2024 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.

data/proto_docs/google/chat/v1/space_notification_setting.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# 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.
@@ -42,16 +42,16 @@ module Google
             # Reserved.
             NOTIFICATION_SETTING_UNSPECIFIED = 0
 
-            # Notifications are triggered by @mentions, followed threads, first
+            # Notifications are triggered by `@mentions`, followed threads, first
             # message of new threads. All new threads are automatically followed,
             # unless manually unfollowed by the user.
             ALL = 1
 
-            # The notification is triggered by @mentions, followed threads, first
+            # The notification is triggered by `@mentions`, followed threads, first
             # message of new threads. Not available for 1:1 direct messages.
             MAIN_CONVERSATIONS = 2
 
-            # The notification is triggered by @mentions, followed threads. Not
+            # The notification is triggered by `@mentions`, followed threads. Not
             # available for 1:1 direct messages.
             FOR_YOU = 3
 

data/proto_docs/google/chat/v1/space_read_state.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2024 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.

data/proto_docs/google/chat/v1/space_setup.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2024 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.
@@ -49,12 +49,24 @@ module Google
         #     of creating a new space.
         # @!attribute [rw] request_id
         #   @return [::String]
-        #     Optional. A unique identifier for this request.
-        #     A random UUID is recommended.
-        #     Specifying an existing request ID returns the space created with that ID
-        #     instead of creating a new space.
-        #     Specifying an existing request ID from the same Chat app with a different
-        #     authenticated user returns an error.
+        #     Optional. A unique ID for this request. A random UUID is recommended.
+        #     Specifying a request ID makes the request idempotent, which ensures that
+        #     multiple identical requests with the same request ID result in only a
+        #     single space being created. Subsequent requests with the same request ID
+        #     return the existing space and do not update the space, even if the
+        #     requested details differ from the current state.
+        #
+        #     To use this field effectively:
+        #
+        #     - Ensure that subsequent requests are identical and use the same
+        #     authentication credentials as the original request.
+        #     - If a space was already created with the provided request ID, the request
+        #     returns that space. Note that the returned space might not be fully
+        #     populated; the API echoes the space in your request with the
+        #     system-assigned resource name populated. To retrieve the latest metadata
+        #     for the space, call `GetSpace`.
+        #     - Reusing an existing request ID with a different authenticated user
+        #     results in an error.
         # @!attribute [rw] memberships
         #   @return [::Array<::Google::Apps::Chat::V1::Membership>]
         #     Optional. The Google Chat users or groups to invite to join the space. Omit

data/proto_docs/google/chat/v1/thread_read_state.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2024 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.

data/proto_docs/google/chat/v1/user.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2024 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.

data/proto_docs/google/chat/v1/widgets.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2024 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.

data/proto_docs/google/protobuf/duration.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2024 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.

data/proto_docs/google/protobuf/empty.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2024 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.

data/proto_docs/google/protobuf/field_mask.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2024 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.

data/proto_docs/google/protobuf/timestamp.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2024 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.
@@ -110,14 +110,15 @@ module Google
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [::Integer]
-    #     Represents seconds of UTC time since Unix epoch
-    #     1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
-    #     9999-12-31T23:59:59Z inclusive.
+    #     Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must
+    #     be between -315576000000 and 315576000000 inclusive (which corresponds to
+    #     0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z).
     # @!attribute [rw] nanos
     #   @return [::Integer]
-    #     Non-negative fractions of a second at nanosecond resolution. Negative
-    #     second values with fractions must still have non-negative nanos values
-    #     that count forward in time. Must be from 0 to 999,999,999
+    #     Non-negative fractions of a second at nanosecond resolution. This field is
+    #     the nanosecond portion of the duration, not an alternative to seconds.
+    #     Negative second values with fractions must still have non-negative nanos
+    #     values that count forward in time. Must be between 0 and 999,999,999
     #     inclusive.
     class Timestamp
       include ::Google::Protobuf::MessageExts

data/proto_docs/google/protobuf/wrappers.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2024 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.

data/proto_docs/google/rpc/code.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2024 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.

data/proto_docs/google/type/color.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2024 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.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apps-chat-v1
 version: !ruby/object:Gem::Version
-  version: 0.28.0
+  version: 0.30.0
 platform: ruby
 authors:
 - Google LLC
@@ -84,6 +84,7 @@ files:
 - lib/google/apps/chat/v1/version.rb
 - lib/google/chat/v1/action_status_pb.rb
 - lib/google/chat/v1/annotation_pb.rb
+- lib/google/chat/v1/app_command_metadata_pb.rb
 - lib/google/chat/v1/attachment_pb.rb
 - lib/google/chat/v1/audience_pb.rb
 - lib/google/chat/v1/availability_pb.rb
@@ -94,9 +95,11 @@ files:
 - lib/google/chat/v1/event_payload_pb.rb
 - lib/google/chat/v1/group_pb.rb
 - lib/google/chat/v1/history_state_pb.rb
+- lib/google/chat/v1/markup_syntax_pb.rb
 - lib/google/chat/v1/matched_url_pb.rb
 - lib/google/chat/v1/membership_pb.rb
 - lib/google/chat/v1/message_pb.rb
+- lib/google/chat/v1/message_pin_pb.rb
 - lib/google/chat/v1/reaction_pb.rb
 - lib/google/chat/v1/section_pb.rb
 - lib/google/chat/v1/slash_command_pb.rb
@@ -117,6 +120,7 @@ files:
 - proto_docs/google/apps/card/v1/card.rb
 - proto_docs/google/chat/v1/action_status.rb
 - proto_docs/google/chat/v1/annotation.rb
+- proto_docs/google/chat/v1/app_command_metadata.rb
 - proto_docs/google/chat/v1/attachment.rb
 - proto_docs/google/chat/v1/audience.rb
 - proto_docs/google/chat/v1/availability.rb
@@ -125,9 +129,11 @@ files:
 - proto_docs/google/chat/v1/event_payload.rb
 - proto_docs/google/chat/v1/group.rb
 - proto_docs/google/chat/v1/history_state.rb
+- proto_docs/google/chat/v1/markup_syntax.rb
 - proto_docs/google/chat/v1/matched_url.rb
 - proto_docs/google/chat/v1/membership.rb
 - proto_docs/google/chat/v1/message.rb
+- proto_docs/google/chat/v1/message_pin.rb
 - proto_docs/google/chat/v1/reaction.rb
 - proto_docs/google/chat/v1/section.rb
 - proto_docs/google/chat/v1/slash_command.rb