google-apis-chat_v1 0.153.0 → 0.154.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 88360559d1e18497b9058420db18bb318518fdf9352fa103b9076f2f1168ab6f
-  data.tar.gz: 6c260dfac4349ba184062ed8a30994a82005e5a37ae49a0bacf06779877b48da
+  metadata.gz: 7be0f75b05ba62db7bedc92d4a4983ad883658f1fa82d63b5428bb198d144d9d
+  data.tar.gz: 053672fa3f9d3469aab40c7cda7b92c0523cb165e18761d0f81454288a9cc07e
 SHA512:
-  metadata.gz: fa51ce96aad9a3268024921ae37b29e8f3ba57cd9d59371dc33b012ec8d84270275a11ad44ab64ad64634bde91a9df50945eb0d1c911fe1d4b21ea79e9e1fa8d
-  data.tar.gz: 190e17801565bada2ec425f4722a155d20fc31255877dde41da6b22c4f8e85927071868c1c2af5267b823041b541a515142f475b1a49508bd1961ec3eb544bf1
+  metadata.gz: 171602ec8560d9191a0e3356b3c9f75b0f9de01643016327e08aa88d69b73f46fe75d76569c0a81e52717821b29a3fca0f49fb6c49fda32268636afd2c208f2d
+  data.tar.gz: 2f3ead44b63c00eb41816fbafde199eff4032275f5c3ef80012602dc5a10232dfc50bce0fd6c085994c91da1ce5011173afc3d5a895ce3a32418a6696db34e37

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-chat_v1
 
+### v0.154.0 (2026-09-06)
+
+* Regenerated from discovery document revision 20260828
+
 ### v0.153.0 (2026-08-23)
 
 * Regenerated from discovery document revision 20260815

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

@@ -4904,6 +4904,32 @@ module Google
         end
       end
       
+      # Response message for listing message pins.
+      class ListMessagePinsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The pinned messages from the specified space.
+        # Corresponds to the JSON property `messagePins`
+        # @return [Array<Google::Apis::ChatV1::MessagePin>]
+        attr_accessor :message_pins
+      
+        # You can send a token as `pageToken` to retrieve the next page of results. If
+        # empty, there are no subsequent pages.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @message_pins = args[:message_pins] if args.key?(:message_pins)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # Response message for listing messages.
       class ListMessagesResponse
         include Google::Apis::Core::Hashable
@@ -5789,6 +5815,37 @@ module Google
         end
       end
       
+      # A pin on a Chat message. For more information see [Pin a message](https://
+      # support.google.com/chat?p=chat-board-hc).
+      class MessagePin
+        include Google::Apis::Core::Hashable
+      
+        # Required. Immutable. The resource name of the message that is pinned. Format: `
+        # spaces/`space`/messages/`message``
+        # Corresponds to the JSON property `message`
+        # @return [String]
+        attr_accessor :message
+      
+        # Identifier. The resource name of the message pin. Format: `spaces/`space`/
+        # messagePins/`message_pin`` The resource ID component matches the resource ID
+        # component of the message. For example, a message with `spaces/AAA/messages/bbb.
+        # ccc` corresponds to the message pin with the resource name `spaces/AAA/
+        # messagePins/bbb.ccc`.
+        # 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)
+          @message = args[:message] if args.key?(:message)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # Event payload for an updated message. Event type: `google.workspace.chat.
       # message.v1.updated`
       class MessageUpdatedEventData
@@ -6572,7 +6629,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # A token that can be used to retrieve the next page. If this field is empty,
-        # there are no subsequent pages.
+        # there are no subsequent pages. Only populated when `useAdminAccess` is set to `
+        # true`.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -6590,7 +6648,8 @@ module Google
         attr_accessor :spaces
       
         # The total number of spaces that match the query, across all pages. If the
-        # result is over 10,000 spaces, this value is an estimate.
+        # result is over 10,000 spaces, this value is an estimate. Only populated when `
+        # useAdminAccess` is set to `true`.
         # Corresponds to the JSON property `totalSize`
         # @return [Fixnum]
         attr_accessor :total_size
@@ -6713,10 +6772,19 @@ module Google
         # @return [Array<Google::Apis::ChatV1::Membership>]
         attr_accessor :memberships
       
-        # Optional. A unique identifier for this request. A random UUID is recommended.
-        # Specifying an existing request ID returns the space created with that ID
-        # instead of creating a new space. Specifying an existing request ID from the
-        # same Chat app with a different authenticated user returns an error.
+        # Optional. A unique ID for this request. A random UUID is recommended.
+        # Specifying a request ID makes the request idempotent, which ensures that
+        # multiple identical requests with the same request ID result in only a single
+        # space being created. Subsequent requests with the same request ID return the
+        # existing space and do not update the space, even if the requested details
+        # differ from the current state. To use this field effectively: - Ensure that
+        # subsequent requests are identical and use the same authentication credentials
+        # as the original request. - If a space was already created with the provided
+        # request ID, the request returns that space. Note that the returned space might
+        # not be fully populated; the API echoes the space in your request with the
+        # system-assigned resource name populated. To retrieve the latest metadata for
+        # the space, call `GetSpace`. - Reusing an existing request ID with a different
+        # authenticated user results in an error.
         # Corresponds to the JSON property `requestId`
         # @return [String]
         attr_accessor :request_id

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.153.0"
+      GEM_VERSION = "0.154.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 = "20260815"
+      REVISION = "20260828"
     end
   end
 end

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

@@ -658,6 +658,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ListMessagePinsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListMessagesResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -814,6 +820,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class MessagePin
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class MessageUpdatedEventData
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -2280,6 +2292,15 @@ module Google
         end
       end
       
+      class ListMessagePinsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :message_pins, as: 'messagePins', class: Google::Apis::ChatV1::MessagePin, decorator: Google::Apis::ChatV1::MessagePin::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
       class ListMessagesResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2541,6 +2562,14 @@ module Google
         end
       end
       
+      class MessagePin
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :message, as: 'message'
+          property :name, as: 'name'
+        end
+      end
+      
       class MessageUpdatedEventData
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -393,10 +393,19 @@ module Google
         # organization might already use this display name.
         # @param [Google::Apis::ChatV1::Space] space_object
         # @param [String] request_id
-        #   Optional. A unique identifier for this request. A random UUID is recommended.
-        #   Specifying an existing request ID returns the space created with that ID
-        #   instead of creating a new space. Specifying an existing request ID from the
-        #   same Chat app with a different authenticated user returns an error.
+        #   Optional. A unique ID for this request. A random UUID is recommended.
+        #   Specifying a request ID makes the request idempotent, which ensures that
+        #   multiple identical requests with the same request ID result in only a single
+        #   space being created. Subsequent requests with the same request ID return the
+        #   existing space and do not update the space, even if the requested details
+        #   differ from the current state. To use this field effectively: - Ensure that
+        #   subsequent requests are identical and use the same authentication credentials
+        #   as the original request. - If a space was already created with the provided
+        #   request ID, the request returns that space. Note that the returned space might
+        #   not be fully populated; the API echoes the space in your request with the
+        #   system-assigned resource name populated. To retrieve the latest metadata for
+        #   the space, call `GetSpace`. - Reusing an existing request ID with a different
+        #   authenticated user results in an error.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -879,7 +888,9 @@ module Google
         # @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
-        #   1000. If you use a value more than 1000, it's automatically changed to 1000.
+        #   1000 when `useAdminAccess` is set to `true`. Otherwise, the maximum value is
+        #   100. If you use a value more than the maximum value, it's automatically
+        #   changed to the maximum value.
         # @param [String] page_token
         #   A token, received from the previous search spaces call. Provide this parameter
         #   to retrieve the subsequent page. When paginating, all other parameters
@@ -931,7 +942,9 @@ module Google
         #   AND space_type = "SPACE" (display_name:"Hello" OR display_name:"Fun") AND
         #   space_type = "SPACE" (external_user_allowed = "true" AND space_type = "SPACE")
         #   // Returns an empty response. (external_user_allowed = "true" AND display_name:
-        #   "Hello" AND space_type = "SPACE") ```
+        #   "Hello" AND space_type = "SPACE") ``` The maximum query length is 1,000
+        #   characters. Invalid queries are rejected by the server with an `
+        #   INVALID_ARGUMENT` error.
         # @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
@@ -1406,6 +1419,132 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates a message pin. 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.spaces.pins` - `https://www.googleapis.com/auth/chat.spaces`
+        # @param [String] parent
+        #   Required. The parent space in which to create the message pin. Format: spaces/`
+        #   space`
+        # @param [Google::Apis::ChatV1::MessagePin] message_pin_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::MessagePin] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ChatV1::MessagePin]
+        #
+        # @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 create_space_message_pin(parent, message_pin_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/messagePins', options)
+          command.request_representation = Google::Apis::ChatV1::MessagePin::Representation
+          command.request_object = message_pin_object
+          command.response_representation = Google::Apis::ChatV1::MessagePin::Representation
+          command.response_class = Google::Apis::ChatV1::MessagePin
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes a message pin. 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.spaces.pins` - `https://www.googleapis.com/auth/chat.spaces`
+        # @param [String] name
+        #   Required. The resource name of the message pin to remove. Format: spaces/`
+        #   space`/messagePins/`message_pin`
+        # @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::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ChatV1::Empty]
+        #
+        # @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 delete_space_message_pin(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::ChatV1::Empty::Representation
+          command.response_class = Google::Apis::ChatV1::Empty
+          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
+        
+        # Lists message pins in a space. Users can pin important messages in spaces for
+        # easy access. For more information, see [Pin or unpin a conversation in Google
+        # Chat](https://support.google.com/chat/answer/15622437). 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.spaces.pins.readonly` - `https://www.
+        # googleapis.com/auth/chat.spaces.pins` - `https://www.googleapis.com/auth/chat.
+        # spaces.readonly` - `https://www.googleapis.com/auth/chat.spaces`
+        # @param [String] parent
+        #   Required. The parent space which owns the collection of pinned items Format: `
+        #   spaces/`space``
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of message pins returned. The service might
+        #   return fewer messages than this value. The maximum value is 100. If you use a
+        #   value more than 100, it's automatically changed to 100. If unspecified, at
+        #   most 100 message pins will be returned. Negative values return an `
+        #   INVALID_ARGUMENT` error.
+        # @param [String] page_token
+        #   Optional. A page token received from a previous list message pins call.
+        #   Provide this parameter to retrieve the subsequent page. When paginating, all
+        #   other parameters provided should match the call that provided the page token.
+        #   Passing different values to the other parameters might lead to unexpected
+        #   results.
+        # @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::ListMessagePinsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ChatV1::ListMessagePinsResponse]
+        #
+        # @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 list_space_message_pins(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/messagePins', options)
+          command.response_representation = Google::Apis::ChatV1::ListMessagePinsResponse::Representation
+          command.response_class = Google::Apis::ChatV1::ListMessagePinsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.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 message in a Google Chat space. For an example, see [Send a message](
         # https://developers.google.com/workspace/chat/create-messages). Supports the
         # following types of [authentication](https://developers.google.com/workspace/
@@ -1455,8 +1594,19 @@ module Google
         #   is ignored. For interactions within a thread, the reply is created in the same
         #   thread. Otherwise, the reply is created as a new thread.
         # @param [String] request_id
-        #   Optional. A unique request ID for this message. Specifying an existing request
-        #   ID returns the message created with that ID instead of creating a new message.
+        #   Optional. A unique ID for this request. A random UUID is recommended.
+        #   Specifying a request ID makes the request idempotent, which ensures that
+        #   multiple identical requests with the same request ID result in only a single
+        #   message being created. Subsequent requests with the same request ID return the
+        #   existing message and do not update the message, even if the requested details
+        #   differ from the current state. To use this field effectively: - Ensure that
+        #   subsequent requests are identical and use the same authentication credentials
+        #   as the original request. - If a message was already created with the provided
+        #   request ID, the request returns that message. Note that the returned message
+        #   might not be fully populated; the API echoes the message in your request with
+        #   the system-assigned resource names populated. To retrieve the latest metadata
+        #   for the message, call `GetMessage`. - Reusing an existing request ID with a
+        #   different authenticated user results in an error.
         # @param [String] thread_key
         #   Optional. Deprecated: Use thread.thread_key instead. ID for the thread.
         #   Supports up to 4000 characters. To start or add to a thread, create a message

data/lib/google/apis/chat_v1.rb

@@ -123,6 +123,12 @@ module Google
       # Create new conversations and spaces in Google Chat
       AUTH_CHAT_SPACES_CREATE = 'https://www.googleapis.com/auth/chat.spaces.create'
 
+      # See, add, and remove pins in your Google Chat spaces
+      AUTH_CHAT_SPACES_PINS = 'https://www.googleapis.com/auth/chat.spaces.pins'
+
+      # See pins in your Google Chat spaces
+      AUTH_CHAT_SPACES_PINS_READONLY = 'https://www.googleapis.com/auth/chat.spaces.pins.readonly'
+
       # View chat and spaces in Google Chat
       AUTH_CHAT_SPACES_READONLY = 'https://www.googleapis.com/auth/chat.spaces.readonly'
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-chat_v1
 version: !ruby/object:Gem::Version
-  version: 0.153.0
+  version: 0.154.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.153.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-chat_v1/v0.154.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-chat_v1
 rdoc_options: []
 require_paths: