google-apis-chat_v1 0.149.0 → 0.150.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2aedfbf1c6b3d1fc132d1538a517f01c24ca6aecfb9f448495c2d3686caf8b25
-  data.tar.gz: 1a93ac08861808090ba2bc440d52a9d2c41294776c3a4e0a0d9ff5a353e647d1
+  metadata.gz: d3856cf6db1d5e56b5afdd5074c058f35bb9924421f4ff6c7f622ac22d20f5dc
+  data.tar.gz: 2b8dec4bc97193c758f0aa80f183fee8c9ab543c89683bcbb683d79d8e5f13f7
 SHA512:
-  metadata.gz: d09ab92a5e027b7634204dc5517757bf6d54634da00ae77c3f55c2d6388acd691a7e9f392f2b71c0aa088467ab159eaff3c777d0a9f70a5748b6f71f6f64378b
-  data.tar.gz: 22174968827440265357f1671f24422f5ae69f5825f0faa3f207c14e446dc132442eeab0ab88a622911796d81281e01ec4b2c5bb64c97989f55241608e2d004f
+  metadata.gz: b6116cbd536de712b3a7be06b0e35f7c0a1c91df0b56e677ebe13c28fd2315fc229266ea3e48d24e813939f68856b57336442726b31c86e465749b725e8c04d9
+  data.tar.gz: fce7e1458d0291d72e5e529d4faa53a6ff462c8a45f63d54678cd8df445f61e31883fc4d7589288f907978fe78bc68c01e1b9edd2e933bb9c30ab7523d9a2429

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # 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

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).

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.150.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 = "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

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

@@ -837,6 +837,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
@@ -879,49 +880,53 @@ module Google
         #   `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`. `
-        #   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 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 'external_user_allowed' only support
-        #   `OR` operators. `last_active_time` and `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 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
+        #   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 '
+        #   external_user_allowed' only support `OR` operators. `last_active_time` and `
+        #   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 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") (
-        #   external_user_allowed = "true" AND display_name:"Hello") ```
+        #   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).
+        #   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 +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.149.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.149.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: