google-apps-chat-v1 0.6.0 → 0.7.0

data/lib/google/apps/chat/v1/chat_service/rest/client.rb

@@ -296,8 +296,28 @@ module Google
                   endpoint: @config.endpoint,
                   endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
                   universe_domain: @config.universe_domain,
-                  credentials: credentials
+                  credentials: credentials,
+                  logger: @config.logger
                 )
+
+                @chat_service_stub.logger(stub: true)&.info do |entry|
+                  entry.set_system_name
+                  entry.set_service
+                  entry.message = "Created client for #{entry.service}"
+                  entry.set_credentials_fields credentials
+                  entry.set "customEndpoint", @config.endpoint if @config.endpoint
+                  entry.set "defaultTimeout", @config.timeout if @config.timeout
+                  entry.set "quotaProject", @quota_project_id if @quota_project_id
+                end
+              end
+
+              ##
+              # The logger used for request/response debug logging.
+              #
+              # @return [Logger]
+              #
+              def logger
+                @chat_service_stub.logger
               end
 
               # Service calls
@@ -306,8 +326,11 @@ module Google
               # 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
+              # The `create()` method requires either [user
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+              # or [app
+              # authentication](https://developers.google.com/workspace/chat/authorize-import).
+              # 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
@@ -328,6 +351,12 @@ module Google
               #
               # The maximum message size, including the message contents, is 32,000 bytes.
               #
+              # For
+              # [webhook](https://developers.google.com/workspace/chat/quickstart/webhooks)
+              # requests, the response doesn't contain the full message. The response only
+              # populates the `name` and `thread.name` fields in addition to the
+              # information that was in the request.
+              #
               # @overload create_message(request, options = nil)
               #   Pass arguments to `create_message` via a request object, either of type
               #   {::Google::Apps::Chat::V1::CreateMessageRequest} or an equivalent Hash.
@@ -364,6 +393,12 @@ module Google
               #   @param message_reply_option [::Google::Apps::Chat::V1::CreateMessageRequest::MessageReplyOption]
               #     Optional. Specifies whether a message starts a thread or replies to one.
               #     Only supported in named spaces.
+              #
+              #     When [responding to user
+              #     interactions](https://developers.google.com/workspace/chat/receive-respond-interactions),
+              #     this field 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 message_id [::String]
               #     Optional. A custom ID for a message. Lets Chat apps get, update, or delete
               #     a message without needing to store the system-assigned ID in the message's
@@ -433,7 +468,6 @@ module Google
 
                 @chat_service_stub.create_message request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -447,6 +481,7 @@ module Google
               # 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).
               #
@@ -470,8 +505,8 @@ module Google
               #
               #     Format: `spaces/{space}`
               #   @param page_size [::Integer]
-              #     The maximum number of messages returned. The service might return fewer
-              #     messages than this value.
+              #     Optional. The maximum number of messages returned. The service might return
+              #     fewer messages than this value.
               #
               #     If unspecified, at most 25 are returned.
               #
@@ -480,16 +515,14 @@ module Google
               #
               #     Negative values return an `INVALID_ARGUMENT` error.
               #   @param page_token [::String]
-              #     Optional, if resuming from a previous query.
-              #
-              #     A page token received from a previous list messages call. Provide this
-              #     parameter to retrieve the subsequent page.
+              #     Optional. A page token received from a previous list messages 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 filter [::String]
-              #     A query filter.
+              #     Optional. A query filter.
               #
               #     You can filter messages by date (`create_time`) and thread (`thread.name`).
               #
@@ -527,10 +560,8 @@ module Google
               #     Invalid queries are rejected by the server with an `INVALID_ARGUMENT`
               #     error.
               #   @param order_by [::String]
-              #     Optional, if resuming from a previous query.
-              #
-              #     How the list of messages is ordered. Specify a value to order by an
-              #     ordering operation. Valid ordering operation values are as follows:
+              #     Optional. How the list of messages is ordered. Specify a value to order by
+              #     an ordering operation. Valid ordering operation values are as follows:
               #
               #     - `ASC` for ascending.
               #
@@ -538,8 +569,9 @@ module Google
               #
               #     The default ordering is `create_time ASC`.
               #   @param show_deleted [::Boolean]
