google-apis-chat_v1 0.66.0 → 0.68.0

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.66.0"
+      GEM_VERSION = "0.68.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230718"
+      REVISION = "20230806"
     end
   end
 end

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

@@ -1522,6 +1522,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :admin_installed, as: 'adminInstalled'
           property :display_name, as: 'displayName'
+          property :external_user_allowed, as: 'externalUserAllowed'
           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

@@ -139,11 +139,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a named space. Spaces grouped by topics or that have guest access aren'
-        # t supported. For an example, see [Create a space](https://developers.google.
-        # com/chat/api/guides/v1/spaces/create). Requires [user authentication](https://
-        # developers.google.com/chat/api/guides/auth/users) and the `chat.spaces.create`
-        # or `chat.spaces` scope.
+        # Creates a named space. Spaces grouped by topics aren't supported. For an
+        # example, see [Create a space](https://developers.google.com/chat/api/guides/v1/
+        # spaces/create). If you receive the error message `ALREADY_EXISTS` when
+        # creating a space, try a different `displayName`. An existing space within the
+        # Google Workspace organization might already use this display name. Requires [
+        # user authentication](https://developers.google.com/chat/api/guides/auth/users)
+        # and the `chat.spaces.create` or `chat.spaces` scope.
         # @param [Google::Apis::ChatV1::Space] space_object
         # @param [String] request_id
         #   Optional. A unique identifier for this request. A random UUID is recommended.
@@ -232,7 +234,10 @@ module Google
         #   or the `id` for the [user](https://developers.google.com/admin-sdk/directory/
         #   reference/rest/v1/users) in the Directory API. For example, if the People API `
         #   Person.resourceName` is `people/123456789`, you can find a direct message with
-        #   that person by using `users/123456789` as the `name`.
+        #   that person by using `users/123456789` as the `name`. When [authenticated as a
+        #   user](https://developers.google.com/chat/api/guides/auth/users), you can use
+        #   the email as an alias for ``user``. For example, `users/example@gmail.com`
+        #   where `example@gmail.com` is the email of the Google Chat user.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -362,9 +367,12 @@ module Google
         end
         
         # Updates a space. For an example, see [Update a space](https://developers.
-        # google.com/chat/api/guides/v1/spaces/update). Requires [user authentication](
-        # https://developers.google.com/chat/api/guides/auth/users) and the `chat.spaces`
-        # scope.
+        # google.com/chat/api/guides/v1/spaces/update). If you're updating the `
+        # displayName` field and receive the error message `ALREADY_EXISTS`, try a
+        # different display name.. An existing space within the Google Workspace
+        # organization might already use this display name. Requires [user
+        # authentication](https://developers.google.com/chat/api/guides/auth/users) and
+        # the `chat.spaces` scope.
         # @param [String] name
         #   Resource name of the space. Format: `spaces/`space``
         # @param [Google::Apis::ChatV1::Space] space_object
@@ -374,18 +382,20 @@ module Google
         #   display name of a space with the `SPACE` type, or when also including the `
         #   space_type` mask to change a `GROUP_CHAT` space type to `SPACE`. Trying to
         #   update the display name of a `GROUP_CHAT` or a `DIRECT_MESSAGE` space results
-        #   in an invalid argument error.) - `space_type` (Only supports changing a `
-        #   GROUP_CHAT` space type to `SPACE`. Include `display_name` together with `
-        #   space_type` in the update mask and ensure that the specified space has a non-
-        #   empty display name and the `SPACE` space type. Including the `space_type` mask
-        #   and the `SPACE` type in the specified space when updating the display name is
-        #   optional if the existing space already has the `SPACE` type. Trying to update
-        #   the space type in other ways results in an invalid argument error). - `
-        #   space_details` - `space_history_state` (Supports [turning history on or off
-        #   for the space](https://support.google.com/chat/answer/7664687) if [the
-        #   organization allows users to change their history setting](https://support.
-        #   google.com/a/answer/7664184). Warning: mutually exclusive with all other field
-        #   paths.)
+        #   in an invalid argument error. If you receive the error message `ALREADY_EXISTS`
+        #   when updating the `displayName`, try a different `displayName`. An existing
+        #   space within the Google Workspace organization might already use this display
+        #   name.) - `space_type` (Only supports changing a `GROUP_CHAT` space type to `
+        #   SPACE`. Include `display_name` together with `space_type` in the update mask
+        #   and ensure that the specified space has a non-empty display name and the `
+        #   SPACE` space type. Including the `space_type` mask and the `SPACE` type in the
+        #   specified space when updating the display name is optional if the existing
+        #   space already has the `SPACE` type. Trying to update the space type in other
+        #   ways results in an invalid argument error). - `space_details` - `
+        #   space_history_state` (Supports [turning history on or off for the space](https:
+        #   //support.google.com/chat/answer/7664687) if [the organization allows users to
+        #   change their history setting](https://support.google.com/a/answer/7664184).
+        #   Warning: mutually exclusive with all other field paths.)
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -421,27 +431,30 @@ module Google
         # in the request. For an example, see [Set up a space](https://developers.google.
         # com/chat/api/guides/v1/spaces/set-up). To specify the human members to add,
         # add memberships with the appropriate `member.name` in the `SetUpSpaceRequest`.
-        # To add a human user, use `users/`user``, where ``user`` is either the ``
-        # person_id`` for the [person](https://developers.google.com/people/api/rest/v1/
-        # people) from the People API, or the `id` for the [user](https://developers.
-        # google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK
-        # Directory API. For example, if the People API `Person` `resourceName` is `
-        # people/123456789`, you can add the user to the space by including a membership
-        # with `users/123456789` as the `member.name`. For a space or group chat, if the
-        # caller blocks or is blocked by some members, then those members aren't added
-        # to the created space. To create a direct message (DM) between the calling user
-        # and another human user, specify exactly one membership to represent the human
-        # user. If one user blocks the other, the request fails and the DM isn't created.
-        # To create a DM between the calling user and the calling app, set `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 ``person_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 `
+        # resourceName` for `user@example.com` is `people/123456789`, you can add the
+        # user to the space by setting the `membership.member.name` to `users/user@
+        # example.com` or `users/123456789`. For a space or group chat, if the caller
+        # blocks or is blocked by some members, then those members aren't added to the
+        # created space. To create a direct message (DM) between the calling user and
+        # another human user, specify exactly one membership to represent the human user.
+        # If one user blocks the other, the request fails and the DM isn't created. To
+        # create a DM between the calling user and the calling app, set `Space.
         # singleUserBotDm` to `true` and don't specify any memberships. You can only use
         # this method to set up a DM with the calling app. To add the calling app as a
         # member of a space or an existing DM between two human users, see [create a
         # membership](https://developers.google.com/chat/api/guides/v1/members/create).
         # If a DM already exists between two users, even when one user blocks the other
         # at the time a request is made, then the existing DM is returned. Spaces with
-        # threaded replies or guest access aren't supported. Requires [user
-        # authentication](https://developers.google.com/chat/api/guides/auth/users) and
-        # the `chat.spaces.create` or `chat.spaces` scope.
+        # threaded replies aren't supported. If you receive the error message `
+        # ALREADY_EXISTS` when setting up a space, try a different `displayName`. An
+        # existing space within the Google Workspace organization might already use this
+        # display name. Requires [user authentication](https://developers.google.com/
+        # chat/api/guides/auth/users) and the `chat.spaces.create` or `chat.spaces`
+        # scope.
         # @param [Google::Apis::ChatV1::SetUpSpaceRequest] set_up_space_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -483,13 +496,13 @@ module Google
         # the member to add, set the `membership.member.name` in the `
         # CreateMembershipRequest`: - 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`` is either
-        # the ``person_id`` for the [person](https://developers.google.com/people/api/
-        # rest/v1/people) from the People API, or the `id` for the [user](https://
-        # developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the
-        # Directory API. For example, if the People API `Person` `resourceName` is `
-        # people/123456789`, you can add the user to the space by setting the `
-        # membership.member.name` to `users/123456789`.
+        # 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 ``person_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 `resourceName` for `user@example.com` is `people/123456789`, you can
+        # add the user to the space by setting the `membership.member.name` to `users/
+        # user@example.com` or `users/123456789`.
         # @param [String] parent
         #   Required. The resource name of the space for which to create the membership.
         #   Format: spaces/`space`
@@ -531,10 +544,12 @@ module Google
         #   Required. Resource name of the membership to delete. Chat apps can delete
         #   human users' or their own memberships. Chat apps can't delete other apps'
         #   memberships. When deleting a human membership, requires the `chat.memberships`
-        #   scope and `spaces/`space`/members/`member`` format. When 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`
+        #   scope and `spaces/`space`/members/`member`` format. You can use the 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. When
+        #   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 [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -573,7 +588,11 @@ module Google
         # @param [String] name
         #   Required. Resource name of the membership to retrieve. To get the app's own
         #   membership, you can optionally use `spaces/`space`/members/app`. Format: `
-        #   spaces/`space`/members/`member`` or `spaces/`space`/members/app`
+        #   spaces/`space`/members/`member`` or `spaces/`space`/members/app` When [
+        #   authenticated as a user](https://developers.google.com/chat/api/guides/auth/
+        #   users), you can use the 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 [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -716,11 +735,11 @@ module Google
         #   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.
         # @param [String] thread_key
-        #   Optional. Deprecated: Use thread.thread_key instead. Opaque thread identifier.
-        #   To start or add to a thread, create a message and specify a `threadKey` or the
-        #   thread.name. For example usage, see [Start or reply to a message thread](https:
-        #   //developers.google.com/chat/api/guides/crudl/messages#
-        #   start_or_reply_to_a_message_thread).
+        #   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
+        #   and specify a `threadKey` or the thread.name. For example usage, see [Start or
+        #   reply to a message thread](https://developers.google.com/chat/api/guides/crudl/
+        #   messages#start_or_reply_to_a_message_thread).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -761,6 +780,8 @@ module Google
         # service-accounts) and [user authentication](https://developers.google.com/chat/
         # api/guides/auth/users). [User authentication](https://developers.google.com/
         # chat/api/guides/auth/users) requires the `chat.messages` authorization scope.
+        # Requests authenticated with service accounts can only delete messages created
+        # by the calling Chat app.
         # @param [String] name
         #   Required. Resource name of the message that you want to delete, in the form `
         #   spaces/*/messages/*` Example: `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.
@@ -846,8 +867,7 @@ module Google
         # from blocked members and spaces. For an example, see [List messages](/chat/api/
         # guides/v1/messages/list). Requires [user authentication](https://developers.
         # google.com/chat/api/guides/auth/users) and the `chat.messages` or `chat.
-        # messages.readonly` authorization scope. This method is only supported in
-        # spaces that don't allow users from outside the Workspace organization to join.
+        # messages.readonly` authorization scope.
         # @param [String] parent
         #   Required. The resource name of the space to list messages from. Format: `
         #   spaces/`space``
@@ -929,7 +949,8 @@ module Google
         # developers.google.com/chat/api/guides/auth/service-accounts) and [user
         # authentication](https://developers.google.com/chat/api/guides/auth/users). [
         # User authentication](https://developers.google.com/chat/api/guides/auth/users)
-        # requires the `chat.messages` authorization scope.
+        # requires the `chat.messages` authorization scope. Requests authenticated with
+        # service accounts can only update messages created by the calling Chat app.
         # @param [String] name
         #   Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAAAAAAAA/
         #   messages/BBBBBBBBBBB.BBBBBBBBBBB`
@@ -985,7 +1006,8 @@ module Google
         # developers.google.com/chat/api/guides/auth/service-accounts) and [user
         # authentication](https://developers.google.com/chat/api/guides/auth/users). [
         # User authentication](https://developers.google.com/chat/api/guides/auth/users)
-        # requires the `chat.messages` authorization scope.
+        # requires the `chat.messages` authorization scope. Requests authenticated with
+        # service accounts can only update messages created by the calling Chat app.
         # @param [String] name
         #   Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAAAAAAAA/
         #   messages/BBBBBBBBBBB.BBBBBBBBBBB`

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-chat_v1
 version: !ruby/object:Gem::Version
-  version: 0.66.0
+  version: 0.68.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-23 00:00:00.000000000 Z
+date: 2023-08-13 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.66.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-chat_v1/v0.68.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-chat_v1
 post_install_message: 
 rdoc_options: []