google-apis-chat_v1 0.153.0 → 0.155.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 88360559d1e18497b9058420db18bb318518fdf9352fa103b9076f2f1168ab6f
-  data.tar.gz: 6c260dfac4349ba184062ed8a30994a82005e5a37ae49a0bacf06779877b48da
+  metadata.gz: 6842d654f4800b8f520b3c3610e28d1c52dc442ea7e3dc82109823d9871068cf
+  data.tar.gz: 77fbf116ef1fe9e016edc98fe0c1a0307037d19b4240fb0e495f320b964f3b58
 SHA512:
-  metadata.gz: fa51ce96aad9a3268024921ae37b29e8f3ba57cd9d59371dc33b012ec8d84270275a11ad44ab64ad64634bde91a9df50945eb0d1c911fe1d4b21ea79e9e1fa8d
-  data.tar.gz: 190e17801565bada2ec425f4722a155d20fc31255877dde41da6b22c4f8e85927071868c1c2af5267b823041b541a515142f475b1a49508bd1961ec3eb544bf1
+  metadata.gz: 0bd45ec119942d4613176372be61c9a4d78a8c837dd232b64b4c70869e572b85ff446a06a02e0ffe47f0769a620fd0ab4249a3f4f76f530b981d634f294f3c42
+  data.tar.gz: 9ef527cce36524ffb0c3e9d6ddb9e00daf601a844fac5b7290293e5c97a9290a1558297b6c7c01c7c676cbe6d4dafb8c75aa024a9c9301a89d6d86fefe5efedf

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-chat_v1
 
+### v0.155.0 (2026-09-20)
+
+* Regenerated from discovery document revision 20260913
+
+### 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

@@ -55,6 +55,11 @@ module Google
         # @return [Google::Apis::ChatV1::AccessPermissionSetting]
         attr_accessor :join_space_setting
       
+        # An access permission setting.
+        # Corresponds to the JSON property `viewSpaceMembershipSetting`
+        # @return [Google::Apis::ChatV1::AccessPermissionSetting]
+        attr_accessor :view_space_membership_setting
+      
         def initialize(**args)
            update!(**args)
         end
@@ -63,6 +68,7 @@ module Google
         def update!(**args)
           @discover_space_setting = args[:discover_space_setting] if args.key?(:discover_space_setting)
           @join_space_setting = args[:join_space_setting] if args.key?(:join_space_setting)
+          @view_space_membership_setting = args[:view_space_membership_setting] if args.key?(:view_space_membership_setting)
         end
       end
       
@@ -1406,10 +1412,11 @@ module Google
         # @return [String]
         attr_accessor :type
       
-        # A user in Google Chat. When returned as an output from a request, if your Chat
-        # app [authenticates as a user](https://developers.google.com/workspace/chat/
-        # authenticate-authorize-chat-user), the output for a `User` resource only
-        # populates the user's `name` and `type`.
+        # If your Chat app [authenticates as a user](https://developers.google.com/
+        # workspace/chat/authenticate-authorize-chat-user), the output for a `User`
+        # resource (such as in the Messages and Memberships APIs) only populates the `
+        # name` and `type` fields for both internal and external users, unless they are
+        # members of the space or have prior affinity with the calling user.
         # Corresponds to the JSON property `user`
         # @return [Google::Apis::ChatV1::User]
         attr_accessor :user
@@ -4904,6 +4911,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
@@ -5231,10 +5264,11 @@ module Google
         # @return [Google::Apis::ChatV1::Group]
         attr_accessor :group_member
       
-        # A user in Google Chat. When returned as an output from a request, if your Chat
-        # app [authenticates as a user](https://developers.google.com/workspace/chat/
-        # authenticate-authorize-chat-user), the output for a `User` resource only
-        # populates the user's `name` and `type`.
+        # If your Chat app [authenticates as a user](https://developers.google.com/
+        # workspace/chat/authenticate-authorize-chat-user), the output for a `User`
+        # resource (such as in the Messages and Memberships APIs) only populates the `
+        # name` and `type` fields for both internal and external users, unless they are
+        # members of the space or have prior affinity with the calling user.
         # Corresponds to the JSON property `member`
         # @return [Google::Apis::ChatV1::User]
         attr_accessor :member
@@ -5580,10 +5614,11 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # A user in Google Chat. When returned as an output from a request, if your Chat
-        # app [authenticates as a user](https://developers.google.com/workspace/chat/
-        # authenticate-authorize-chat-user), the output for a `User` resource only
-        # populates the user's `name` and `type`.
+        # If your Chat app [authenticates as a user](https://developers.google.com/
+        # workspace/chat/authenticate-authorize-chat-user), the output for a `User`
+        # resource (such as in the Messages and Memberships APIs) only populates the `
+        # name` and `type` fields for both internal and external users, unless they are
+        # members of the space or have prior affinity with the calling user.
         # Corresponds to the JSON property `privateMessageViewer`
         # @return [Google::Apis::ChatV1::User]
         attr_accessor :private_message_viewer
@@ -5596,10 +5631,11 @@ module Google
         # @return [Google::Apis::ChatV1::QuotedMessageMetadata]
         attr_accessor :quoted_message_metadata
       
-        # A user in Google Chat. When returned as an output from a request, if your Chat
-        # app [authenticates as a user](https://developers.google.com/workspace/chat/
-        # authenticate-authorize-chat-user), the output for a `User` resource only
-        # populates the user's `name` and `type`.
+        # If your Chat app [authenticates as a user](https://developers.google.com/
+        # workspace/chat/authenticate-authorize-chat-user), the output for a `User`
+        # resource (such as in the Messages and Memberships APIs) only populates the `
+        # name` and `type` fields for both internal and external users, unless they are
+        # members of the space or have prior affinity with the calling user.
         # Corresponds to the JSON property `sender`
         # @return [Google::Apis::ChatV1::User]
         attr_accessor :sender
@@ -5789,6 +5825,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
@@ -5976,6 +6043,11 @@ module Google
         # @return [Google::Apis::ChatV1::PermissionSetting]
         attr_accessor :use_at_mention_all
       
+        # Represents a space permission setting.
+        # Corresponds to the JSON property `viewSpaceMembership`
+        # @return [Google::Apis::ChatV1::PermissionSetting]
+        attr_accessor :view_space_membership
+      
         def initialize(**args)
            update!(**args)
         end
@@ -5990,6 +6062,7 @@ module Google
           @reply_messages = args[:reply_messages] if args.key?(:reply_messages)
           @toggle_history = args[:toggle_history] if args.key?(:toggle_history)
           @use_at_mention_all = args[:use_at_mention_all] if args.key?(:use_at_mention_all)
+          @view_space_membership = args[:view_space_membership] if args.key?(:view_space_membership)
         end
       end
       
@@ -6193,10 +6266,11 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # A user in Google Chat. When returned as an output from a request, if your Chat
-        # app [authenticates as a user](https://developers.google.com/workspace/chat/
-        # authenticate-authorize-chat-user), the output for a `User` resource only
-        # populates the user's `name` and `type`.
+        # If your Chat app [authenticates as a user](https://developers.google.com/
+        # workspace/chat/authenticate-authorize-chat-user), the output for a `User`
+        # resource (such as in the Messages and Memberships APIs) only populates the `
+        # name` and `type` fields for both internal and external users, unless they are
+        # members of the space or have prior affinity with the calling user.
         # Corresponds to the JSON property `user`
         # @return [Google::Apis::ChatV1::User]
         attr_accessor :user
@@ -6572,7 +6646,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 +6665,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 +6789,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
@@ -6763,10 +6848,11 @@ module Google
       class SlashCommandMetadata
         include Google::Apis::Core::Hashable
       
-        # A user in Google Chat. When returned as an output from a request, if your Chat
-        # app [authenticates as a user](https://developers.google.com/workspace/chat/
-        # authenticate-authorize-chat-user), the output for a `User` resource only
-        # populates the user's `name` and `type`.
+        # If your Chat app [authenticates as a user](https://developers.google.com/
+        # workspace/chat/authenticate-authorize-chat-user), the output for a `User`
+        # resource (such as in the Messages and Memberships APIs) only populates the `
+        # name` and `type` fields for both internal and external users, unless they are
+        # members of the space or have prior affinity with the calling user.
         # Corresponds to the JSON property `bot`
         # @return [Google::Apis::ChatV1::User]
         attr_accessor :bot
@@ -7636,14 +7722,23 @@ module Google
         end
       end
       
-      # A user in Google Chat. When returned as an output from a request, if your Chat
-      # app [authenticates as a user](https://developers.google.com/workspace/chat/
-      # authenticate-authorize-chat-user), the output for a `User` resource only
-      # populates the user's `name` and `type`.
+      # If your Chat app [authenticates as a user](https://developers.google.com/
+      # workspace/chat/authenticate-authorize-chat-user), the output for a `User`
+      # resource (such as in the Messages and Memberships APIs) only populates the `
+      # name` and `type` fields for both internal and external users, unless they are
+      # members of the space or have prior affinity with the calling user.
       class User
         include Google::Apis::Core::Hashable
       
