google-cloud-discovery_engine-v1beta 0.14.2 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3102dfe2a1d8fb79257d9745dbcb166a782487577d90b5d31917410d14ad98ac
-  data.tar.gz: 0c35e7c567ef7c15e4b2ed037d6f39dac323d5217f5254b14cd94fbc0c96628f
+  metadata.gz: 03ccf808ee4fe5e65560966192cbc367522c8aaedfd4a21bfadb17a34afe5395
+  data.tar.gz: c048a44de610ddce2da04abd17d2e97a53b2b303d820cc3cb9a9906eee562d33
 SHA512:
-  metadata.gz: 2c8cd03e176c4b875b5237a81be1d3c4c9614419a9051e1c913d0affd799b75da2f3135ace2e8e3a81a626f7b9be9d65ec9dc25ebfa953a9d67b56d7170468fe
-  data.tar.gz: 9c0497f5480bb9265768a3aac23a1abe065866e6c291a9d435265f494646e854cec50a5dcbe3f4838721904320cd8718bdf5d4361e21ea0a555b953214d0a81e
+  metadata.gz: 5479fd924bf38180abed0eef647521985fcb9bbc9af2c8870d5d5ea131ede9d5c3b7dd326c480ad0a1b491a352ea0d769ea5b46ade241cba7d320252fad341c1
+  data.tar.gz: 6a945dbda3267553c018174928bd1b346474933d8239e064265d07e46061642f376061fd806ac7aef047ca2d5cffe39f27b64dbf25e2125a52ec2fe90263d791

data/lib/google/cloud/discovery_engine/v1beta/completion_service/client.rb

@@ -326,6 +326,154 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Completes the user input with advanced keyword suggestions.
+            #
+            # @overload advanced_complete_query(request, options = nil)
+            #   Pass arguments to `advanced_complete_query` via a request object, either of type
+            #   {::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest, ::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 advanced_complete_query(completion_config: nil, query: nil, query_model: nil, user_pseudo_id: nil, user_info: nil, include_tail_suggestions: nil, boost_spec: nil, suggestion_types: nil)
+            #   Pass arguments to `advanced_complete_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 completion_config [::String]
+            #     Required. The completion_config of the parent dataStore or engine resource
+            #     name for which the completion is performed, such as
+            #     `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig`
+            #     `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.
+            #   @param query [::String]
+            #     Required. The typeahead input used to fetch suggestions. Maximum length is
+            #     128 characters.
+            #
+            #     The query can not be empty for most of the suggestion types. If it is
+            #     empty, an `INVALID_ARGUMENT` error is returned. The exception is when the
+            #     suggestion_types contains only the type `RECENT_SEARCH`, the query can
+            #     be an empty string. The is called "zero prefix" feature, which returns
+            #     user's recently searched queries given the empty query.
+            #   @param query_model [::String]
+            #     Specifies the autocomplete data model. This overrides any model specified
+            #     in the Configuration > Autocomplete section of the Cloud console. Currently
+            #     supported values:
+            #
+            #     * `document` - Using suggestions generated from user-imported documents.
+            #     * `search-history` - Using suggestions generated from the past history of
+            #     {::Google::Cloud::DiscoveryEngine::V1beta::SearchService::Client#search SearchService.Search}
+            #     API calls. Do not use it when there is no traffic for Search API.
+            #     * `user-event` - Using suggestions generated from user-imported search
+            #     events.
+            #     * `document-completable` - Using suggestions taken directly from
+            #     user-imported document fields marked as completable.
+            #
+            #     Default values:
+            #
+            #     * `document` is the default model for regular dataStores.
+            #     * `search-history` is the default model for site search dataStores.
+            #   @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`.
+            #
+            #     This should be the same identifier as
+            #     {::Google::Cloud::DiscoveryEngine::V1beta::UserEvent#user_pseudo_id UserEvent.user_pseudo_id}
+            #     and
+            #     {::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest#user_pseudo_id SearchRequest.user_pseudo_id}.
+            #
+            #     The field must be a UTF-8 encoded string with a length limit of 128
+            #   @param user_info [::Google::Cloud::DiscoveryEngine::V1beta::UserInfo, ::Hash]
+            #     Optional. Information about the end user.
+            #
+            #     This should be the same identifier information as
+            #     {::Google::Cloud::DiscoveryEngine::V1beta::UserEvent#user_info UserEvent.user_info}
+            #     and
+            #     {::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest#user_info SearchRequest.user_info}.
+            #   @param include_tail_suggestions [::Boolean]
+            #     Indicates if tail suggestions should be returned if there are no
+            #     suggestions that match the full query. Even if set to true, if there are
+            #     suggestions that match the full query, those are returned and no
+            #     tail suggestions are returned.
+            #   @param boost_spec [::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest::BoostSpec, ::Hash]
+            #     Optional. Specification to boost suggestions matching the condition.
+            #   @param suggestion_types [::Array<::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest::SuggestionType>]
+            #     Optional. Suggestion types to return. If empty or unspecified, query
+            #     suggestions are returned. Only one suggestion type is supported at the
+            #     moment.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryResponse]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryResponse]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/discovery_engine/v1beta"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::DiscoveryEngine::V1beta::CompletionService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest.new
+            #
+            #   # Call the advanced_complete_query method.
+            #   result = client.advanced_complete_query request
+            #
+            #   # The returned object is of type Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryResponse.
+            #   p result
+            #
+            def advanced_complete_query request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest
+
+              # 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.advanced_complete_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::V1beta::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.completion_config
+                header_params["completion_config"] = request.completion_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.advanced_complete_query.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.advanced_complete_query.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @completion_service_stub.call_rpc :advanced_complete_query, 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
+
             ##
             # Imports all
             # {::Google::Cloud::DiscoveryEngine::V1beta::SuggestionDenyListEntry SuggestionDenyListEntry}
