google-cloud-discovery_engine-v1 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 306438ed318930a8ee23b1dd270409ae339a7983ec20e91f80c2cda12c1e1d7b
-  data.tar.gz: 230071de9c9a8a67101e0966546cee0a744f87e2c2cbf4092107bb1c41c81a02
+  metadata.gz: 39f4cfab73f26e066f4715721e27c8b3ee7810b276e05734a31126c14c2be92c
+  data.tar.gz: 52b0cfdc1bdd1532479cc6d6d0570a6eb7bcb90c353c3eeed18779f93d213c9a
 SHA512:
-  metadata.gz: 7016c29e371de9b2544be90f8269679242fbf0190fe157931fee000c76049fd43251e9cb3329b5dd7a1a1e13270267178153990df0f9a1f1c3e71e32577042da
-  data.tar.gz: 6d82f54321e189c5d1f84f8d6a7f7f3a081f12ddb21421d03485d939d201fbcdc06699513d7d2dc39d129becd70859445c7cf70d1764e79232a726e7847f3b25
+  metadata.gz: '09a3fd20e39261f8218522f5f84a632c92709fea840bda36cdf27c41e3a987cfba09849792f86ff978b824a1f56c27f093858c446c1d61ff989be371bc3552d4'
+  data.tar.gz: 5f2b0d690720dcc65fb9c7fe992d9016d0adc19cb0cc9f8db6cfd2a9a20afaff0014b590ad1744e208317b4494ad9f6952d1410ffa62b5f63ffb798e41beb0d7

data/lib/google/cloud/discovery_engine/v1/conversational_search_service/client.rb

@@ -840,7 +840,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload answer_query(serving_config: nil, query: nil, session: nil, safety_spec: nil, related_questions_spec: nil, answer_generation_spec: nil, search_spec: nil, query_understanding_spec: nil, asynchronous_mode: nil, user_pseudo_id: nil, user_labels: nil)
+            # @overload answer_query(serving_config: nil, query: nil, session: nil, safety_spec: nil, related_questions_spec: nil, grounding_spec: nil, answer_generation_spec: nil, search_spec: nil, query_understanding_spec: nil, asynchronous_mode: nil, user_pseudo_id: nil, user_labels: nil, end_user_spec: nil)
             #   Pass arguments to `answer_query` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -865,6 +865,8 @@ module Google
             #     Model specification.
             #   @param related_questions_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::RelatedQuestionsSpec, ::Hash]
             #     Related questions specification.
+            #   @param grounding_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::GroundingSpec, ::Hash]
+            #     Optional. Grounding specification.
             #   @param answer_generation_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::AnswerGenerationSpec, ::Hash]
             #     Answer generation specification.
             #   @param search_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::SearchSpec, ::Hash]
@@ -912,6 +914,8 @@ module Google
             #     See [Google Cloud
             #     Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
             #     for more details.