-        # Output only. The user's display name.
+        # Output only. The user's display name. Populated for both app authentication
+        # and user authentication. This field is always populated for requests made with
+        # [app authentication](https://developers.google.com/workspace/chat/authenticate-
+        # authorize-chat-app). When calling the Messages and Memberships APIs with [user
+        # authentication](https://developers.google.com/workspace/chat/authenticate-
+        # authorize-chat-user), this field is populated for both internal and external
+        # users for the `sender` of a message, users within `annotations` (such as user
+        # mentions), and within `Membership` resources, provided the user is a member of
+        # the space or has prior affinity with the calling user.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
@@ -7653,7 +7748,9 @@ module Google
         # @return [String]
         attr_accessor :domain_id
       
-        # Output only. When `true`, the user is deleted or their profile is not visible.
+        # Output only. When `true`, the user is deleted or their profile is not visible,
+        # such as when a user is mentioned in a space without being a member and without
+        # prior affinity with the calling user.
         # Corresponds to the JSON property `isAnonymous`
         # @return [Boolean]
         attr_accessor :is_anonymous
@@ -7703,10 +7800,11 @@ module Google
         # @return [String]
         attr_accessor :type
       
-        # A user in Google Chat. When returned as an output from a request, if your Chat
-        # app [authenticates as a user](https://developers.google.com/workspace/chat/
-        # authenticate-authorize-chat-user), the output for a `User` resource only
-        # populates the user's `name` and `type`.
+        # If your Chat app [authenticates as a user](https://developers.google.com/
+        # workspace/chat/authenticate-authorize-chat-user), the output for a `User`
+        # resource (such as in the Messages and Memberships APIs) only populates the `
+        # name` and `type` fields for both internal and external users, unless they are
+        # members of the space or have prior affinity with the calling user.
         # Corresponds to the JSON property `user`
         # @return [Google::Apis::ChatV1::User]
         attr_accessor :user

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.155.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 = "20260913"
     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
       
@@ -1141,6 +1153,8 @@ module Google
       
           property :join_space_setting, as: 'joinSpaceSetting', class: Google::Apis::ChatV1::AccessPermissionSetting, decorator: Google::Apis::ChatV1::AccessPermissionSetting::Representation
       
+          property :view_space_membership_setting, as: 'viewSpaceMembershipSetting', class: Google::Apis::ChatV1::AccessPermissionSetting, decorator: Google::Apis::ChatV1::AccessPermissionSetting::Representation
+      
         end
       end
       
@@ -2280,6 +2294,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 +2564,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
@@ -2609,6 +2640,8 @@ module Google
       
           property :use_at_mention_all, as: 'useAtMentionAll', class: Google::Apis::ChatV1::PermissionSetting, decorator: Google::Apis::ChatV1::PermissionSetting::Representation
       
+          property :view_space_membership, as: 'viewSpaceMembership', class: Google::Apis::ChatV1::PermissionSetting, decorator: Google::Apis::ChatV1::PermissionSetting::Representation
+      
         end
       end
       

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
@@ -797,15 +806,16 @@ module Google
         #   audience). `access_settings.access_permission_settings` is not supported with `
         #   useAdminAccess`. The supported field masks include: - `access_settings.
         #   access_permission_settings.discoverSpaceSetting` - `access_settings.
-        #   access_permission_settings.joinSpaceSetting` `permission_settings`: Supports
-        #   changing the [permission settings](https://support.google.com/chat/answer/
-        #   13340792) of a space. When updating permission settings, you can only specify `
-        #   permissionSettings` field masks; you cannot update other field masks at the
-        #   same time. The supported field masks include: - `permission_settings.
+        #   access_permission_settings.joinSpaceSetting` - `access_settings.
+        #   access_permission_settings.viewSpaceMembershipSetting` `permission_settings`:
+        #   Supports changing the [permission settings](https://support.google.com/chat/
+        #   answer/13340792) of a space. When updating permission settings, you can only
+        #   specify `permissionSettings` field masks; you cannot update other field masks
+        #   at the same time. The supported field masks include: - `permission_settings.
         #   manageMembersAndGroups` - `permission_settings.modifySpaceDetails` - `
         #   permission_settings.toggleHistory` - `permission_settings.useAtMentionAll` - `
         #   permission_settings.manageApps` - `permission_settings.manageWebhooks` - `
-        #   permission_settings.replyMessages`
+        #   permission_settings.replyMessages` - `permission_settings.viewSpaceMembership`
         # @param [Boolean] use_admin_access
         #   Optional. When `true`, the method runs using the user's Google Workspace
         #   administrator privileges. The calling user must be a Google Workspace
@@ -879,7 +889,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 +943,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 +1420,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 +1595,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.155.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.155.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-chat_v1
 rdoc_options: []
 require_paths: