google-apis-chat_v1 0.149.0 → 0.151.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2aedfbf1c6b3d1fc132d1538a517f01c24ca6aecfb9f448495c2d3686caf8b25
-  data.tar.gz: 1a93ac08861808090ba2bc440d52a9d2c41294776c3a4e0a0d9ff5a353e647d1
+  metadata.gz: 599f0e59925b2055ca839f9b60ab29dcdf0a7d2d5e13f5cf2066b20c3bd4b3eb
+  data.tar.gz: 8af2d5d776c4fc19c21871354d0f540ac94292788c5940b634259e55bc30d301
 SHA512:
-  metadata.gz: d09ab92a5e027b7634204dc5517757bf6d54634da00ae77c3f55c2d6388acd691a7e9f392f2b71c0aa088467ab159eaff3c777d0a9f70a5748b6f71f6f64378b
-  data.tar.gz: 22174968827440265357f1671f24422f5ae69f5825f0faa3f207c14e446dc132442eeab0ab88a622911796d81281e01ec4b2c5bb64c97989f55241608e2d004f
+  metadata.gz: 3a91fade319d725c1ba44bae43c5c5e1ce9e0749507d3338217df718e0fec520461ed7c9734defb20f47807bab513a57cf8feb7f62dd922176bfa29e69f16af8
+  data.tar.gz: 0ce66f2bd7c09db392502cf221b5a696c94961bdc7ba8f15898e60332dc2d89a0af1d7bac9feb8ab8daaf3178257563704e29dfe243316640ff75eb03c07b713

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-chat_v1
 
+### v0.151.0 (2026-07-19)
+
+* Regenerated from discovery document revision 20260714
+
+### v0.150.0 (2026-06-28)
+
+* Regenerated from discovery document revision 20260623
+
 ### v0.149.0 (2026-06-14)
 
 * Regenerated from discovery document revision 20260607

data/lib/google/apis/chat_v1/classes.rb

@@ -22,11 +22,60 @@ module Google
   module Apis
     module ChatV1
       
+      # An access permission setting.
+      class AccessPermissionSetting
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Unordered list. Allowed principals for this permission.
+        # Corresponds to the JSON property `principals`
+        # @return [Array<Google::Apis::ChatV1::Principal>]
+        attr_accessor :principals
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @principals = args[:principals] if args.key?(:principals)
+        end
+      end
+      
+      # Access permission settings for a space.
+      class AccessPermissionSettings
+        include Google::Apis::Core::Hashable
+      
+        # An access permission setting.
+        # Corresponds to the JSON property `discoverSpaceSetting`
+        # @return [Google::Apis::ChatV1::AccessPermissionSetting]
+        attr_accessor :discover_space_setting
+      
+        # An access permission setting.
+        # Corresponds to the JSON property `joinSpaceSetting`
+        # @return [Google::Apis::ChatV1::AccessPermissionSetting]
+        attr_accessor :join_space_setting
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @discover_space_setting = args[:discover_space_setting] if args.key?(:discover_space_setting)
+          @join_space_setting = args[:join_space_setting] if args.key?(:join_space_setting)
+        end
+      end
+      
       # Represents the [access setting](https://support.google.com/chat/answer/
       # 11971020) of the space.
       class AccessSettings
         include Google::Apis::Core::Hashable
       
+        # Access permission settings for a space.
+        # Corresponds to the JSON property `accessPermissionSettings`
+        # @return [Google::Apis::ChatV1::AccessPermissionSettings]
+        attr_accessor :access_permission_settings
+      
         # Output only. Indicates the access state of the space.
         # Corresponds to the JSON property `accessState`
         # @return [String]
@@ -59,6 +108,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @access_permission_settings = args[:access_permission_settings] if args.key?(:access_permission_settings)
           @access_state = args[:access_state] if args.key?(:access_state)
           @audience = args[:audience] if args.key?(:audience)
         end
@@ -389,6 +439,81 @@ module Google
         end
       end
       
+      # 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).
+      class Audience
+        include Google::Apis::Core::Hashable
+      
+        # 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`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
+      # Represents a user's current availability information in Google Chat, including
+      # their state (for example, Active, Away, Do Not Disturb) and any custom status.
+      class Availability
+        include Google::Apis::Core::Hashable
+      
+        # 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.
+        # Corresponds to the JSON property `customStatus`
+        # @return [Google::Apis::ChatV1::CustomStatus]
+        attr_accessor :custom_status
+      
+        # Metadata associated with the `DO_NOT_DISTURB` availability state, specifying
+        # when the state is set to expire.
+        # Corresponds to the JSON property `doNotDisturbMetadata`
+        # @return [Google::Apis::ChatV1::DoNotDisturbMetadata]
+        attr_accessor :do_not_disturb_metadata
+      
+        # 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`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Output only. The user's current availability state.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @custom_status = args[:custom_status] if args.key?(:custom_status)
+          @do_not_disturb_metadata = args[:do_not_disturb_metadata] if args.key?(:do_not_disturb_metadata)
+          @name = args[:name] if args.key?(:name)
+          @state = args[:state] if args.key?(:state)
+        end
+      end
+      
       # A button. Can be a text button or an image button.
       class Button
         include Google::Apis::Core::Hashable
@@ -1050,6 +1175,46 @@ module Google
         end
       end
       
+      # 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.
+      class CustomStatus
+        include Google::Apis::Core::Hashable
+      
+        # An emoji that is used as a reaction to a message.
+        # Corresponds to the JSON property `emoji`
+        # @return [Google::Apis::ChatV1::Emoji]
+        attr_accessor :emoji
+      
+        # The timestamp when the custom status expires.
+        # Corresponds to the JSON property `expireTime`
+        # @return [String]
+        attr_accessor :expire_time
+      
+        # Required. The text of the custom status. This will be a string with maximum
+        # length of 64.
+        # Corresponds to the JSON property `text`
+        # @return [String]
+        attr_accessor :text
+      
+        # Input only. The time-to-live duration after which the custom status expires.
+        # Corresponds to the JSON property `ttl`
+        # @return [String]
+        attr_accessor :ttl
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @emoji = args[:emoji] if args.key?(:emoji)
+          @expire_time = args[:expire_time] if args.key?(:expire_time)
+          @text = args[:text] if args.key?(:text)
+          @ttl = args[:ttl] if args.key?(:ttl)
+        end
+      end
+      
       # Date input values.
       class DateInput
         include Google::Apis::Core::Hashable
@@ -1345,6 +1510,27 @@ module Google
         end
       end
       
+      # Metadata associated with the `DO_NOT_DISTURB` availability state, specifying
+      # when the state is set to expire.
+      class DoNotDisturbMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Output only. Timestamp until which the user should be marked as DO_NOT_DISTURB.
+        # This can be maximum of 1 year in the future.
+        # Corresponds to the JSON property `expirationTime`
+        # @return [String]
+        attr_accessor :expiration_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @expiration_time = args[:expiration_time] if args.key?(:expiration_time)
+        end
+      end
+      
       # A reference to the data of a drive attachment.
       class DriveDataRef
         include Google::Apis::Core::Hashable
@@ -4877,6 +5063,71 @@ module Google
         end
       end
       