-              #     Whether to include deleted messages. Deleted messages include deleted time
-              #     and metadata about their deletion, but message content is unavailable.
+              #     Optional. Whether to include deleted messages. Deleted messages include
+              #     deleted time and metadata about their deletion, but message content is
+              #     unavailable.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Apps::Chat::V1::Message>]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -598,7 +630,7 @@ module Google
                 @chat_service_stub.list_messages request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @chat_service_stub, :list_messages, "messages", request, result, options
                   yield result, operation if block_given?
-                  return result
+                  throw :response, result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -617,13 +649,16 @@ module Google
               # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
               # lists memberships in spaces that the authenticated user has access to.
               #
-              # Requires
-              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
-              # Supports
-              # [app
+              # Supports the following types of
+              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
+              #
+              # - [App
               # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
-              # and [user
-              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+              #
+              # - [User
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+              # You can authenticate and authorize this method with administrator
+              # privileges by setting the `use_admin_access` field in the request.
               #
               # @overload list_memberships(request, options = nil)
               #   Pass arguments to `list_memberships` via a request object, either of type
@@ -718,7 +753,7 @@ module Google
               #     Currently requires [user
               #     authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
               #   @param use_admin_access [::Boolean]
-              #     When `true`, the method runs using the user's Google Workspace
+              #     Optional. When `true`, the method runs using the user's Google Workspace
               #     administrator privileges.
               #
               #     The calling user must be a Google Workspace administrator with the
@@ -788,7 +823,7 @@ module Google
                 @chat_service_stub.list_memberships request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @chat_service_stub, :list_memberships, "memberships", request, result, options
                   yield result, operation if block_given?
-                  return result
+                  throw :response, result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -799,13 +834,16 @@ module Google
               # [Get details about a user's or Google Chat app's
               # membership](https://developers.google.com/workspace/chat/get-members).
               #
-              # Requires
-              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
-              # Supports
-              # [app
+              # Supports the following types of
+              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
+              #
+              # - [App
               # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
-              # and [user
-              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+              #
+              # - [User
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+              # You can authenticate and authorize this method with administrator
+              # privileges by setting the `use_admin_access` field in the request.
               #
               # @overload get_membership(request, options = nil)
               #   Pass arguments to `get_membership` via a request object, either of type
@@ -831,13 +869,11 @@ module Google
               #
               #     Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`
               #
-              #     When [authenticated as a
-              #     user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
-              #     you can use the user's email as an alias for `{member}`. For example,
+              #     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 use_admin_access [::Boolean]
-              #     When `true`, the method runs using the user's Google Workspace
+              #     Optional. When `true`, the method runs using the user's Google Workspace
               #     administrator privileges.
               #
               #     The calling user must be a Google Workspace administrator with the
@@ -902,7 +938,6 @@ module Google
 
                 @chat_service_stub.get_membership request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -913,13 +948,14 @@ module Google
               # For an example, see [Get details about a
               # message](https://developers.google.com/workspace/chat/get-messages).
               #
-              # Requires
-              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
-              # Supports
-              # [app
+              # Supports the following types of
+              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
+              #
+              # - [App
               # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
-              # and [user
-              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+              #
+              # - [User
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
               #
               # Note: Might return a message from a blocked member or space.
               #
@@ -1000,7 +1036,6 @@ module Google
 
                 @chat_service_stub.get_message request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -1014,13 +1049,15 @@ module Google
               # [Update a
               # message](https://developers.google.com/workspace/chat/update-messages).
               #
-              # Requires
-              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
-              # Supports
-              # [app
+              # Supports the following types of
+              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
+              #
+              # - [App
               # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
-              # and [user
-              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+              #
+              # - [User
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+              #
               # When using app authentication, requests can only update messages
               # created by the calling Chat app.
               #
@@ -1117,7 +1154,6 @@ module Google
 
                 @chat_service_stub.update_message request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -1128,13 +1164,15 @@ module Google
               # For an example, see [Delete a
               # message](https://developers.google.com/workspace/chat/delete-messages).
               #
-              # Requires
-              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
-              # Supports
-              # [app
+              # Supports the following types of
+              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
+              #
+              # - [App
               # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
-              # and [user
-              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+              #
+              # - [User
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+              #
               # When using app authentication, requests can only delete messages
               # created by the calling Chat app.
               #
@@ -1163,8 +1201,8 @@ module Google
               #     message]
               #     (https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
               #   @param force [::Boolean]