@@ -895,6 +1043,11 @@ module Google
                 #
                 attr_reader :complete_query
                 ##
+                # RPC-specific configuration for `advanced_complete_query`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :advanced_complete_query
+                ##
                 # RPC-specific configuration for `import_suggestion_deny_list_entries`
                 # @return [::Gapic::Config::Method]
                 #
@@ -919,6 +1072,8 @@ module Google
                 def initialize parent_rpcs = nil
                   complete_query_config = parent_rpcs.complete_query if parent_rpcs.respond_to? :complete_query
                   @complete_query = ::Gapic::Config::Method.new complete_query_config
+                  advanced_complete_query_config = parent_rpcs.advanced_complete_query if parent_rpcs.respond_to? :advanced_complete_query
+                  @advanced_complete_query = ::Gapic::Config::Method.new advanced_complete_query_config
                   import_suggestion_deny_list_entries_config = parent_rpcs.import_suggestion_deny_list_entries if parent_rpcs.respond_to? :import_suggestion_deny_list_entries
                   @import_suggestion_deny_list_entries = ::Gapic::Config::Method.new import_suggestion_deny_list_entries_config
                   purge_suggestion_deny_list_entries_config = parent_rpcs.purge_suggestion_deny_list_entries if parent_rpcs.respond_to? :purge_suggestion_deny_list_entries

data/lib/google/cloud/discovery_engine/v1beta/completion_service/paths.rb

@@ -24,6 +24,68 @@ module Google
         module CompletionService
           # Path helper methods for the CompletionService API.
           module Paths
+            ##
+            # Create a fully-qualified CompletionConfig resource string.
+            #
+            # @overload completion_config_path(project:, location:, data_store:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/dataStores/{data_store}/completionConfig`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param data_store [String]
+            #
+            # @overload completion_config_path(project:, location:, collection:, data_store:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/completionConfig`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param collection [String]
+            #   @param data_store [String]
+            #
+            # @overload completion_config_path(project:, location:, collection:, engine:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/completionConfig`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param collection [String]
+            #   @param engine [String]
+            #
+            # @return [::String]
+            def completion_config_path **args
+              resources = {
+                "data_store:location:project" => (proc do |project:, location:, data_store:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/dataStores/#{data_store}/completionConfig"
+                end),
+                "collection:data_store:location:project" => (proc do |project:, location:, collection:, data_store:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "collection cannot contain /" if collection.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/collections/#{collection}/dataStores/#{data_store}/completionConfig"
+                end),
+                "collection:engine:location:project" => (proc do |project:, location:, collection:, engine:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "collection cannot contain /" if collection.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/collections/#{collection}/engines/#{engine}/completionConfig"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
             ##
             # Create a fully-qualified DataStore resource string.
             #

data/lib/google/cloud/discovery_engine/v1beta/completion_service/rest/client.rb

@@ -312,6 +312,147 @@ module Google
                 raise ::Google::Cloud::Error.from_error(e)
               end
 
+              ##
+              # Completes the user input with advanced keyword suggestions.
+              #
+              # @overload advanced_complete_query(request, options = nil)
+              #   Pass arguments to `advanced_complete_query` via a request object, either of type
+              #   {::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest, ::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 advanced_complete_query(completion_config: nil, query: nil, query_model: nil, user_pseudo_id: nil, user_info: nil, include_tail_suggestions: nil, boost_spec: nil, suggestion_types: nil)
+              #   Pass arguments to `advanced_complete_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 completion_config [::String]
+              #     Required. The completion_config of the parent dataStore or engine resource
+              #     name for which the completion is performed, such as
+              #     `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig`
+              #     `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.
+              #   @param query [::String]
+              #     Required. The typeahead input used to fetch suggestions. Maximum length is
+              #     128 characters.
+              #
+              #     The query can not be empty for most of the suggestion types. If it is
+              #     empty, an `INVALID_ARGUMENT` error is returned. The exception is when the
+              #     suggestion_types contains only the type `RECENT_SEARCH`, the query can
+              #     be an empty string. The is called "zero prefix" feature, which returns
+              #     user's recently searched queries given the empty query.
+              #   @param query_model [::String]
+              #     Specifies the autocomplete data model. This overrides any model specified
+              #     in the Configuration > Autocomplete section of the Cloud console. Currently
+              #     supported values:
+              #
+              #     * `document` - Using suggestions generated from user-imported documents.
+              #     * `search-history` - Using suggestions generated from the past history of
+              #     {::Google::Cloud::DiscoveryEngine::V1beta::SearchService::Rest::Client#search SearchService.Search}
+              #     API calls. Do not use it when there is no traffic for Search API.
+              #     * `user-event` - Using suggestions generated from user-imported search
+              #     events.
+              #     * `document-completable` - Using suggestions taken directly from
+              #     user-imported document fields marked as completable.
+              #
+              #     Default values:
+              #
+              #     * `document` is the default model for regular dataStores.
+              #     * `search-history` is the default model for site search dataStores.
+              #   @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`.
+              #
+              #     This should be the same identifier as
+              #     {::Google::Cloud::DiscoveryEngine::V1beta::UserEvent#user_pseudo_id UserEvent.user_pseudo_id}
+              #     and
+              #     {::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest#user_pseudo_id SearchRequest.user_pseudo_id}.
+              #
+              #     The field must be a UTF-8 encoded string with a length limit of 128
+              #   @param user_info [::Google::Cloud::DiscoveryEngine::V1beta::UserInfo, ::Hash]
+              #     Optional. Information about the end user.
+              #
+              #     This should be the same identifier information as
+              #     {::Google::Cloud::DiscoveryEngine::V1beta::UserEvent#user_info UserEvent.user_info}
+              #     and
+              #     {::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest#user_info SearchRequest.user_info}.
+              #   @param include_tail_suggestions [::Boolean]
+              #     Indicates if tail suggestions should be returned if there are no
+              #     suggestions that match the full query. Even if set to true, if there are
+              #     suggestions that match the full query, those are returned and no
+              #     tail suggestions are returned.
+              #   @param boost_spec [::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest::BoostSpec, ::Hash]
+              #     Optional. Specification to boost suggestions matching the condition.
+              #   @param suggestion_types [::Array<::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest::SuggestionType>]
+              #     Optional. Suggestion types to return. If empty or unspecified, query
+              #     suggestions are returned. Only one suggestion type is supported at the
+              #     moment.
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryResponse]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryResponse]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/discovery_engine/v1beta"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::DiscoveryEngine::V1beta::CompletionService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest.new
+              #
+              #   # Call the advanced_complete_query method.
+              #   result = client.advanced_complete_query request
+              #
+              #   # The returned object is of type Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryResponse.
+              #   p result
+              #
+              def advanced_complete_query request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest
+
+                # 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.advanced_complete_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::V1beta::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.advanced_complete_query.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.advanced_complete_query.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @completion_service_stub.advanced_complete_query request, options do |result, operation|
+                  yield result, operation if block_given?
+                  return result
+                end
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
               ##
               # Imports all
               # {::Google::Cloud::DiscoveryEngine::V1beta::SuggestionDenyListEntry SuggestionDenyListEntry}
@@ -833,6 +974,11 @@ module Google
                   #
                   attr_reader :complete_query
                   ##
+                  # RPC-specific configuration for `advanced_complete_query`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :advanced_complete_query
+                  ##
                   # RPC-specific configuration for `import_suggestion_deny_list_entries`
                   # @return [::Gapic::Config::Method]
                   #
@@ -857,6 +1003,8 @@ module Google
                   def initialize parent_rpcs = nil
                     complete_query_config = parent_rpcs.complete_query if parent_rpcs.respond_to? :complete_query
                     @complete_query = ::Gapic::Config::Method.new complete_query_config
+                    advanced_complete_query_config = parent_rpcs.advanced_complete_query if parent_rpcs.respond_to? :advanced_complete_query
+                    @advanced_complete_query = ::Gapic::Config::Method.new advanced_complete_query_config
                     import_suggestion_deny_list_entries_config = parent_rpcs.import_suggestion_deny_list_entries if parent_rpcs.respond_to? :import_suggestion_deny_list_entries
                     @import_suggestion_deny_list_entries = ::Gapic::Config::Method.new import_suggestion_deny_list_entries_config
                     purge_suggestion_deny_list_entries_config = parent_rpcs.purge_suggestion_deny_list_entries if parent_rpcs.respond_to? :purge_suggestion_deny_list_entries

data/lib/google/cloud/discovery_engine/v1beta/completion_service/rest/service_stub.rb

@@ -99,6 +99,44 @@ module Google
                 result
               end
 
+              ##
+              # Baseline implementation for the advanced_complete_query REST call
+              #
+              # @param request_pb [::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest]
+              #   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.
+              #
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryResponse]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryResponse]
+              #   A result object deserialized from the server's reply
+              def advanced_complete_query request_pb, options = nil
+                raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                verb, uri, query_string_params, body = ServiceStub.transcode_advanced_complete_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,
+                  options: options
+                )
+                operation = ::Gapic::Rest::TransportOperation.new response
+                result = ::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryResponse.decode_json response.body, ignore_unknown_fields: true
+
+                yield result, operation if block_given?
+                result
+              end
+
               ##
               # Baseline implementation for the import_suggestion_deny_list_entries REST call
               #
@@ -279,6 +317,44 @@ module Google
                 transcoder.transcode request_pb
               end
 
+              ##
+              # @private
+              #
+              # GRPC transcoding helper method for the advanced_complete_query REST call
+              #
+              # @param request_pb [::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest]
+              #   A request object representing the call parameters. Required.
+              # @return [Array(String, [String, nil], Hash{String => String})]
+              #   Uri, Body, Query string parameters
+              def self.transcode_advanced_complete_query_request request_pb
+                transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                        .with_bindings(
+                                                          uri_method: :post,
+                                                          uri_template: "/v1beta/{completion_config}:completeQuery",
+                                                          body: "*",
+                                                          matches: [
+                                                            ["completion_config", %r{^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/completionConfig/?$}, false]
+                                                          ]
+                                                        )
+                                                        .with_bindings(
+                                                          uri_method: :post,
+                                                          uri_template: "/v1beta/{completion_config}:completeQuery",
+                                                          body: "*",
+                                                          matches: [
+                                                            ["completion_config", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/completionConfig/?$}, false]
+                                                          ]
+                                                        )
+                                                        .with_bindings(
+                                                          uri_method: :post,
+                                                          uri_template: "/v1beta/{completion_config}:completeQuery",
+                                                          body: "*",
+                                                          matches: [
+                                                            ["completion_config", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/completionConfig/?$}, false]
+                                                          ]
+                                                        )
+                transcoder.transcode request_pb
+              end
+
               ##
               # @private
               #

data/lib/google/cloud/discovery_engine/v1beta/control_service/client.rb

@@ -211,9 +211,9 @@ module Google
             #
             #   @param parent [::String]
             #     Required. Full resource name of parent data store. Format:
-            #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}`
+            #     `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`
             #     or
-            #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.
+            #     `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.
             #   @param control [::Google::Cloud::DiscoveryEngine::V1beta::Control, ::Hash]
             #     Required. The Control to create.
             #   @param control_id [::String]
@@ -311,7 +311,7 @@ module Google
             #
             #   @param name [::String]
             #     Required. The resource name of the Control to delete. Format:
-            #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`
+            #     `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -497,7 +497,7 @@ module Google
             #
             #   @param name [::String]
             #     Required. The resource name of the Control to get. Format:
-            #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`
+            #     `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::DiscoveryEngine::V1beta::Control]
@@ -585,9 +585,9 @@ module Google
             #
             #   @param parent [::String]
             #     Required. The data store resource name. Format:
-            #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}`
+            #     `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`
             #     or
-            #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.
+            #     `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.
             #   @param page_size [::Integer]
             #     Optional. Maximum number of results to return. If unspecified, defaults
             #     to 50. Max allowed value is 1000.

data/lib/google/cloud/discovery_engine/v1beta/control_service/rest/client.rb

@@ -204,9 +204,9 @@ module Google
               #
               #   @param parent [::String]
               #     Required. Full resource name of parent data store. Format:
-              #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}`
+              #     `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`
               #     or
-              #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.
+              #     `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.
               #   @param control [::Google::Cloud::DiscoveryEngine::V1beta::Control, ::Hash]
               #     Required. The Control to create.
               #   @param control_id [::String]
@@ -297,7 +297,7 @@ module Google
               #
               #   @param name [::String]
               #     Required. The resource name of the Control to delete. Format:
-              #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`
+              #     `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Protobuf::Empty]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -469,7 +469,7 @@ module Google
               #
               #   @param name [::String]
               #     Required. The resource name of the Control to get. Format:
-              #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`
+              #     `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::DiscoveryEngine::V1beta::Control]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -550,9 +550,9 @@ module Google
               #
               #   @param parent [::String]
               #     Required. The data store resource name. Format:
-              #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}`
+              #     `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`
               #     or
-              #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.
+              #     `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.
               #   @param page_size [::Integer]
               #     Optional. Maximum number of results to return. If unspecified, defaults
               #     to 50. Max allowed value is 1000.