+      # Request message for the `MarkAsActive` method.
+      class MarkAsActiveRequest
+        include Google::Apis::Core::Hashable
+      
+        # The absolute timestamp when the ACTIVE state expires.
+        # Corresponds to the JSON property `expireTime`
+        # @return [String]
+        attr_accessor :expire_time
+      
+        # 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.
+        # Corresponds to the JSON property `ttl`
+        # @return [String]
+        attr_accessor :ttl
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @expire_time = args[:expire_time] if args.key?(:expire_time)
+          @ttl = args[:ttl] if args.key?(:ttl)
+        end
+      end
+      
+      # Request message for the `MarkAsAway` method.
+      class MarkAsAwayRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Request message for the `MarkAsDoNotDisturb` method.
+      class MarkAsDoNotDisturbRequest
+        include Google::Apis::Core::Hashable
+      
+        # The absolute timestamp when the DND state expires.
+        # Corresponds to the JSON property `expireTime`
+        # @return [String]
+        attr_accessor :expire_time
+      
+        # The duration from the current time until the DND state expires.
+        # Corresponds to the JSON property `ttl`
+        # @return [String]
+        attr_accessor :ttl
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @expire_time = args[:expire_time] if args.key?(:expire_time)
+          @ttl = args[:ttl] if args.key?(:ttl)
+        end
+      end
+      
       # A matched URL in a Chat message. Chat apps can preview matched URLs. For more
       # information, see [Preview links](https://developers.google.com/chat/how-tos/
       # preview-links).
@@ -5793,6 +6044,31 @@ module Google
         end
       end
       
+      # A principal representing an entity granted access.
+      class Principal
+        include Google::Apis::Core::Hashable
+      
+        # 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).
+        # Corresponds to the JSON property `audience`
+        # @return [Google::Apis::ChatV1::Audience]
+        attr_accessor :audience
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @audience = args[:audience] if args.key?(:audience)
+        end
+      end
+      
       # Information about a message that another message quotes. When you update a
       # message, you can't add or replace the `quotedMessageMetadata` field, but you
       # can remove it. For example usage, see [Quote another message](https://

data/lib/google/apis/chat_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module ChatV1
       # Version of the google-apis-chat_v1 gem
-      GEM_VERSION = "0.149.0"
+      GEM_VERSION = "0.151.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.19.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20260607"
+      REVISION = "20260714"
     end
   end
 end

data/lib/google/apis/chat_v1/representations.rb

@@ -22,6 +22,18 @@ module Google
   module Apis
     module ChatV1
       
+      class AccessPermissionSetting
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AccessPermissionSettings
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AccessSettings
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -82,6 +94,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Audience
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Availability
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Button
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -178,6 +202,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CustomStatus
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class DateInput
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -214,6 +244,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class DoNotDisturbMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class DriveDataRef
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -658,6 +694,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class MarkAsActiveRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class MarkAsAwayRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class MarkAsDoNotDisturbRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class MatchedUrl
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -814,6 +868,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Principal
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class QuotedMessageMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1042,9 +1102,29 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AccessPermissionSetting
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :principals, as: 'principals', class: Google::Apis::ChatV1::Principal, decorator: Google::Apis::ChatV1::Principal::Representation
+      
+        end
+      end
+      
+      class AccessPermissionSettings
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :discover_space_setting, as: 'discoverSpaceSetting', class: Google::Apis::ChatV1::AccessPermissionSetting, decorator: Google::Apis::ChatV1::AccessPermissionSetting::Representation
+      
+          property :join_space_setting, as: 'joinSpaceSetting', class: Google::Apis::ChatV1::AccessPermissionSetting, decorator: Google::Apis::ChatV1::AccessPermissionSetting::Representation
+      
+        end
+      end
+      
       class AccessSettings
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :access_permission_settings, as: 'accessPermissionSettings', class: Google::Apis::ChatV1::AccessPermissionSettings, decorator: Google::Apis::ChatV1::AccessPermissionSettings::Representation
+      
           property :access_state, as: 'accessState'
           property :audience, as: 'audience'
         end
@@ -1142,6 +1222,25 @@ module Google
         end
       end
       
+      class Audience
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+        end
+      end
+      
+      class Availability
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :custom_status, as: 'customStatus', class: Google::Apis::ChatV1::CustomStatus, decorator: Google::Apis::ChatV1::CustomStatus::Representation
+      
+          property :do_not_disturb_metadata, as: 'doNotDisturbMetadata', class: Google::Apis::ChatV1::DoNotDisturbMetadata, decorator: Google::Apis::ChatV1::DoNotDisturbMetadata::Representation
+      
+          property :name, as: 'name'
+          property :state, as: 'state'
+        end
+      end
+      
       class Button
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1295,6 +1394,17 @@ module Google
         end
       end
       