+            #   @param end_user_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::EndUserSpec, ::Hash]
+            #     Optional. End user specification.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryResponse]
@@ -977,6 +981,169 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Answer query method (streaming).
+            #
+            # It takes one
+            # {::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest AnswerQueryRequest}
+            # and returns multiple
+            # {::Google::Cloud::DiscoveryEngine::V1::AnswerQueryResponse AnswerQueryResponse}
+            # messages in a stream.
+            #
+            # @overload stream_answer_query(request, options = nil)
+            #   Pass arguments to `stream_answer_query` via a request object, either of type
+            #   {::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload stream_answer_query(serving_config: nil, query: nil, session: nil, safety_spec: nil, related_questions_spec: nil, grounding_spec: nil, answer_generation_spec: nil, search_spec: nil, query_understanding_spec: nil, asynchronous_mode: nil, user_pseudo_id: nil, user_labels: nil, end_user_spec: nil)
+            #   Pass arguments to `stream_answer_query` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param serving_config [::String]
+            #     Required. The resource name of the Search serving config, such as
+            #     `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`,
+            #     or
+            #     `projects/*/locations/global/collections/default_collection/dataStores/*/servingConfigs/default_serving_config`.
+            #     This field is used to identify the serving configuration name, set
+            #     of models used to make the search.
+            #   @param query [::Google::Cloud::DiscoveryEngine::V1::Query, ::Hash]
+            #     Required. Current user query.
+            #   @param session [::String]
+            #     The session resource name. Not required.
+            #
+            #     When session field is not set, the API is in sessionless mode.
+            #
+            #     We support auto session mode: users can use the wildcard symbol `-` as
+            #     session ID.  A new ID will be automatically generated and assigned.
+            #   @param safety_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::SafetySpec, ::Hash]
+            #     Model specification.
+            #   @param related_questions_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::RelatedQuestionsSpec, ::Hash]
+            #     Related questions specification.
+            #   @param grounding_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::GroundingSpec, ::Hash]
+            #     Optional. Grounding specification.
+            #   @param answer_generation_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::AnswerGenerationSpec, ::Hash]
+            #     Answer generation specification.
+            #   @param search_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::SearchSpec, ::Hash]
+            #     Search specification.
+            #   @param query_understanding_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::QueryUnderstandingSpec, ::Hash]
+            #     Query understanding specification.
+            #   @param asynchronous_mode [::Boolean]
+            #     Deprecated: This field is deprecated. Streaming Answer API will be
+            #     supported.
+            #
+            #     Asynchronous mode control.
+            #
+            #     If enabled, the response will be returned with answer/session resource
+            #     name without final answer. The API users need to do the polling to get
+            #     the latest status of answer/session by calling
+            #     {::Google::Cloud::DiscoveryEngine::V1::ConversationalSearchService::Client#get_answer ConversationalSearchService.GetAnswer}
+            #     or
+            #     {::Google::Cloud::DiscoveryEngine::V1::ConversationalSearchService::Client#get_session ConversationalSearchService.GetSession}
+            #     method.
+            #   @param user_pseudo_id [::String]
+            #     A unique identifier for tracking visitors. For example, this could be
+            #     implemented with an HTTP cookie, which should be able to uniquely identify
+            #     a visitor on a single device. This unique identifier should not change if
+            #     the visitor logs in or out of the website.
+            #
+            #     This field should NOT have a fixed value such as `unknown_visitor`.
+            #
+            #     The field must be a UTF-8 encoded string with a length limit of 128
+            #     characters. Otherwise, an  `INVALID_ARGUMENT`  error is returned.
+            #   @param user_labels [::Hash{::String => ::String}]
+            #     The user labels applied to a resource must meet the following requirements:
+            #
+            #     * Each resource can have multiple labels, up to a maximum of 64.
+            #     * Each label must be a key-value pair.
+            #     * Keys have a minimum length of 1 character and a maximum length of 63
+            #       characters and cannot be empty. Values can be empty and have a maximum
+            #       length of 63 characters.
+            #     * Keys and values can contain only lowercase letters, numeric characters,
+            #       underscores, and dashes. All characters must use UTF-8 encoding, and
+            #       international characters are allowed.
+            #     * The key portion of a label must be unique. However, you can use the same
+            #       key with multiple resources.
+            #     * Keys must start with a lowercase letter or international character.
+            #
+            #     See [Google Cloud
+            #     Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
+            #     for more details.
+            #   @param end_user_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::EndUserSpec, ::Hash]
+            #     Optional. End user specification.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Enumerable<::Google::Cloud::DiscoveryEngine::V1::AnswerQueryResponse>]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Enumerable<::Google::Cloud::DiscoveryEngine::V1::AnswerQueryResponse>]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/discovery_engine/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::DiscoveryEngine::V1::ConversationalSearchService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest.new
+            #
+            #   # Call the stream_answer_query method to start streaming.
+            #   output = client.stream_answer_query request
+            #
+            #   # The returned object is a streamed enumerable yielding elements of type
+            #   # ::Google::Cloud::DiscoveryEngine::V1::AnswerQueryResponse
+            #   output.each do |current_response|
+            #     p current_response
+            #   end
+            #
+            def stream_answer_query request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.stream_answer_query.metadata.to_h
+
+              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::DiscoveryEngine::V1::VERSION
+              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.serving_config
+                header_params["serving_config"] = request.serving_config
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.stream_answer_query.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.stream_answer_query.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @conversational_search_service_stub.call_rpc :stream_answer_query, request, options: options do |response, operation|
+                yield response, operation if block_given?
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Gets a Answer.
             #
@@ -1353,7 +1520,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload get_session(name: nil)
+            # @overload get_session(name: nil, include_answer_details: nil)
             #   Pass arguments to `get_session` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -1361,6 +1528,9 @@ module Google
             #   @param name [::String]
             #     Required. The resource name of the Session to get. Format:
             #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`
+            #   @param include_answer_details [::Boolean]
+            #     Optional. If set to true, the full session including all answer details
+            #     will be returned.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::DiscoveryEngine::V1::Session]
@@ -1464,13 +1634,18 @@ module Google
             #     A comma-separated list of fields to order by, sorted in ascending order.
             #     Use "desc" after a field name for descending.
             #     Supported fields:
+            #
             #       * `update_time`
             #       * `create_time`
             #       * `session_name`
+            #       * `is_pinned`
             #
             #     Example:
-            #     "update_time desc"
-            #     "create_time"
+            #
+            #     * "update_time desc"
+            #     * "create_time"
+            #     * "is_pinned desc,update_time desc": list sessions by is_pinned first, then
+            #        by update_time.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::DiscoveryEngine::V1::Session>]
@@ -1744,6 +1919,11 @@ module Google
                 #
                 attr_reader :answer_query
                 ##
+                # RPC-specific configuration for `stream_answer_query`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :stream_answer_query
+                ##
                 # RPC-specific configuration for `get_answer`
                 # @return [::Gapic::Config::Method]
                 #
@@ -1790,6 +1970,8 @@ module Google
                   @list_conversations = ::Gapic::Config::Method.new list_conversations_config
                   answer_query_config = parent_rpcs.answer_query if parent_rpcs.respond_to? :answer_query
                   @answer_query = ::Gapic::Config::Method.new answer_query_config
+                  stream_answer_query_config = parent_rpcs.stream_answer_query if parent_rpcs.respond_to? :stream_answer_query
+                  @stream_answer_query = ::Gapic::Config::Method.new stream_answer_query_config
                   get_answer_config = parent_rpcs.get_answer if parent_rpcs.respond_to? :get_answer
                   @get_answer = ::Gapic::Config::Method.new get_answer_config
                   create_session_config = parent_rpcs.create_session if parent_rpcs.respond_to? :create_session

data/lib/google/cloud/discovery_engine/v1/conversational_search_service/rest/client.rb

@@ -791,7 +791,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload answer_query(serving_config: nil, query: nil, session: nil, safety_spec: nil, related_questions_spec: nil, answer_generation_spec: nil, search_spec: nil, query_understanding_spec: nil, asynchronous_mode: nil, user_pseudo_id: nil, user_labels: nil)
+              # @overload answer_query(serving_config: nil, query: nil, session: nil, safety_spec: nil, related_questions_spec: nil, grounding_spec: nil, answer_generation_spec: nil, search_spec: nil, query_understanding_spec: nil, asynchronous_mode: nil, user_pseudo_id: nil, user_labels: nil, end_user_spec: nil)
               #   Pass arguments to `answer_query` via keyword arguments. Note that at
               #   least one keyword argument is required. To specify no parameters, or to keep all
               #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -816,6 +816,8 @@ module Google
               #     Model specification.
               #   @param related_questions_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::RelatedQuestionsSpec, ::Hash]
               #     Related questions specification.
+              #   @param grounding_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::GroundingSpec, ::Hash]
+              #     Optional. Grounding specification.
               #   @param answer_generation_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::AnswerGenerationSpec, ::Hash]
               #     Answer generation specification.
               #   @param search_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::SearchSpec, ::Hash]
@@ -863,6 +865,8 @@ module Google
               #     See [Google Cloud
               #     Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
               #     for more details.
+              #   @param end_user_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::EndUserSpec, ::Hash]
+              #     Optional. End user specification.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryResponse]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -921,6 +925,164 @@ module Google
                 raise ::Google::Cloud::Error.from_error(e)
               end
 
+              ##
+              # Answer query method (streaming).
+              #
+              # It takes one
+              # {::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest AnswerQueryRequest}
+              # and returns multiple
+              # {::Google::Cloud::DiscoveryEngine::V1::AnswerQueryResponse AnswerQueryResponse}
+              # messages in a stream.
+              #
+              # @overload stream_answer_query(request, options = nil)
+              #   Pass arguments to `stream_answer_query` via a request object, either of type
+              #   {::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest, ::Hash]
+              #     A request object representing the call parameters. Required. To specify no
+              #     parameters, or to keep all the default parameter values, pass an empty Hash.
+              #   @param options [::Gapic::CallOptions, ::Hash]
+              #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @overload stream_answer_query(serving_config: nil, query: nil, session: nil, safety_spec: nil, related_questions_spec: nil, grounding_spec: nil, answer_generation_spec: nil, search_spec: nil, query_understanding_spec: nil, asynchronous_mode: nil, user_pseudo_id: nil, user_labels: nil, end_user_spec: nil)
+              #   Pass arguments to `stream_answer_query` via keyword arguments. Note that at
+              #   least one keyword argument is required. To specify no parameters, or to keep all
+              #   the default parameter values, pass an empty Hash as a request object (see above).
+              #
+              #   @param serving_config [::String]
+              #     Required. The resource name of the Search serving config, such as
+              #     `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`,
+              #     or
+              #     `projects/*/locations/global/collections/default_collection/dataStores/*/servingConfigs/default_serving_config`.
+              #     This field is used to identify the serving configuration name, set
+              #     of models used to make the search.
+              #   @param query [::Google::Cloud::DiscoveryEngine::V1::Query, ::Hash]
+              #     Required. Current user query.
+              #   @param session [::String]
+              #     The session resource name. Not required.
+              #
+              #     When session field is not set, the API is in sessionless mode.
+              #
+              #     We support auto session mode: users can use the wildcard symbol `-` as
+              #     session ID.  A new ID will be automatically generated and assigned.
+              #   @param safety_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::SafetySpec, ::Hash]
+              #     Model specification.
+              #   @param related_questions_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::RelatedQuestionsSpec, ::Hash]
+              #     Related questions specification.
+              #   @param grounding_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::GroundingSpec, ::Hash]
+              #     Optional. Grounding specification.
+              #   @param answer_generation_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::AnswerGenerationSpec, ::Hash]
+              #     Answer generation specification.
+              #   @param search_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::SearchSpec, ::Hash]
+              #     Search specification.
+              #   @param query_understanding_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::QueryUnderstandingSpec, ::Hash]
+              #     Query understanding specification.
+              #   @param asynchronous_mode [::Boolean]
+              #     Deprecated: This field is deprecated. Streaming Answer API will be
+              #     supported.
+              #
+              #     Asynchronous mode control.
+              #
+              #     If enabled, the response will be returned with answer/session resource
+              #     name without final answer. The API users need to do the polling to get
+              #     the latest status of answer/session by calling
+              #     {::Google::Cloud::DiscoveryEngine::V1::ConversationalSearchService::Rest::Client#get_answer ConversationalSearchService.GetAnswer}
+              #     or
+              #     {::Google::Cloud::DiscoveryEngine::V1::ConversationalSearchService::Rest::Client#get_session ConversationalSearchService.GetSession}
+              #     method.
+              #   @param user_pseudo_id [::String]
+              #     A unique identifier for tracking visitors. For example, this could be
+              #     implemented with an HTTP cookie, which should be able to uniquely identify
+              #     a visitor on a single device. This unique identifier should not change if
+              #     the visitor logs in or out of the website.
+              #
+              #     This field should NOT have a fixed value such as `unknown_visitor`.
+              #
+              #     The field must be a UTF-8 encoded string with a length limit of 128
+              #     characters. Otherwise, an  `INVALID_ARGUMENT`  error is returned.
+              #   @param user_labels [::Hash{::String => ::String}]
+              #     The user labels applied to a resource must meet the following requirements:
+              #
+              #     * Each resource can have multiple labels, up to a maximum of 64.
+              #     * Each label must be a key-value pair.
+              #     * Keys have a minimum length of 1 character and a maximum length of 63
+              #       characters and cannot be empty. Values can be empty and have a maximum
+              #       length of 63 characters.
+              #     * Keys and values can contain only lowercase letters, numeric characters,
+              #       underscores, and dashes. All characters must use UTF-8 encoding, and
+              #       international characters are allowed.
+              #     * The key portion of a label must be unique. However, you can use the same
+              #       key with multiple resources.
+              #     * Keys must start with a lowercase letter or international character.
+              #
+              #     See [Google Cloud
+              #     Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
+              #     for more details.
+              #   @param end_user_spec [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::EndUserSpec, ::Hash]
+              #     Optional. End user specification.
+              # @return [::Enumerable<::Google::Cloud::DiscoveryEngine::V1::AnswerQueryResponse>]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/discovery_engine/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::DiscoveryEngine::V1::ConversationalSearchService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest.new
+              #
+              #   # Call the stream_answer_query method to start streaming.
+              #   output = client.stream_answer_query request
+              #
+              #   # The returned object is a streamed enumerable yielding elements of type
+              #   # ::Google::Cloud::DiscoveryEngine::V1::AnswerQueryResponse
+              #   output.each do |current_response|
+              #     p current_response
+              #   end
+              #
+              def stream_answer_query request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest
+
+                # Converts hash and nil to an options object
+                options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                # Customize the options with defaults
+                call_metadata = @config.rpcs.stream_answer_query.metadata.to_h
+
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                  lib_name: @config.lib_name, lib_version: @config.lib_version,
+                  gapic_version: ::Google::Cloud::DiscoveryEngine::V1::VERSION,
+                  transports_version_send: [:rest]
+
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                options.apply_defaults timeout:      @config.rpcs.stream_answer_query.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.stream_answer_query.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                ::Gapic::Rest::ServerStream.new(
+                  ::Google::Cloud::DiscoveryEngine::V1::AnswerQueryResponse,
+                  ::Gapic::Rest::ThreadedEnumerator.new do |in_q, out_q|
+                    @conversational_search_service_stub.stream_answer_query request, options do |chunk|
+                      in_q.deq
+                      out_q.enq chunk
+                    end
+                  end
+                )
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
               ##
               # Gets a Answer.
               #