-              #     When `true`, deleting a message also deletes its threaded replies. When
-              #     `false`, if a message has threaded replies, deletion fails.
+              #     Optional. When `true`, deleting a message also deletes its threaded
+              #     replies. When `false`, if a message has threaded replies, deletion fails.
               #
               #     Only applies when [authenticating as a
               #     user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -1223,7 +1261,6 @@ module Google
 
                 @chat_service_stub.delete_message request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -1310,7 +1347,6 @@ module Google
 
                 @chat_service_stub.get_attachment request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -1320,6 +1356,7 @@ module Google
               # Uploads an attachment. For an example, see
               # [Upload media as a file
               # attachment](https://developers.google.com/workspace/chat/upload-media-attachments).
+              #
               # Requires user
               # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
               #
@@ -1400,7 +1437,6 @@ module Google
 
                 @chat_service_stub.upload_attachment request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -1412,16 +1448,14 @@ module Google
               # [List
               # spaces](https://developers.google.com/workspace/chat/list-spaces).
               #
-              # Requires
-              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
-              # Supports
-              # [app
+              # Supports the following types of
+              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
+              #
+              # - [App
               # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
-              # and [user
-              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
               #
-              # Lists spaces visible to the caller or authenticated user. Group chats
-              # and DMs aren't listed until the first message is sent.
+              # - [User
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
               #
               # To list all named spaces by Google Workspace organization, use the
               # [`spaces.search()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/search)
@@ -1536,7 +1570,7 @@ module Google
                 @chat_service_stub.list_spaces request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @chat_service_stub, :list_spaces, "spaces", request, result, options
                   yield result, operation if block_given?
-                  return result
+                  throw :response, result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -1544,7 +1578,9 @@ module Google
 
               ##
               # Returns a list of spaces in a Google Workspace organization based on an
-              # administrator's search. Requires [user
+              # administrator's search.
+              #
+              # Requires [user
               # authentication with administrator
               # privileges](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user#admin-privileges).
               # In the request, set `use_admin_access` to `true`.
@@ -1745,7 +1781,7 @@ module Google
                 @chat_service_stub.search_spaces request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @chat_service_stub, :search_spaces, "spaces", request, result, options
                   yield result, operation if block_given?
-                  return result
+                  throw :response, result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -1756,13 +1792,16 @@ module Google
               # [Get details about a
               # space](https://developers.google.com/workspace/chat/get-spaces).
               #
-              # Requires
-              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
-              # Supports
-              # [app
+              # Supports the following types of
+              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
+              #
+              # - [App
               # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
-              # and [user
-              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+              #
+              # - [User
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+              # You can authenticate and authorize this method with administrator
+              # privileges by setting the `use_admin_access` field in the request.
               #
               # @overload get_space(request, options = nil)
               #   Pass arguments to `get_space` via a request object, either of type
@@ -1784,7 +1823,7 @@ module Google
               #
               #     Format: `spaces/{space}`
               #   @param use_admin_access [::Boolean]
-              #     When `true`, the method runs using the user's Google Workspace
+              #     Optional. When `true`, the method runs using the user's Google Workspace
               #     administrator privileges.
               #
               #     The calling user must be a Google Workspace administrator with the
@@ -1846,28 +1885,33 @@ module Google
 
                 @chat_service_stub.get_space request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
               end
 
               ##
-              # Creates a space with no members. Can be used to create a named space.
-              # Spaces grouped by topics aren't supported. For an example, see
-              # [Create a
+              # Creates a space with no members. Can be used to create a named space, or a
+              # group chat in `Import mode`. For an example, see [Create a
               # space](https://developers.google.com/workspace/chat/create-spaces).
               #
               #  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.
               #
-              # If you're a member of the [Developer Preview
-              # program](https://developers.google.com/workspace/preview), you can create a
-              # group chat in import mode using `spaceType.GROUP_CHAT`.
+              # Supports the following types of
+              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
               #
-              # Requires [user
-              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+              # - [App
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+              # with [administrator approval](https://support.google.com/a?p=chat-app-auth)
+              # in [Developer Preview](https://developers.google.com/workspace/preview)
+              #
+              # - [User
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+              #
+              # When authenticating as an app, the `space.customer` field must be set in
+              # the request.
               #
               # @overload create_space(request, options = nil)
               #   Pass arguments to `create_space` via a request object, either of type