+      class CustomStatus
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :emoji, as: 'emoji', class: Google::Apis::ChatV1::Emoji, decorator: Google::Apis::ChatV1::Emoji::Representation
+      
+          property :expire_time, as: 'expireTime'
+          property :text, as: 'text'
+          property :ttl, as: 'ttl'
+        end
+      end
+      
       class DateInput
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1363,6 +1473,13 @@ module Google
         end
       end
       
+      class DoNotDisturbMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :expiration_time, as: 'expirationTime'
+        end
+      end
+      
       class DriveDataRef
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2193,6 +2310,28 @@ module Google
         end
       end
       
+      class MarkAsActiveRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :expire_time, as: 'expireTime'
+          property :ttl, as: 'ttl'
+        end
+      end
+      
+      class MarkAsAwayRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class MarkAsDoNotDisturbRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :expire_time, as: 'expireTime'
+          property :ttl, as: 'ttl'
+        end
+      end
+      
       class MatchedUrl
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2464,6 +2603,14 @@ module Google
         end
       end
       
+      class Principal
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :audience, as: 'audience', class: Google::Apis::ChatV1::Audience, decorator: Google::Apis::ChatV1::Audience::Representation
+      
+        end
+      end
+      
       class QuotedMessageMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/chat_v1/service.rb

@@ -784,11 +784,24 @@ module Google
         #   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.
-        #   audience` is not supported with `useAdminAccess`. `permission_settings`:
-        #   Supports changing the [permission settings](https://support.google.com/chat/
-        #   answer/13340792) of a space. When updating permission settings, you can only
-        #   specify `permissionSettings` field masks; you cannot update other field masks
-        #   at the same time. The supported field masks include: - `permission_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. When updating permission settings, you can only specify `
+        #   permissionSettings` field masks; you cannot update other field masks at the
+        #   same time. The supported field masks include: - `permission_settings.
         #   manageMembersAndGroups` - `permission_settings.modifySpaceDetails` - `
         #   permission_settings.toggleHistory` - `permission_settings.useAtMentionAll` - `
         #   permission_settings.manageApps` - `permission_settings.manageWebhooks` - `
@@ -837,6 +850,7 @@ module Google
         # chat/search-manage-admin). When `use_admin_access` is set to `false`, the
         # results are limited to spaces where the calling user is a joined member. To
         # search with administrator privileges, set `use_admin_access` to `true`.
+        # Setting `use_admin_access` to `false` is available under Developer Preview.
         # Supports the following types of [authentication](https://developers.google.com/
         # workspace/chat/authenticate-authorize): - [User authentication](https://
         # developers.google.com/workspace/chat/authenticate-authorize-chat-user) with
@@ -876,18 +890,19 @@ module Google
         #   when `useAdminAccess` is set to `true`: - `create_time` - `customer` - `
         #   display_name` - `external_user_allowed` - `last_active_time` - `
         #   space_history_state` - `space_type` When `useAdminAccess` is set to `false`: -
-        #   `display_name` - `external_user_allowed` `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. `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`.
-        #   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`. `
+        #   `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 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`. 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`. `
         #   space_history_state` only accepts values from the [`historyState`] (https://
         #   developers.google.com/workspace/chat/api/reference/rest/v1/spaces#Space.
         #   HistoryState) field of a `space` resource. `space_type` is required and the
@@ -912,16 +927,20 @@ module Google
         #   00:00" AND create_time < "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" (
-        #   display_name:"Hello" OR display_name:"Fun") (external_user_allowed = "true") (
-        #   external_user_allowed = "true" AND display_name:"Hello") ```
+        #   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") ```
         # @param [Boolean] use_admin_access
         #   When `true`, the method runs using the user's Google Workspace administrator
         #   privileges. The calling user must be a Google Workspace administrator with the
         #   [manage chat and spaces conversations privilege](https://support.google.com/a/
         #   answer/13369245). 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).
+        #   authenticate-authorize#chat-api-scopes). Setting `use_admin_access` to `false`
+        #   is available under Developer Preview. [Developer Preview](https://developers.
+        #   google.com/workspace/preview).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2156,6 +2175,226 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # 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 [String] 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 [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ChatV1::Availability] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ChatV1::Availability]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_user_availability(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::ChatV1::Availability::Representation
+          command.response_class = Google::Apis::ChatV1::Availability
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # 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 [String] 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::Apis::ChatV1::MarkAsActiveRequest] mark_as_active_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ChatV1::Availability] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ChatV1::Availability]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def mark_availability_as_active(name, mark_as_active_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:markAsActive', options)
+          command.request_representation = Google::Apis::ChatV1::MarkAsActiveRequest::Representation
+          command.request_object = mark_as_active_request_object
+          command.response_representation = Google::Apis::ChatV1::Availability::Representation
+          command.response_class = Google::Apis::ChatV1::Availability
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # 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 [String] 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 [Google::Apis::ChatV1::MarkAsAwayRequest] mark_as_away_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ChatV1::Availability] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ChatV1::Availability]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def mark_availability_as_away(name, mark_as_away_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:markAsAway', options)
+          command.request_representation = Google::Apis::ChatV1::MarkAsAwayRequest::Representation
+          command.request_object = mark_as_away_request_object
+          command.response_representation = Google::Apis::ChatV1::Availability::Representation
+          command.response_class = Google::Apis::ChatV1::Availability
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # 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 [String] 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::Apis::ChatV1::MarkAsDoNotDisturbRequest] mark_as_do_not_disturb_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ChatV1::Availability] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ChatV1::Availability]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def mark_availability_as_do_not_disturb(name, mark_as_do_not_disturb_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:markAsDoNotDisturb', options)
+          command.request_representation = Google::Apis::ChatV1::MarkAsDoNotDisturbRequest::Representation
+          command.request_object = mark_as_do_not_disturb_request_object
+          command.response_representation = Google::Apis::ChatV1::Availability::Representation
+          command.response_class = Google::Apis::ChatV1::Availability
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # 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 [String] name
+        #   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`.
+        # @param [Google::Apis::ChatV1::Availability] availability_object
+        # @param [String] update_mask
+        #   Required. The list of fields to update. The only field that can be updated is `
+        #   custom_status`.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ChatV1::Availability] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ChatV1::Availability]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def patch_user_availability(name, availability_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v1/{+name}', options)
+          command.request_representation = Google::Apis::ChatV1::Availability::Representation
+          command.request_object = availability_object
+          command.response_representation = Google::Apis::ChatV1::Availability::Representation
+          command.response_class = Google::Apis::ChatV1::Availability
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Creates a section in Google Chat. Sections help users group conversations and
         # customize the list of spaces displayed in Chat navigation panel. Only sections
         # of type `CUSTOM_SECTION` can be created. For details, see [Create and organize

data/lib/google/apis/chat_v1.rb

@@ -117,6 +117,12 @@ module Google
       # View chat and spaces in Google Chat
       AUTH_CHAT_SPACES_READONLY = 'https://www.googleapis.com/auth/chat.spaces.readonly'
 
+      # See and change your availability status in Google Chat.
+      AUTH_CHAT_USERS_AVAILABILITY = 'https://www.googleapis.com/auth/chat.users.availability'
+
+      # See your availability status in Google Chat.
+      AUTH_CHAT_USERS_AVAILABILITY_READONLY = 'https://www.googleapis.com/auth/chat.users.availability.readonly'
+
       # View and modify last read time for Google Chat conversations
       AUTH_CHAT_USERS_READSTATE = 'https://www.googleapis.com/auth/chat.users.readstate'
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-chat_v1
 version: !ruby/object:Gem::Version
-  version: 0.149.0
+  version: 0.151.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-chat_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-chat_v1/v0.149.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-chat_v1/v0.151.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-chat_v1
 rdoc_options: []
 require_paths: