google-apis-chat_v1 0.148.0 → 0.150.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dcad1d56f29e949dda3c0af2674fe52f21e9f276dd16f02bddeeec989f894814
-  data.tar.gz: 3f0247dc35286e36085fda12644fbd2146bd51c24fac7d748b0d9fb4fcf5b30b
+  metadata.gz: d3856cf6db1d5e56b5afdd5074c058f35bb9924421f4ff6c7f622ac22d20f5dc
+  data.tar.gz: 2b8dec4bc97193c758f0aa80f183fee8c9ab543c89683bcbb683d79d8e5f13f7
 SHA512:
-  metadata.gz: 405d2d5a4641927bab012786d5509625d2f5e013c1167e01c8f5ea2ac1793fccb60a955f963214da0a8d1da8f8e279ca043d8a00b336ac250d5b74492936c76a
-  data.tar.gz: 678cfab7c05ac4946e2f32dde5e26960f06a63179f67d2c230c3b5e4d84c2f2d67f620f5c8c0e73f54284ad47c6a0b94a036273eead253a3822100053b7bfdb0
+  metadata.gz: b6116cbd536de712b3a7be06b0e35f7c0a1c91df0b56e677ebe13c28fd2315fc229266ea3e48d24e813939f68856b57336442726b31c86e465749b725e8c04d9
+  data.tar.gz: fce7e1458d0291d72e5e529d4faa53a6ff462c8a45f63d54678cd8df445f61e31883fc4d7589288f907978fe78bc68c01e1b9edd2e933bb9c30ab7523d9a2429

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Release history for google-apis-chat_v1
 
+### v0.150.0 (2026-06-28)
+
+* Regenerated from discovery document revision 20260623
+
+### v0.149.0 (2026-06-14)
+
+* Regenerated from discovery document revision 20260607
+* Regenerated using generator version 0.19.0
+
 ### v0.148.0 (2026-05-17)
 
 * Regenerated from discovery document revision 20260510

data/OVERVIEW.md

@@ -83,7 +83,7 @@ The [product documentation](https://developers.google.com/workspace/chat) may pr
 
 ## Supported Ruby versions
 
-This library is supported on Ruby 3.1+.
+This library is supported on Ruby 3.2+.
 
 Google provides official support for Ruby versions that are actively supported by Ruby Core -- that is, Ruby versions that are either in normal maintenance or in security maintenance, and not end of life. Older versions of Ruby _may_ still work, but are unsupported and not recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby support schedule.
 

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

@@ -389,6 +389,51 @@ module Google
         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 +1095,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 +1430,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 +4983,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).
@@ -4954,6 +5125,13 @@ module Google
       class Membership
         include Google::Apis::Core::Hashable
       
+        # Output only. A user's relationship to the Workspace organization that owns the
+        # space. In spaces owned by consumer accounts, the affiliation of all members is
+        # `EXTERNAL`.
+        # Corresponds to the JSON property `affiliation`
+        # @return [String]
+        attr_accessor :affiliation
+      
         # Optional. Immutable. The creation time of the membership, such as when a
         # member joined or was invited to join a space. This field is output only,
         # except when used to import historical memberships in import mode spaces.
@@ -5005,6 +5183,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @affiliation = args[:affiliation] if args.key?(:affiliation)
           @create_time = args[:create_time] if args.key?(:create_time)
           @delete_time = args[:delete_time] if args.key?(:delete_time)
           @group_member = args[:group_member] if args.key?(:group_member)
@@ -5324,13 +5503,10 @@ module Google
         # @return [Google::Apis::ChatV1::User]
         attr_accessor :private_message_viewer
       
-        # 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. For example usage,
-        # see [Quote another message](https://developers.google.com/workspace/chat/
-        # create-messages#quote-a-message).
+        # 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://
+        # developers.google.com/workspace/chat/create-messages#quote-a-message).
         # Corresponds to the JSON property `quotedMessageMetadata`
         # @return [Google::Apis::ChatV1::QuotedMessageMetadata]
         attr_accessor :quoted_message_metadata