@@ -1269,7 +1431,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload get_session(name: nil)
+              # @overload get_session(name: nil, include_answer_details: nil)
               #   Pass arguments to `get_session` via keyword arguments. Note that at
               #   least one keyword argument is required. To specify no parameters, or to keep all
               #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -1277,6 +1439,9 @@ module Google
               #   @param name [::String]
               #     Required. The resource name of the Session to get. Format:
               #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`
+              #   @param include_answer_details [::Boolean]
+              #     Optional. If set to true, the full session including all answer details
+              #     will be returned.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::DiscoveryEngine::V1::Session]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1373,13 +1538,18 @@ module Google
               #     A comma-separated list of fields to order by, sorted in ascending order.
               #     Use "desc" after a field name for descending.
               #     Supported fields:
+              #
               #       * `update_time`
               #       * `create_time`
               #       * `session_name`
+              #       * `is_pinned`
               #
               #     Example:
-              #     "update_time desc"
-              #     "create_time"
+              #
+              #     * "update_time desc"
+              #     * "create_time"
+              #     * "is_pinned desc,update_time desc": list sessions by is_pinned first, then
+              #        by update_time.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::DiscoveryEngine::V1::Session>]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1626,6 +1796,11 @@ module Google
                   #
                   attr_reader :answer_query
                   ##
+                  # RPC-specific configuration for `stream_answer_query`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :stream_answer_query
+                  ##
                   # RPC-specific configuration for `get_answer`
                   # @return [::Gapic::Config::Method]
                   #
@@ -1672,6 +1847,8 @@ module Google
                     @list_conversations = ::Gapic::Config::Method.new list_conversations_config
                     answer_query_config = parent_rpcs.answer_query if parent_rpcs.respond_to? :answer_query
                     @answer_query = ::Gapic::Config::Method.new answer_query_config
+                    stream_answer_query_config = parent_rpcs.stream_answer_query if parent_rpcs.respond_to? :stream_answer_query
+                    @stream_answer_query = ::Gapic::Config::Method.new stream_answer_query_config
                     get_answer_config = parent_rpcs.get_answer if parent_rpcs.respond_to? :get_answer
                     @get_answer = ::Gapic::Config::Method.new get_answer_config
                     create_session_config = parent_rpcs.create_session if parent_rpcs.respond_to? :create_session

data/lib/google/cloud/discovery_engine/v1/conversational_search_service/rest/service_stub.rb

@@ -353,6 +353,40 @@ module Google
                 end
               end
 
+              ##
+              # Baseline implementation for the stream_answer_query REST call
+              #
+              # @param request_pb [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest]
+              #   A request object representing the call parameters. Required.
+              # @param options [::Gapic::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @yieldparam chunk [::String] The chunk of data received during server streaming.
+              #
+              # @return [::Gapic::Rest::TransportOperation]
+              def stream_answer_query request_pb, options = nil, &block
+                raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                verb, uri, query_string_params, body = ServiceStub.transcode_stream_answer_query_request request_pb
+                query_string_params = if query_string_params.any?
+                                        query_string_params.to_h { |p| p.split "=", 2 }
+                                      else
+                                        {}
+                                      end
+
+                response = @client_stub.make_http_request(
+                  verb,
+                  uri: uri,
+                  body: body || "",
+                  params: query_string_params,
+                  method_name: "stream_answer_query",
+                  options: options,
+                  is_server_streaming: true,
+                  &block
+                )
+                ::Gapic::Rest::TransportOperation.new response
+              end
+
               ##
               # Baseline implementation for the get_answer REST call
               #
@@ -850,6 +884,44 @@ module Google
                 transcoder.transcode request_pb
               end
 
+              ##
+              # @private
+              #
+              # GRPC transcoding helper method for the stream_answer_query REST call
+              #
+              # @param request_pb [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest]
+              #   A request object representing the call parameters. Required.
+              # @return [Array(String, [String, nil], Hash{String => String})]
+              #   Uri, Body, Query string parameters
+              def self.transcode_stream_answer_query_request request_pb
+                transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                        .with_bindings(
+                                                          uri_method: :post,
+                                                          uri_template: "/v1/{serving_config}:streamAnswer",
+                                                          body: "*",
+                                                          matches: [
+                                                            ["serving_config", %r{^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+/?$}, false]
+                                                          ]
+                                                        )
+                                                        .with_bindings(
+                                                          uri_method: :post,
+                                                          uri_template: "/v1/{serving_config}:streamAnswer",
+                                                          body: "*",
+                                                          matches: [
+                                                            ["serving_config", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+/?$}, false]
+                                                          ]
+                                                        )
+                                                        .with_bindings(
+                                                          uri_method: :post,
+                                                          uri_template: "/v1/{serving_config}:streamAnswer",
+                                                          body: "*",
+                                                          matches: [
+                                                            ["serving_config", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+/?$}, false]
+                                                          ]
+                                                        )
+                transcoder.transcode request_pb
+              end
+
               ##
               # @private
               #

data/lib/google/cloud/discovery_engine/v1/document_service/client.rb

@@ -474,7 +474,7 @@ module Google
             #     Otherwise, an `ALREADY_EXISTS` error is returned.
             #
             #     This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034)
-            #     standard with a length limit of 63 characters. Otherwise, an
+            #     standard with a length limit of 128 characters. Otherwise, an
             #     `INVALID_ARGUMENT` error is returned.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -755,7 +755,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload import_documents(inline_source: nil, gcs_source: nil, bigquery_source: nil, fhir_store_source: nil, spanner_source: nil, cloud_sql_source: nil, firestore_source: nil, alloy_db_source: nil, bigtable_source: nil, parent: nil, error_config: nil, reconciliation_mode: nil, update_mask: nil, auto_generate_ids: nil, id_field: nil)
+            # @overload import_documents(inline_source: nil, gcs_source: nil, bigquery_source: nil, fhir_store_source: nil, spanner_source: nil, cloud_sql_source: nil, firestore_source: nil, alloy_db_source: nil, bigtable_source: nil, parent: nil, error_config: nil, reconciliation_mode: nil, update_mask: nil, auto_generate_ids: nil, id_field: nil, force_refresh_content: nil)
             #   Pass arguments to `import_documents` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -870,6 +870,12 @@ module Google
             #     * {::Google::Cloud::DiscoveryEngine::V1::CloudSqlSource CloudSqlSource}.
             #     * {::Google::Cloud::DiscoveryEngine::V1::FirestoreSource FirestoreSource}.
             #     * {::Google::Cloud::DiscoveryEngine::V1::BigtableSource BigtableSource}.
+            #   @param force_refresh_content [::Boolean]
+            #     Optional. Whether to force refresh the unstructured content of the
+            #     documents.
+            #
+            #     If set to `true`, the content part of the documents will be refreshed
+            #     regardless of the update status of the referencing content.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]