google-apis-chat_v1 0.101.0 → 0.103.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7801b30ffb1eca865e0bbf13678f6a0610d9b1fe4499304a263f82229bb7ba63
-  data.tar.gz: 8fe5e57f1fc8aef283787ceb68216aa226f27fbfb5d2f82a65e000a9ede47ea8
+  metadata.gz: 9299c746df7364f6dac6b8ce99ca758b252e9dbd8cd5cdebc137ccd53183df52
+  data.tar.gz: f60c2cc0f9cd13a95ccc5986a5da0761e04ca979097646744f45193ce6858bc0
 SHA512:
-  metadata.gz: e025df779920dd2221e65355e4fa9847f45d431686fbcad334042837a07905e4fec57df7bdff516baaabd14240e14b9da525f5fc6a4b783e535c50d8ec9a14d2
-  data.tar.gz: c0e896fec5d4046a5016e56a466297673f137ba0a5ab7b324d109077c1455c83616af264e90274d3091f67fa8763fb460d5f43494f218e60ffde1ddebd403a9d
+  metadata.gz: 293d49333586d6f87b88475c0cd53d31c7d10cce7aa3d5ee0696e7b09de350956c9bd591716b3e37e9ade78cc883b1afc8dffc1ef435f1ff117ab24c8390ee42
+  data.tar.gz: 9da5a760b2ecabde3cc6c24b2e0080b4e5698007a45fc6b0a4a30435ad4b534388a18ced701b7542c4a92bd0a464ae060326fa7bb18092c1651f47d9dc8d3f41

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-chat_v1
 
+### v0.103.0 (2024-09-01)
+
+* Regenerated from discovery document revision 20240825
+
+### v0.102.0 (2024-08-25)
+
+* Regenerated from discovery document revision 20240818
+
 ### v0.101.0 (2024-08-18)
 
 * Regenerated from discovery document revision 20240813

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

@@ -3732,6 +3732,33 @@ module Google
         end
       end
       
+      # [Developer Preview](https://developers.google.com/workspace/preview).
+      # Represents the count of memberships of a space, grouped into categories.
+      class MembershipCount
+        include Google::Apis::Core::Hashable
+      
+        # Count of human users that have directly joined the space, not counting users
+        # joined by having membership in a joined group.
+        # Corresponds to the JSON property `joinedDirectHumanUserCount`
+        # @return [Fixnum]
+        attr_accessor :joined_direct_human_user_count
+      
+        # Count of all groups that have directly joined the space.
+        # Corresponds to the JSON property `joinedGroupCount`
+        # @return [Fixnum]
+        attr_accessor :joined_group_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @joined_direct_human_user_count = args[:joined_direct_human_user_count] if args.key?(:joined_direct_human_user_count)
+          @joined_group_count = args[:joined_group_count] if args.key?(:joined_group_count)
+        end
+      end
+      
       # Event payload for a new membership. Event type: `google.workspace.chat.
       # membership.v1.created`.
       class MembershipCreatedEventData
@@ -3848,9 +3875,9 @@ module Google
         # rest/v1/cards). Only Chat apps can create cards. If your Chat app [
         # authenticates as a user](https://developers.google.com/workspace/chat/
         # authenticate-authorize-chat-user), the messages can't contain cards. To learn
-        # about cards and how to create them, see [Send card messages](https://
-        # developers.google.com/workspace/chat/create-messages#create). [Card builder](
-        # https://addons.gsuite.google.com/uikit/builder)
+        # how to create a message that contains cards, see [Send a message](https://
+        # developers.google.com/workspace/chat/create-messages). [Card builder](https://
+        # addons.gsuite.google.com/uikit/builder)
         # Corresponds to the JSON property `cardsV2`
         # @return [Array<Google::Apis::ChatV1::CardWithId>]
         attr_accessor :cards_v2
@@ -3977,9 +4004,8 @@ module Google
         # generates a [preview chip](https://developers.google.com/workspace/chat/
         # preview-links). You can also [@mention a Google Chat user](https://developers.
         # google.com/workspace/chat/format-messages#messages-@mention), or everyone in
-        # the space. To learn about creating text messages, see [Send a text message](
-        # https://developers.google.com/workspace/chat/create-messages#create-text-
-        # messages).
+        # the space. To learn about creating text messages, see [Send a message](https://
+        # developers.google.com/workspace/chat/create-messages).
         # Corresponds to the JSON property `text`
         # @return [String]
         attr_accessor :text
@@ -4376,6 +4402,39 @@ module Google
         end
       end
       
+      # Response with a list of spaces corresponding to the search spaces request.
+      class SearchSpacesResponse
+        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.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # A page of the requested spaces.
+        # Corresponds to the JSON property `spaces`
+        # @return [Array<Google::Apis::ChatV1::Space>]
+        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.
+        # Corresponds to the JSON property `totalSize`
+        # @return [Fixnum]
+        attr_accessor :total_size
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @spaces = args[:spaces] if args.key?(:spaces)
+          @total_size = args[:total_size] if args.key?(:total_size)
+        end
+      end
+      
       # A section contains a collection of widgets that are rendered (vertically) in
       # the order that they are specified. Across all platforms, cards have a narrow
       # fixed width, so there's currently no need for layout properties (for example,
@@ -4606,7 +4665,24 @@ module Google
         attr_accessor :import_mode
         alias_method :import_mode?, :import_mode
       
-        # Resource name of the space. Format: `spaces/`space``
+        # Output only. Timestamp of the last message in the space. [Developer Preview](
+        # https://developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `lastActiveTime`
+        # @return [String]
+        attr_accessor :last_active_time
+      
+        # [Developer Preview](https://developers.google.com/workspace/preview).
+        # Represents the count of memberships of a space, grouped into categories.
+        # Corresponds to the JSON property `membershipCount`
+        # @return [Google::Apis::ChatV1::MembershipCount]
+        attr_accessor :membership_count
+      
+        # Resource name of the space. Format: `spaces/`space`` Where ``space``
+        # represents the system-assigned ID for the space. You can obtain the space ID
+        # by calling the [`spaces.list()`](https://developers.google.com/workspace/chat/
+        # api/reference/rest/v1/spaces/list) method or from the space URL. For example,
+        # if the space URL is `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`,
+        # the space ID is `AAAAAAAAA`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -4667,6 +4743,8 @@ module Google
           @display_name = args[:display_name] if args.key?(:display_name)
           @external_user_allowed = args[:external_user_allowed] if args.key?(:external_user_allowed)
           @import_mode = args[:import_mode] if args.key?(:import_mode)
+          @last_active_time = args[:last_active_time] if args.key?(:last_active_time)
+          @membership_count = args[:membership_count] if args.key?(:membership_count)
           @name = args[:name] if args.key?(:name)
           @single_user_bot_dm = args[:single_user_bot_dm] if args.key?(:single_user_bot_dm)
           @space_details = args[:space_details] if args.key?(:space_details)

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.101.0"
+      GEM_VERSION = "0.103.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.15.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240813"
+      REVISION = "20240825"
     end
   end
 end

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

@@ -526,6 +526,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class MembershipCount
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class MembershipCreatedEventData
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -640,6 +646,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class SearchSpacesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Section
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1690,6 +1702,14 @@ module Google
         end
       end
       
+      class MembershipCount
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :joined_direct_human_user_count, as: 'joinedDirectHumanUserCount'
+          property :joined_group_count, as: 'joinedGroupCount'
+        end
+      end
+      
       class MembershipCreatedEventData
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1888,6 +1908,16 @@ module Google
         end
       end
       
+      class SearchSpacesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :next_page_token, as: 'nextPageToken'
+          collection :spaces, as: 'spaces', class: Google::Apis::ChatV1::Space, decorator: Google::Apis::ChatV1::Space::Representation
+      
+          property :total_size, as: 'totalSize'
+        end
+      end
+      
       class Section
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1945,6 +1975,9 @@ module Google
           property :display_name, as: 'displayName'
           property :external_user_allowed, as: 'externalUserAllowed'
           property :import_mode, as: 'importMode'
+          property :last_active_time, as: 'lastActiveTime'
+          property :membership_count, as: 'membershipCount', class: Google::Apis::ChatV1::MembershipCount, decorator: Google::Apis::ChatV1::MembershipCount::Representation
+      
           property :name, as: 'name'
           property :single_user_bot_dm, as: 'singleUserBotDm'
           property :space_details, as: 'spaceDetails', class: Google::Apis::ChatV1::SpaceDetails, decorator: Google::Apis::ChatV1::SpaceDetails::Representation

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

@@ -227,6 +227,13 @@ module Google
         # authorize-chat-user) from a user who has permission to delete the space.
         # @param [String] name
         #   Required. Resource name of the space to delete. Format: `spaces/`space``
+        # @param [Boolean] use_admin_access
+        #   [Developer Preview](https://developers.google.com/workspace/preview). 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 the `chat.admin.delete` [OAuth 2.0 scope](https://
+        #   developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -244,11 +251,12 @@ module Google
         # @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(name, fields: nil, quota_user: nil, options: nil, &block)
+        def delete_space(name, use_admin_access: nil, 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['useAdminAccess'] = use_admin_access unless use_admin_access.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -312,6 +320,14 @@ module Google
         # @param [String] name
         #   Required. Resource name of the space, in the form `spaces/`space``. Format: `
         #   spaces/`space``
+        # @param [Boolean] use_admin_access
+        #   [Developer Preview](https://developers.google.com/workspace/preview). 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 the `chat.admin.spaces` or `chat.admin.spaces.
+        #   readonly` [OAuth 2.0 scopes](https://developers.google.com/workspace/chat/
+        #   authenticate-authorize#chat-api-scopes).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -329,11 +345,12 @@ module Google
         # @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_space(name, fields: nil, quota_user: nil, options: nil, &block)
+        def get_space(name, use_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1/{+name}', options)
           command.response_representation = Google::Apis::ChatV1::Space::Representation
           command.response_class = Google::Apis::ChatV1::Space
           command.params['name'] = name unless name.nil?
+          command.query['useAdminAccess'] = use_admin_access unless use_admin_access.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -406,7 +423,12 @@ module Google
         # already use this display name. Requires [user authentication](https://
         # developers.google.com/workspace/chat/authenticate-authorize-chat-user).
         # @param [String] name
-        #   Resource name of the space. Format: `spaces/`space``
+        #   Resource name of the space. Format: `spaces/`space`` Where ``space``
+        #   represents the system-assigned ID for the space. You can obtain the space ID
+        #   by calling the [`spaces.list()`](https://developers.google.com/workspace/chat/
+        #   api/reference/rest/v1/spaces/list) method or from the space URL. For example,
+        #   if the space URL is `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`,
+        #   the space ID is `AAAAAAAAA`.
         # @param [Google::Apis::ChatV1::Space] space_object
         # @param [String] update_mask
         #   Required. The updated field paths, comma separated if there are multiple. You
@@ -446,6 +468,15 @@ module Google
         #   permission_settings.reply_messages` (Warning: mutually exclusive with all
         #   other non-permission settings field paths). `permission_settings` is not
         #   supported with admin access.
+        # @param [Boolean] use_admin_access
+        #   [Developer Preview](https://developers.google.com/workspace/preview). 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 the `chat.admin.spaces` [OAuth 2.0 scope](https://
+        #   developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).
+        #   Some `FieldMask` values are not supported using admin access. For details, see
+        #   the description of `update_mask`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -463,7 +494,7 @@ module Google
         # @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 patch_space(name, space_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def patch_space(name, space_object = nil, update_mask: nil, use_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:patch, 'v1/{+name}', options)
           command.request_representation = Google::Apis::ChatV1::Space::Representation
           command.request_object = space_object
@@ -471,6 +502,108 @@ module Google
           command.response_class = Google::Apis::ChatV1::Space
           command.params['name'] = name unless name.nil?
           command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['useAdminAccess'] = use_admin_access unless use_admin_access.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # [Developer Preview](https://developers.google.com/workspace/preview). Returns
+        # a list of spaces based on a user's search. Requires [user authentication](
+        # https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+        # The user must be an administrator for the Google Workspace organization. In
+        # the request, set `use_admin_access` to `true`.
+        # @param [String] order_by
+        #   Optional. How the list of spaces is ordered. Supported attributes to order by
+        #   are: - `membership_count.joined_direct_human_user_count` — Denotes the count
+        #   of human users that have directly joined a space. - `last_active_time` —
+        #   Denotes the time when last eligible item is added to any topic of this space. -
+        #   `create_time` — Denotes the time of the space creation. Valid ordering
+        #   operation values are: - `ASC` for ascending. Default value. - `DESC` for
+        #   descending. The supported syntax are: - `membership_count.
+        #   joined_direct_human_user_count DESC` - `membership_count.
+        #   joined_direct_human_user_count ASC` - `last_active_time DESC` - `
+        #   last_active_time ASC` - `create_time DESC` - `create_time ASC`
+        # @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.
+        # @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
+        #   provided should match the call that provided the page token. Passing different
+        #   values to the other parameters might lead to unexpected results.
+        # @param [String] query
+        #   Required. A search query. You can search by using the following parameters: - `
+        #   create_time` - `customer` - `display_name` - `external_user_allowed` - `
+        #   last_active_time` - `space_history_state` - `space_type` `create_time` and `
+        #   last_active_time` accept a timestamp in [RFC-3339](https://www.rfc-editor.org/
+        #   rfc/rfc3339) format and the supported comparison operators are: `=`, `<`, `>`,
+        #   `<=`, `>=`. `customer` is required and is used to indicate which customer to
+        #   fetch spaces from. `customers/my_customer` is the only supported value. `
+        #   display_name` only accepts the `HAS` (`:`) operator. The text to match is
+        #   first tokenized into tokens and each token is prefix-matched case-
+        #   insensitively and independently as a substring anywhere in the space's `
+        #   display_name`. For example, `Fun Eve` matches `Fun event` or `The evening was
+        #   fun`, but not `notFun event` or `even`. `external_user_allowed` accepts either
+        #   `true` or `false`. `space_history_state` only accepts values from the [`
+        #   historyState`] (https://developers.google.com/workspace/chat/api/reference/
+        #   rest/v1/spaces#Space.HistoryState) field of a `space` resource. `space_type`
+        #   is required and the only valid value is `SPACE`. Across different fields, only
+        #   `AND` operators are supported. A valid example is `space_type = "SPACE" AND
+        #   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: ``` 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") ```
+        # @param [Boolean] use_admin_access
+        #   When `true`, the method runs using the user's Google Workspace administrator
+        #   privileges. The calling user must be a Google Workspace administrator with the
+        #   [manage chat and spaces conversations privilege](https://support.google.com/a/
+        #   answer/13369245). Requires either the `chat.admin.spaces.readonly` or `chat.
+        #   admin.spaces` [OAuth 2.0 scope](https://developers.google.com/workspace/chat/
+        #   authenticate-authorize#chat-api-scopes). This method currently only supports
+        #   admin access, thus only `true` is accepted for this field.
+        # @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::SearchSpacesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ChatV1::SearchSpacesResponse]
+        #
+        # @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 search_spaces(order_by: nil, page_size: nil, page_token: nil, query: nil, use_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/spaces:search', options)
+          command.response_representation = Google::Apis::ChatV1::SearchSpacesResponse::Representation
+          command.response_class = Google::Apis::ChatV1::SearchSpacesResponse
+          command.query['orderBy'] = order_by unless order_by.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['query'] = query unless query.nil?
+          command.query['useAdminAccess'] = use_admin_access unless use_admin_access.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -542,36 +675,32 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a human membership or app membership for the calling app. Creating
-        # memberships for other apps isn't supported. For an example, see [Invite or add
-        # a user or a Google Chat app to a space](https://developers.google.com/
-        # workspace/chat/create-members). When creating a membership, if the specified
-        # member has their auto-accept policy turned off, then they're invited, and must
-        # accept the space invitation before joining. Otherwise, creating a membership
-        # adds the member directly to the specified space. Requires [user authentication]
-        # (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-        # . To specify the member to add, set the `membership.member.name` for the human
-        # or app member, or set the `membership.group_member.name` for the group member.
-        # - To add the calling app to a space or a direct message between two human
-        # users, use `users/app`. Unable to add other apps to the space. - To add a
-        # human user, use `users/`user``, where ``user`` can be the email address for
-        # the user. For users in the same Workspace organization ``user`` can also be
-        # the `id` for the person from the People API, or the `id` for the user in the
-        # Directory API. For example, if the People API Person profile ID for `user@
-        # example.com` is `123456789`, you can add the user to the space by setting the `
-        # membership.member.name` to `users/user@example.com` or `users/123456789`. - To
-        # add or invite a Google group in a named space, use `groups/`group``, where ``
-        # group`` is the `id` for the group from the Cloud Identity Groups API. For
-        # example, you can use [Cloud Identity Groups lookup API](https://cloud.google.
-        # com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID `
-        # 123456789` for group email `group@example.com`, then you can add or invite the
-        # group to a named space by setting the `membership.group_member.name` to `
-        # groups/123456789`. Group email is not supported, and Google groups can only be
-        # added as members in named spaces.
+        # Creates a membership for the calling Chat app, a user, or a Google Group.
+        # Creating memberships for other Chat apps isn't supported. When creating a
+        # membership, if the specified member has their auto-accept policy turned off,
+        # then they're invited, and must accept the space invitation before joining.
+        # Otherwise, creating a membership adds the member directly to the specified
+        # space. Requires [user authentication](https://developers.google.com/workspace/
+        # chat/authenticate-authorize-chat-user). For example usage, see: - [Invite or
+        # add a user to a space](https://developers.google.com/workspace/chat/create-
+        # members#create-user-membership). - [Invite or add a Google Group to a space](
+        # https://developers.google.com/workspace/chat/create-members#create-group-
+        # membership). - [Add the Chat app to a space](https://developers.google.com/
+        # workspace/chat/create-members#create-membership-calling-api).
         # @param [String] parent
         #   Required. The resource name of the space for which to create the membership.
         #   Format: spaces/`space`
         # @param [Google::Apis::ChatV1::Membership] membership_object
+        # @param [Boolean] use_admin_access
+        #   [Developer Preview](https://developers.google.com/workspace/preview). 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 the `chat.admin.memberships` [OAuth 2.0 scope](
+        #   https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-
+        #   scopes). Creating app memberships or creating memberships for users outside
+        #   the administrator's Google Workspace organization isn't supported using admin
+        #   access.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -589,13 +718,14 @@ module Google
         # @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_member(parent, membership_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+        def create_space_member(parent, membership_object = nil, use_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:post, 'v1/{+parent}/members', options)
           command.request_representation = Google::Apis::ChatV1::Membership::Representation
           command.request_object = membership_object
           command.response_representation = Google::Apis::ChatV1::Membership::Representation
           command.response_class = Google::Apis::ChatV1::Membership
           command.params['parent'] = parent unless parent.nil?
+          command.query['useAdminAccess'] = use_admin_access unless use_admin_access.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -615,6 +745,15 @@ module Google
         #   deleting an app membership, requires the `chat.memberships.app` scope and `
         #   spaces/`space`/members/app` format. Format: `spaces/`space`/members/`member``
         #   or `spaces/`space`/members/app`.
+        # @param [Boolean] use_admin_access
+        #   [Developer Preview](https://developers.google.com/workspace/preview). 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 the `chat.admin.memberships` [OAuth 2.0 scope](
+        #   https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-
+        #   scopes). Deleting app memberships in a space isn't supported using admin
+        #   access.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -632,11 +771,12 @@ module Google
         # @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_member(name, fields: nil, quota_user: nil, options: nil, &block)
+        def delete_space_member(name, use_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:delete, 'v1/{+name}', options)
           command.response_representation = Google::Apis::ChatV1::Membership::Representation
           command.response_class = Google::Apis::ChatV1::Membership
           command.params['name'] = name unless name.nil?
+          command.query['useAdminAccess'] = use_admin_access unless use_admin_access.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -659,6 +799,15 @@ module Google
         #   user's email as an alias for ``member``. For example, `spaces/`space`/members/
         #   example@gmail.com` where `example@gmail.com` is the email of the Google Chat
         #   user.
+        # @param [Boolean] use_admin_access
+        #   [Developer Preview](https://developers.google.com/workspace/preview). 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 the `chat.admin.memberships` or `chat.admin.
+        #   memberships.readonly` [OAuth 2.0 scopes](https://developers.google.com/
+        #   workspace/chat/authenticate-authorize#chat-api-scopes). Getting app
+        #   memberships in a space isn't supported when using admin access.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -676,11 +825,12 @@ module Google
         # @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_space_member(name, fields: nil, quota_user: nil, options: nil, &block)
+        def get_space_member(name, use_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1/{+name}', options)
           command.response_representation = Google::Apis::ChatV1::Membership::Representation
           command.response_class = Google::Apis::ChatV1::Membership
           command.params['name'] = name unless name.nil?
+          command.query['useAdminAccess'] = use_admin_access unless use_admin_access.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -739,6 +889,15 @@ module Google
         #   invited memberships that don't match the filter criteria aren't returned.
         #   Currently requires [user authentication](https://developers.google.com/
         #   workspace/chat/authenticate-authorize-chat-user).
+        # @param [Boolean] use_admin_access
+        #   [Developer Preview](https://developers.google.com/workspace/preview). 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.memberships.readonly` or `
+        #   chat.admin.memberships` [OAuth 2.0 scope](https://developers.google.com/
+        #   workspace/chat/authenticate-authorize#chat-api-scopes). Listing app
+        #   memberships in a space isn't supported when using admin access.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -756,7 +915,7 @@ module Google
         # @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_members(parent, filter: nil, page_size: nil, page_token: nil, show_groups: nil, show_invited: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_space_members(parent, filter: nil, page_size: nil, page_token: nil, show_groups: nil, show_invited: nil, use_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1/{+parent}/members', options)
           command.response_representation = Google::Apis::ChatV1::ListMembershipsResponse::Representation
           command.response_class = Google::Apis::ChatV1::ListMembershipsResponse
@@ -766,6 +925,7 @@ module Google
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['showGroups'] = show_groups unless show_groups.nil?
           command.query['showInvited'] = show_invited unless show_invited.nil?
+          command.query['useAdminAccess'] = use_admin_access unless use_admin_access.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -782,6 +942,14 @@ module Google
         # @param [String] update_mask
         #   Required. The field paths to update. Separate multiple values with commas or
         #   use `*` to update all field paths. Currently supported field paths: - `role`
+        # @param [Boolean] use_admin_access
+        #   [Developer Preview](https://developers.google.com/workspace/preview). 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 the `chat.admin.memberships` [OAuth 2.0 scope](
+        #   https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-
+        #   scopes).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -799,7 +967,7 @@ module Google
         # @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 patch_space_member(name, membership_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def patch_space_member(name, membership_object = nil, update_mask: nil, use_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:patch, 'v1/{+name}', options)
           command.request_representation = Google::Apis::ChatV1::Membership::Representation
           command.request_object = membership_object
@@ -807,19 +975,27 @@ module Google
           command.response_class = Google::Apis::ChatV1::Membership
           command.params['name'] = name unless name.nil?
           command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['useAdminAccess'] = use_admin_access unless use_admin_access.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. 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
-        # create card messages.)
+        # Creates a message in a Google Chat space. For an example, see [Send a message](
+        # https://developers.google.com/workspace/chat/create-messages). The `create()`
+        # method requires either user or app authentication. Chat attributes the message
+        # sender differently depending on the type of authentication that you use in
+        # your request. The following image shows how Chat attributes a message when you
+        # use app authentication. Chat displays the Chat app as the message sender. The
+        # content of the message can contain text (`text`), cards (`cardsV2`), and
+        # accessory widgets (`accessoryWidgets`). ![Message sent with app authentication]
+        # (https://developers.google.com/workspace/chat/images/message-app-auth.svg) The
+        # following image shows how Chat attributes a message when you use user
+        # authentication. Chat displays the user as the message sender and attributes
+        # the Chat app to the message by displaying its name. The content of message can
+        # only contain text (`text`). ![Message sent with user authentication](https://
+        # developers.google.com/workspace/chat/images/message-user-auth.svg) The maximum
+        # message size, including the message contents, is 32,000 bytes.
         # @param [String] parent
         #   Required. The resource name of the space in which to create a message. Format:
         #   `spaces/`space``
@@ -969,9 +1145,12 @@ module Google
         end
         
         # Lists messages in a space that the caller is a member of, including messages
-        # from blocked members and spaces. For an example, see [List messages](/chat/api/
-        # guides/v1/messages/list). Requires [user authentication](https://developers.
-        # google.com/workspace/chat/authenticate-authorize-chat-user).
+        # from blocked members and spaces. If you list messages from a space with no
+        # messages, the response is an empty object. When using a REST/HTTP interface,
+        # the response contains an empty JSON object, ````. For an example, see [List
+        # messages](https://developers.google.com/workspace/chat/api/guides/v1/messages/
+        # list). Requires [user authentication](https://developers.google.com/workspace/
+        # chat/authenticate-authorize-chat-user).
         # @param [String] parent
         #   Required. The resource name of the space to list messages from. Format: `
         #   spaces/`space``

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-chat_v1
 version: !ruby/object:Gem::Version
-  version: 0.101.0
+  version: 0.103.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-08-18 00:00:00.000000000 Z
+date: 2024-09-01 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.101.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-chat_v1/v0.103.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-chat_v1
 post_install_message: 
 rdoc_options: []