@@ -1886,15 +1930,13 @@ module Google
               #
               #   @param space [::Google::Apps::Chat::V1::Space, ::Hash]
               #     Required. The `displayName` and `spaceType` fields must be populated.  Only
-              #     `SpaceType.SPACE` is supported.
+              #     `SpaceType.SPACE`  and `SpaceType.GROUP_CHAT` are supported.
+              #     `SpaceType.GROUP_CHAT` can only be used if `importMode` is set to true.
               #
               #     If you receive the error message `ALREADY_EXISTS`,
               #     try a different `displayName`. An existing space within the Google
               #     Workspace organization might already use this display name.
               #
-              #     If you're a member of the [Developer Preview
-              #     program](https://developers.google.com/workspace/preview),
-              #     `SpaceType.GROUP_CHAT` can be used if `importMode` is set to true.
               #
               #     The space `name` is assigned on the server so anything specified in this
               #     field will be ignored.
@@ -1958,7 +2000,6 @@ module Google
 
                 @chat_service_stub.create_space request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -2147,7 +2188,6 @@ module Google
 
                 @chat_service_stub.set_up_space request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -2162,8 +2202,18 @@ module Google
               # `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/workspace/chat/authenticate-authorize-chat-user).
+              # Supports the following types of
+              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
+              #
+              # - [App
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+              # with [administrator approval](https://support.google.com/a?p=chat-app-auth)
+              # in [Developer Preview](https://developers.google.com/workspace/preview)
+              #
+              # - [User
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+              # You can authenticate and authorize this method with administrator
+              # privileges by setting the `use_admin_access` field in the request.
               #
               # @overload update_space(request, options = nil)
               #   Pass arguments to `update_space` via a request object, either of type
@@ -2247,7 +2297,7 @@ module Google
               #     - `permission_settings.manageWebhooks`
               #     - `permission_settings.replyMessages`
               #   @param use_admin_access [::Boolean]
-              #     When `true`, the method runs using the user's Google Workspace
+              #     Optional. When `true`, the method runs using the user's Google Workspace
               #     administrator privileges.
               #
               #     The calling user must be a Google Workspace administrator with the
@@ -2312,7 +2362,6 @@ module Google
 
                 @chat_service_stub.update_space request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -2324,9 +2373,19 @@ module Google
               # memberships in the space—are also deleted. For an example, see
               # [Delete a
               # space](https://developers.google.com/workspace/chat/delete-spaces).
-              # Requires [user
+              #
+              # Supports the following types of
+              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
+              #
+              # - [App
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+              # with [administrator approval](https://support.google.com/a?p=chat-app-auth)
+              # in [Developer Preview](https://developers.google.com/workspace/preview)
+              #
+              # - [User
               # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-              # from a user who has permission to delete the space.
+              # You can authenticate and authorize this method with administrator
+              # privileges by setting the `use_admin_access` field in the request.
               #
               # @overload delete_space(request, options = nil)
               #   Pass arguments to `delete_space` via a request object, either of type
@@ -2348,7 +2407,7 @@ module Google
               #
               #     Format: `spaces/{space}`
               #   @param use_admin_access [::Boolean]
-              #     When `true`, the method runs using the user's Google Workspace
+              #     Optional. When `true`, the method runs using the user's Google Workspace
               #     administrator privileges.
               #
               #     The calling user must be a Google Workspace administrator with the
@@ -2410,7 +2469,6 @@ module Google
 
                 @chat_service_stub.delete_space request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -2420,8 +2478,11 @@ module Google
               # Completes the
               # [import process](https://developers.google.com/workspace/chat/import-data)
               # for the specified space and makes it visible to users.
-              # Requires app authentication and domain-wide delegation. For more
-              # information, see [Authorize Google Chat apps to import
+              #
+              # Requires [app
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+              # and domain-wide delegation. For more information, see [Authorize Google
+              # Chat apps to import
               # data](https://developers.google.com/workspace/chat/authorize-import).
               #
               # @overload complete_import_space(request, options = nil)
@@ -2496,7 +2557,6 @@ module Google
 
                 @chat_service_stub.complete_import_space request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -2508,20 +2568,24 @@ module Google
               # see
               # [Find a direct message](/chat/api/guides/v1/spaces/find-direct-message).
               #
