google-apps-chat-v1 0.5.1 → 0.7.0

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

@@ -303,8 +303,28 @@ module Google
                 universe_domain: @config.universe_domain,
                 channel_args: @config.channel_args,
                 interceptors: @config.interceptors,
-                channel_pool_config: @config.channel_pool
+                channel_pool_config: @config.channel_pool,
+                logger: @config.logger
               )
+
+              @chat_service_stub.stub_logger&.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
@@ -313,8 +333,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
@@ -335,6 +358,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.
@@ -371,6 +400,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
@@ -447,7 +482,6 @@ module Google
 
               @chat_service_stub.call_rpc :create_message, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -461,6 +495,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).
             #
@@ -484,8 +519,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.
             #
@@ -494,16 +529,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`).
             #
@@ -541,10 +574,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.
             #
@@ -552,8 +583,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 [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Apps::Chat::V1::Message>]
@@ -619,7 +651,7 @@ module Google
               @chat_service_stub.call_rpc :list_messages, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @chat_service_stub, :list_messages, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -638,13 +670,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
@@ -739,7 +774,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
@@ -816,7 +851,7 @@ module Google
               @chat_service_stub.call_rpc :list_memberships, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @chat_service_stub, :list_memberships, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -827,13 +862,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
@@ -859,13 +897,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
@@ -937,7 +973,6 @@ module Google
 
               @chat_service_stub.call_rpc :get_membership, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -948,13 +983,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.
             #
@@ -1042,7 +1078,6 @@ module Google
 
               @chat_service_stub.call_rpc :get_message, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1056,13 +1091,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.
             #
@@ -1166,7 +1203,6 @@ module Google
 
               @chat_service_stub.call_rpc :update_message, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1177,13 +1213,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.
             #
@@ -1212,8 +1250,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).
@@ -1279,7 +1317,6 @@ module Google
 
               @chat_service_stub.call_rpc :delete_message, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1373,7 +1410,6 @@ module Google
 
               @chat_service_stub.call_rpc :get_attachment, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1383,6 +1419,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).
             #
@@ -1470,7 +1507,6 @@ module Google
 
               @chat_service_stub.call_rpc :upload_attachment, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1482,16 +1518,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)
@@ -1605,7 +1639,7 @@ module Google
               @chat_service_stub.call_rpc :list_spaces, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @chat_service_stub, :list_spaces, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1613,7 +1647,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`.
@@ -1813,7 +1849,7 @@ module Google
               @chat_service_stub.call_rpc :search_spaces, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @chat_service_stub, :search_spaces, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1824,13 +1860,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
@@ -1852,7 +1891,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
@@ -1921,28 +1960,33 @@ module Google
 
               @chat_service_stub.call_rpc :get_space, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => 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
@@ -1961,15 +2005,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.
@@ -2032,7 +2074,6 @@ module Google
 
               @chat_service_stub.call_rpc :create_space, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2220,7 +2261,6 @@ module Google
 
               @chat_service_stub.call_rpc :set_up_space, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2235,8 +2275,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
@@ -2320,7 +2370,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
@@ -2392,7 +2442,6 @@ module Google
 
               @chat_service_stub.call_rpc :update_space, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2404,9 +2453,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
@@ -2428,7 +2487,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
@@ -2497,7 +2556,6 @@ module Google
 
               @chat_service_stub.call_rpc :delete_space, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2507,8 +2565,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)
@@ -2590,7 +2651,6 @@ module Google
 
               @chat_service_stub.call_rpc :complete_import_space, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2602,20 +2662,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
@@ -2698,7 +2762,6 @@ module Google
 
               @chat_service_stub.call_rpc :find_direct_message, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2711,8 +2774,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:
             #
@@ -2747,23 +2821,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
@@ -2836,7 +2931,6 @@ module Google
 
               @chat_service_stub.call_rpc :create_membership, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2846,8 +2940,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
@@ -2875,7 +2979,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
@@ -2944,7 +3048,6 @@ module Google
 
               @chat_service_stub.call_rpc :update_membership, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2955,8 +3058,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
@@ -2989,7 +3102,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
@@ -3060,7 +3173,6 @@ module Google
 
               @chat_service_stub.call_rpc :delete_membership, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3071,6 +3183,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).
             #
@@ -3155,7 +3268,6 @@ module Google
 
               @chat_service_stub.call_rpc :create_reaction, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3165,6 +3277,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).
             #
@@ -3309,7 +3422,7 @@ module Google
               @chat_service_stub.call_rpc :list_reactions, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @chat_service_stub, :list_reactions, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3320,6 +3433,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).
             #
@@ -3402,7 +3516,6 @@ module Google
 
               @chat_service_stub.call_rpc :delete_reaction, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3508,7 +3621,6 @@ module Google
 
               @chat_service_stub.call_rpc :get_space_read_state, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3627,7 +3739,6 @@ module Google
 
               @chat_service_stub.call_rpc :update_space_read_state, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3734,7 +3845,6 @@ module Google
 
               @chat_service_stub.call_rpc :get_thread_read_state, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3838,7 +3948,6 @@ module Google
 
               @chat_service_stub.call_rpc :get_space_event, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3887,8 +3996,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
@@ -4011,7 +4120,7 @@ module Google
               @chat_service_stub.call_rpc :list_space_events, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @chat_service_stub, :list_space_events, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -4100,6 +4209,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
@@ -4124,6 +4238,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