google-apis-chat_v1 0.91.0 → 0.92.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f37dbc3a21ed798197277a6a30068b8eca1e757933c72ca36bb96ec24bd7b32c
-  data.tar.gz: af08170199c07ee8e40786bc9c0e93b8e6f6e38c2c6cf66e15cc16b5d2126fba
+  metadata.gz: 5f085237aac358b183d40cff86b8ef0c00ce1ec911da9964b0006c3f8c438234
+  data.tar.gz: 70c026fd5643256c13eba7be7a363dd847c62ea9204a57a136ca52a83da0ef0e
 SHA512:
-  metadata.gz: 8955f795c0dff00e4dcee0f1985da489b76918acc62d210fb704ade239c73f7f267547a6c75eaaa5fdeffd65fa2c7f7f0e51c3448f9a6d347c9e3b16cce206b7
-  data.tar.gz: b7deb6c4b715e7275157c75a3b0d2800b6bade816d100c7d6c3f8f78f03597e5047e92c21fd198650b178ed8f78cb9e00c3279d9ed3556cacece9bd6d72ffcef
+  metadata.gz: 3e3f9ee66a28dfc2bde7000f2397b20cd68ec7ba95367c14ac1053e4a78e2aa5c43e0033b933420963b693ebcbc11a861e555f5f4af048ceb854a700b526efe6
+  data.tar.gz: b845ae855d46931ac6a633e01a5bdaf8bf25df9690b7a0a9d553b6ac0f44a22eeabe7e8eba9de5a1d06ca81979bf7893e5d9d11ba03ee0973c9f27140ca92932

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-chat_v1
 
+### v0.92.0 (2024-04-28)
+
+* Regenerated from discovery document revision 20240423
+
 ### v0.91.0 (2024-04-21)
 
 * Regenerated from discovery document revision 20240416

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

@@ -752,7 +752,7 @@ module Google
       class CustomEmoji
         include Google::Apis::Core::Hashable
       
-        # Unique key for the custom emoji resource.
+        # Output only. Unique key for the custom emoji resource.
         # Corresponds to the JSON property `uid`
         # @return [String]
         attr_accessor :uid
@@ -884,8 +884,9 @@ module Google
         # @return [String]
         attr_accessor :event_time
       
-        # For `CARD_CLICKED` interaction events, whether the user interacted with a [
-        # dialog](https://developers.google.com/workspace/chat/dialogs).
+        # For `CARD_CLICKED` and `MESSAGE` interaction events, whether the user is
+        # interacting with or about to interact with a [dialog](https://developers.
+        # google.com/workspace/chat/dialogs).
         # Corresponds to the JSON property `isDialogEvent`
         # @return [Boolean]
         attr_accessor :is_dialog_event
@@ -4896,6 +4897,34 @@ module Google
         end
       end
       
+      # A user's read state within a space, used to identify read and unread messages.
+      class SpaceReadState
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The time when the user's space read state was updated. Usually this
+        # corresponds with either the timestamp of the last read message, or a timestamp
+        # specified by the user to mark the last read position in a space.
+        # Corresponds to the JSON property `lastReadTime`
+        # @return [String]
+        attr_accessor :last_read_time
+      
+        # Resource name of the space read state. Format: `users/`user`/spaces/`space`/
+        # spaceReadState`
+        # 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)
+          @last_read_time = args[:last_read_time] if args.key?(:last_read_time)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # Event payload for an updated space. Event type: `google.workspace.chat.space.
       # v1.updated`
       class SpaceUpdatedEventData
@@ -5061,6 +5090,33 @@ module Google
         end
       end
       
+      # A user's read state within a thread, used to identify read and unread messages.
+      class ThreadReadState
+        include Google::Apis::Core::Hashable
+      
+        # The time when the user's thread read state was updated. Usually this
+        # corresponds with the timestamp of the last read message in a thread.
+        # Corresponds to the JSON property `lastReadTime`
+        # @return [String]
+        attr_accessor :last_read_time
+      
+        # Resource name of the thread read state. Format: `users/`user`/spaces/`space`/
+        # threads/`thread`/threadReadState`
+        # 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)
+          @last_read_time = args[:last_read_time] if args.key?(:last_read_time)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # Time input values.
       class TimeInput
         include Google::Apis::Core::Hashable

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.91.0"
+      GEM_VERSION = "0.92.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.14.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240416"
+      REVISION = "20240423"
     end
   end
 end

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

@@ -694,6 +694,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class SpaceReadState
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class SpaceUpdatedEventData
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -730,6 +736,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ThreadReadState
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class TimeInput
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1997,6 +2009,14 @@ module Google
         end
       end
       
+      class SpaceReadState
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :last_read_time, as: 'lastReadTime'
+          property :name, as: 'name'
+        end
+      end
+      
       class SpaceUpdatedEventData
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2045,6 +2065,14 @@ module Google
         end
       end
       
+      class ThreadReadState
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :last_read_time, as: 'lastReadTime'
+          property :name, as: 'name'
+        end
+      end
+      
       class TimeInput
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -773,9 +773,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a message in a Google Chat space. For an example, see [Send a message](
-        # https://developers.google.com/workspace/chat/create-messages). Calling this
-        # method requires [authentication](https://developers.google.com/workspace/chat/
+        # Creates a message in a Google Chat space. The maximum message size, including
+        # text and cards, is 32,000 bytes. For an example, see [Send a message](https://
+        # developers.google.com/workspace/chat/create-messages). Calling this method
+        # requires [authentication](https://developers.google.com/workspace/chat/
         # authenticate-authorize) and supports the following authentication types: - For
         # text messages, user authentication or app authentication are supported. - For
         # card messages, only app authentication is supported. (Only Chat apps can
@@ -1425,6 +1426,129 @@ module Google
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
+        
+        # Returns details about a user's read state within a space, used to identify
+        # read and unread messages. Requires [user authentication](https://developers.
+        # google.com/workspace/chat/authenticate-authorize-chat-user).
+        # @param [String] name
+        #   Required. Resource name of the space read state to retrieve. Only supports
+        #   getting read state for the calling user. To refer to the calling user, set one
+        #   of the following: - The `me` alias. For example, `users/me/spaces/`space`/
+        #   spaceReadState`. - Their Workspace email address. For example, `users/user@
+        #   example.com/spaces/`space`/spaceReadState`. - Their user id. For example, `
+        #   users/123456789/spaces/`space`/spaceReadState`. Format: users/`user`/spaces/`
+        #   space`/spaceReadState
+        # @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::SpaceReadState] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ChatV1::SpaceReadState]
+        #
+        # @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_space_space_read_state(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::ChatV1::SpaceReadState::Representation
+          command.response_class = Google::Apis::ChatV1::SpaceReadState
+          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 a user's read state within a space, used to identify read and unread
+        # messages. Requires [user authentication](https://developers.google.com/
+        # workspace/chat/authenticate-authorize-chat-user).
+        # @param [String] name
+        #   Resource name of the space read state. Format: `users/`user`/spaces/`space`/
+        #   spaceReadState`
+        # @param [Google::Apis::ChatV1::SpaceReadState] space_read_state_object
+        # @param [String] update_mask
+        #   Required. The field paths to update. Currently supported field paths: - `
+        #   last_read_time` When the `last_read_time` is before the latest message create
+        #   time, the space appears as unread in the UI. To mark the space as read, set `
+        #   last_read_time` to any value later (larger) than the latest message create
+        #   time. The `last_read_time` is coerced to match the latest message create time.
+        #   Note that the space read state only affects the read state of messages that
+        #   are visible in the space's top-level conversation. Replies in threads are
+        #   unaffected by this timestamp, and instead rely on the thread read state.
+        # @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::SpaceReadState] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ChatV1::SpaceReadState]
+        #
+        # @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_space_space_read_state(name, space_read_state_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::SpaceReadState::Representation
+          command.request_object = space_read_state_object
+          command.response_representation = Google::Apis::ChatV1::SpaceReadState::Representation
+          command.response_class = Google::Apis::ChatV1::SpaceReadState
+          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
+        
+        # Returns details about a user's read state within a thread, used to identify
+        # read and unread messages. Requires [user authentication](https://developers.
+        # google.com/workspace/chat/authenticate-authorize-chat-user).
+        # @param [String] name
+        #   Required. Resource name of the thread read state to retrieve. Only supports
+        #   getting read state for the calling user. To refer to the calling user, set one
+        #   of the following: - The `me` alias. For example, `users/me/spaces/`space`/
+        #   threads/`thread`/threadReadState`. - Their Workspace email address. For
+        #   example, `users/user@example.com/spaces/`space`/threads/`thread`/
+        #   threadReadState`. - Their user id. For example, `users/123456789/spaces/`space`
+        #   /threads/`thread`/threadReadState`. Format: users/`user`/spaces/`space`/
+        #   threads/`thread`/threadReadState
+        # @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::ThreadReadState] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ChatV1::ThreadReadState]
+        #
+        # @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_space_thread_thread_read_state(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::ChatV1::ThreadReadState::Representation
+          command.response_class = Google::Apis::ChatV1::ThreadReadState
+          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
 
         protected
 

data/lib/google/apis/chat_v1.rb

@@ -74,6 +74,12 @@ module Google
 
       # View chat and spaces in Google Chat
       AUTH_CHAT_SPACES_READONLY = 'https://www.googleapis.com/auth/chat.spaces.readonly'
+
+      # View and modify last read time for Google Chat conversations
+      AUTH_CHAT_USERS_READSTATE = 'https://www.googleapis.com/auth/chat.users.readstate'
+
+      # View last read time for Google Chat conversations
+      AUTH_CHAT_USERS_READSTATE_READONLY = 'https://www.googleapis.com/auth/chat.users.readstate.readonly'
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-chat_v1
 version: !ruby/object:Gem::Version
-  version: 0.91.0
+  version: 0.92.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-04-21 00:00:00.000000000 Z
+date: 2024-04-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,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.91.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-chat_v1/v0.92.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-chat_v1
 post_install_message: 
 rdoc_options: []