+              # With [app
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app),
+              # returns the direct message space between the specified user and the calling
+              # Chat app.
+              #
               # With [user
               # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
               # returns the direct message space between the specified user and the
               # authenticated user.
               #
-              # With [app
-              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app),
-              # returns the direct message space between the specified user and the calling
-              # Chat app.
+              # // Supports the following types of
+              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
               #
-              # Requires [user
+              # - [App
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+              #
+              # - [User
               # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
-              # or [app
-              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
               #
               # @overload find_direct_message(request, options = nil)
               #   Pass arguments to `find_direct_message` via a request object, either of type
@@ -2605,7 +2669,6 @@ module Google
 
                 @chat_service_stub.find_direct_message request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -2618,8 +2681,19 @@ module Google
               # 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).
+              #
+              # Supports the following types of
+              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
+              #
+              # - [App
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+              # with [administrator approval](https://support.google.com/a?p=chat-app-auth)
+              # in [Developer Preview](https://developers.google.com/workspace/preview)
+              #
+              # - [User
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+              # You can authenticate and authorize this method with administrator
+              # privileges by setting the `use_admin_access` field in the request.
               #
               # For example usage, see:
               #
@@ -2654,23 +2728,44 @@ module Google
               #     Format: spaces/\\{space}
               #   @param membership [::Google::Apps::Chat::V1::Membership, ::Hash]
               #     Required. The membership relation to create.
+              #
               #     The `memberType` field must contain a user with the `user.name` and
               #     `user.type` fields populated. The server will assign a resource name
               #     and overwrite anything specified.
+              #
               #     When a Chat app creates a membership relation for a human user, it must use
-              #     the `chat.memberships` scope, set `user.type` to `HUMAN`, and set
-              #     `user.name` with format `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` of the
-              #     [person](https://developers.google.com/people/api/rest/v1/people) 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`. When a Chat app creates a
-              #     membership relation for itself, it must use the `chat.memberships.app`
-              #     scope, set `user.type` to `BOT`, and set `user.name` to `users/app`.
+              #     certain authorization scopes and set specific values for certain fields:
+              #
+              #     - When [authenticating as a
+              #     user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
+              #     the `chat.memberships` authorization scope is required.
+              #
+              #     - When [authenticating as an
+              #     app](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app),
+              #     the `chat.app.memberships` authorization scope is required.
+              #     Authenticating as an app is available in [Developer
+              #     Preview](https://developers.google.com/workspace/preview).
+              #
+              #     - Set `user.type` to `HUMAN`, and set `user.name` with format
+              #     `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` of
+              #     the [person](https://developers.google.com/people/api/rest/v1/people) 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`.
+              #
+              #     Inviting users external to the Workspace organization that owns the space
+              #     requires [user
+              #     authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+              #
+              #     When a Chat app creates a membership relation for itself, it must
+              #     [authenticate as a
+              #     user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+              #     and use the `chat.memberships.app` scope, set `user.type` to `BOT`, and set
+              #     `user.name` to `users/app`.
               #   @param use_admin_access [::Boolean]
-              #     When `true`, the method runs using the user's Google Workspace
+              #     Optional. When `true`, the method runs using the user's Google Workspace
               #     administrator privileges.
               #
               #     The calling user must be a Google Workspace administrator with the
@@ -2736,7 +2831,6 @@ module Google
 
                 @chat_service_stub.create_membership request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -2746,8 +2840,18 @@ module Google
               # Updates a membership. For an example, see [Update a user's membership in
               # a space](https://developers.google.com/workspace/chat/update-members).
               #
-              # Requires [user
-              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+              # Supports the following types of
+              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
+              #
+              # - [App
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+              # with [administrator approval](https://support.google.com/a?p=chat-app-auth)
+              # in [Developer Preview](https://developers.google.com/workspace/preview)
+              #
+              # - [User
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+              # You can authenticate and authorize this method with administrator
+              # privileges by setting the `use_admin_access` field in the request.
               #
               # @overload update_membership(request, options = nil)
               #   Pass arguments to `update_membership` via a request object, either of type
@@ -2775,7 +2879,7 @@ module Google
               #
               #     - `role`
               #   @param use_admin_access [::Boolean]
-              #     When `true`, the method runs using the user's Google Workspace
+              #     Optional. When `true`, the method runs using the user's Google Workspace
               #     administrator privileges.
               #
               #     The calling user must be a Google Workspace administrator with the
@@ -2837,7 +2941,6 @@ module Google
 
                 @chat_service_stub.update_membership request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -2848,8 +2951,18 @@ module Google
               # [Remove a user or a Google Chat app from a
               # space](https://developers.google.com/workspace/chat/delete-members).
               #
-              # Requires [user
-              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+              # Supports the following types of
+              # [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
+              #
+              # - [App
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+              # with [administrator approval](https://support.google.com/a?p=chat-app-auth)
+              # in [Developer Preview](https://developers.google.com/workspace/preview)
+              #
+              # - [User
+              # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+              # You can authenticate and authorize this method with administrator
+              # privileges by setting the `use_admin_access` field in the request.
               #
               # @overload delete_membership(request, options = nil)
               #   Pass arguments to `delete_membership` via a request object, either of type
@@ -2882,7 +2995,7 @@ module Google
               #
               #     Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`.
               #   @param use_admin_access [::Boolean]
-              #     When `true`, the method runs using the user's Google Workspace
+              #     Optional. When `true`, the method runs using the user's Google Workspace
               #     administrator privileges.
               #
               #     The calling user must be a Google Workspace administrator with the
@@ -2946,7 +3059,6 @@ module Google
 
                 @chat_service_stub.delete_membership request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -2957,6 +3069,7 @@ module Google
               # supported. For an example, see
               # [Add a reaction to a
               # message](https://developers.google.com/workspace/chat/create-reactions).
+              #
               # Requires [user
               # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
               #
@@ -3034,7 +3147,6 @@ module Google
 
                 @chat_service_stub.create_reaction request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -3044,6 +3156,7 @@ module Google
               # Lists reactions to a message. For an example, see
               # [List reactions for a
               # message](https://developers.google.com/workspace/chat/list-reactions).
+              #
               # Requires [user
               # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
               #
@@ -3181,7 +3294,7 @@ module Google
                 @chat_service_stub.list_reactions request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @chat_service_stub, :list_reactions, "reactions", request, result, options
                   yield result, operation if block_given?
-                  return result
+                  throw :response, result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -3192,6 +3305,7 @@ module Google
               # For an example, see
               # [Delete a
               # reaction](https://developers.google.com/workspace/chat/delete-reactions).
+              #
               # Requires [user
               # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
               #
@@ -3267,7 +3381,6 @@ module Google
 
                 @chat_service_stub.delete_reaction request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -3366,7 +3479,6 @@ module Google
 
                 @chat_service_stub.get_space_read_state request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -3478,7 +3590,6 @@ module Google
 
                 @chat_service_stub.update_space_read_state request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -3578,7 +3689,6 @@ module Google
 
                 @chat_service_stub.get_thread_read_state request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -3675,7 +3785,6 @@ module Google
 
                 @chat_service_stub.get_space_event request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -3724,8 +3833,8 @@ module Google
               #
               #     Negative values return an `INVALID_ARGUMENT` error.
               #   @param page_token [::String]
-              #     A page token, received from a previous list space events call. Provide this
-              #     to retrieve the subsequent page.
+              #     Optional. A page token, received from a previous list space events call.
+              #     Provide this to retrieve the subsequent page.
               #
               #     When paginating, all other parameters provided to list space events must
               #     match the call that provided the page token. Passing different values to
@@ -3841,7 +3950,7 @@ module Google
                 @chat_service_stub.list_space_events request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @chat_service_stub, :list_space_events, "space_events", request, result, options
                   yield result, operation if block_given?
-                  return result
+                  throw :response, result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -3921,6 +4030,11 @@ module Google
               #   default endpoint URL. The default value of nil uses the environment
               #   universe (usually the default "googleapis.com" universe).
               #   @return [::String,nil]
+              # @!attribute [rw] logger
+              #   A custom logger to use for request/response debug logging, or the value
+              #   `:default` (the default) to construct a default logger, or `nil` to
+              #   explicitly disable logging.
+              #   @return [::Logger,:default,nil]
               #
               class Configuration
                 extend ::Gapic::Config
@@ -3942,6 +4056,7 @@ module Google
                 config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
                 config_attr :quota_project, nil, ::String, nil
                 config_attr :universe_domain, nil, ::String, nil
+                config_attr :logger, :default, ::Logger, nil, :default
 
                 # @private
                 def initialize parent_config = nil