@@ -5788,13 +5964,10 @@ module Google
         end
       end
       
-      # 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. For example usage,
-      # see [Quote another message](https://developers.google.com/workspace/chat/
-      # create-messages#quote-a-message).
+      # 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://
+      # developers.google.com/workspace/chat/create-messages#quote-a-message).
       class QuotedMessageMetadata
         include Google::Apis::Core::Hashable
       
@@ -6070,7 +6243,9 @@ module Google
         # @return [String]
         attr_accessor :next_page_token
       
-        # 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.
         # Corresponds to the JSON property `spaces`
         # @return [Array<Google::Apis::ChatV1::Space>]
         attr_accessor :spaces

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.148.0"
+      GEM_VERSION = "0.150.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.18.0"
+      GENERATOR_VERSION = "0.19.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20260510"
+      REVISION = "20260623"
     end
   end
 end

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

@@ -82,6 +82,12 @@ module Google
         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 +184,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 +226,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 +676,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
       
@@ -1142,6 +1178,18 @@ module Google
         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 +1343,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 +1422,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 +2259,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
@@ -2219,6 +2307,7 @@ module Google
       class Membership
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :affiliation, as: 'affiliation'
           property :create_time, as: 'createTime'
           property :delete_time, as: 'deleteTime'
           property :group_member, as: 'groupMember', class: Google::Apis::ChatV1::Group, decorator: Google::Apis::ChatV1::Group::Representation

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

@@ -832,27 +832,37 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list of spaces in a Google Workspace organization based on an
-        # administrator's search. In the request, set `use_admin_access` to `true`. For
-        # an example, see [Search for and manage spaces](https://developers.google.com/
-        # workspace/chat/search-manage-admin). Requires [user authentication with
-        # administrator privileges](https://developers.google.com/workspace/chat/
-        # authenticate-authorize-chat-user#admin-privileges) and one of the following [
-        # authorization scopes](https://developers.google.com/workspace/chat/
-        # authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/
-        # chat.admin.spaces.readonly` - `https://www.googleapis.com/auth/chat.admin.
+        # Returns a list of spaces in a Google Workspace organization. For an example,
+        # see [Search for and manage spaces](https://developers.google.com/workspace/
+        # 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
+        # one of the following authorization scopes: - `https://www.googleapis.com/auth/
+        # chat.spaces.readonly` - `https://www.googleapis.com/auth/chat.spaces` - [User
+        # authentication with administrator privileges](https://developers.google.com/
+        # workspace/chat/authenticate-authorize-chat-user#admin-privileges) and one of
+        # the following [authorization scopes](https://developers.google.com/workspace/
+        # chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/
+        # auth/chat.admin.spaces.readonly` - `https://www.googleapis.com/auth/chat.admin.
         # spaces`
         # @param [String] order_by
         #   Optional. How the list of spaces is ordered. Supported attributes to order by
         #   are: - `membership_count.joined_direct_human_user_count` — Denotes the count
         #   of human users that have directly joined a space. - `last_active_time` —
         #   Denotes the time when last eligible item is added to any topic of this space. -
-        #   `create_time` — Denotes the time of the space creation. Valid ordering
-        #   operation values are: - `ASC` for ascending. Default value. - `DESC` for
-        #   descending. The supported syntax are: - `membership_count.
-        #   joined_direct_human_user_count DESC` - `membership_count.
+        #   `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 when `useAdminAccess` is set to `true`
+        #   : - `membership_count.joined_direct_human_user_count DESC` - `membership_count.
         #   joined_direct_human_user_count ASC` - `last_active_time DESC` - `
-        #   last_active_time ASC` - `create_time DESC` - `create_time ASC`
+        #   last_active_time ASC` - `create_time DESC` - `create_time ASC` When `
+        #   useAdminAccess` is set to `false`: - `create_time DESC` - `relevance DESC`
         # @param [Fixnum] page_size
         #   The maximum number of spaces to return. The service may return fewer than this
         #   value. If unspecified, at most 100 spaces are returned. The maximum value is
@@ -863,23 +873,28 @@ module Google
         #   provided should match the call that provided the page token. Passing different
         #   values to the other parameters might lead to unexpected results.
         # @param [String] query
-        #   Required. A search query. You can search by using the following parameters : -
-        #   `create_time` - `customer` - `display_name` - `external_user_allowed` - `
-        #   last_active_time` - `space_history_state` - `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. `
-        #   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`. `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 only valid value is `SPACE`. Across different fields, only
-        #   `AND` operators are supported. A valid example is `space_type = "SPACE" AND
+        #   Required. A search query. You can search by using the following parameters
+        #   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 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 when `useAdminAccess` is set to `
+        #   true`, and the only valid value is `SPACE`. Across different fields, only `AND`
+        #   operators are supported. A valid example is `space_type = "SPACE" AND
         #   display_name:"Hello"` and an invalid example is `space_type = "SPACE" OR
         #   display_name:"Hello"`. Among the same field, `space_type` doesn't support `AND`
         #   or `OR` operators. `display_name`, 'space_history_state', and '
@@ -887,26 +902,31 @@ module Google
         #   create_time` support both `AND` and `OR` operators. `AND` can only be used to
         #   represent an interval, such as `last_active_time < "2022-01-01T00:00:00+00:00"
         #   AND last_active_time > "2023-01-01T00:00:00+00:00"`. The following example
-        #   queries are valid: ``` customer = "customers/my_customer" AND space_type = "
-        #   SPACE" customer = "customers/my_customer" AND space_type = "SPACE" AND
-        #   display_name:"Hello World" customer = "customers/my_customer" AND space_type =
-        #   "SPACE" AND (last_active_time < "2020-01-01T00:00:00+00:00" OR
-        #   last_active_time > "2022-01-01T00:00:00+00:00") customer = "customers/
-        #   my_customer" AND space_type = "SPACE" AND (display_name:"Hello World" OR
-        #   display_name:"Fun event") AND (last_active_time > "2020-01-01T00:00:00+00:00"
-        #   AND last_active_time < "2022-01-01T00:00:00+00:00") customer = "customers/
-        #   my_customer" AND space_type = "SPACE" AND (create_time > "2019-01-01T00:00:00+
-        #   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") ```
+        #   queries are valid when `useAdminAccess` is set to `true`: ``` customer = "
+        #   customers/my_customer" AND space_type = "SPACE" customer = "customers/
+        #   my_customer" AND space_type = "SPACE" AND display_name:"Hello World" customer =
+        #   "customers/my_customer" AND space_type = "SPACE" AND (last_active_time < "
+        #   2020-01-01T00:00:00+00:00" OR last_active_time > "2022-01-01T00:00:00+00:00")
+        #   customer = "customers/my_customer" AND space_type = "SPACE" AND (display_name:"
+        #   Hello World" OR display_name:"Fun event") AND (last_active_time > "2020-01-
+        #   01T00:00:00+00:00" AND last_active_time < "2022-01-01T00:00:00+00:00")
+        #   customer = "customers/my_customer" AND space_type = "SPACE" AND (create_time >
+        #   "2019-01-01T00:00:00+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") //
+        #   Returns an empty response. (external_user_allowed = "true" AND display_name:"
+        #   Hello") ```
         # @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). This method currently only supports
-        #   admin access, thus only `true` is accepted for this field.
+        #   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
@@ -2141,6 +2161,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_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 update_user_availability_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.148.0
+  version: 0.150.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.148.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-chat_v1/v0.150.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-chat_v1
 rdoc_options: []
 require_paths:
@@ -66,7 +66,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="