google-cloud-discovery_engine-v1 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 30d78914603c2b13354d1f88c053a95031ee1317c7ce2165b59ced9e9d34716a
-  data.tar.gz: e98e62f6453196d46c513ef889a2db72432f2c02b9ec6792de79c52360d4ed42
+  metadata.gz: 285ec9baea1273b5c54228a27bcec95c488f915fb7b7abc35015a4cca626c07f
+  data.tar.gz: '09e794c4ead146e7cec898d324ee887227d2ec695d339cba6cb8bbb84bab74d6'
 SHA512:
-  metadata.gz: 6985decb9c114639f247d59b47960ae5c0f0064792a7a0f453449a27270dfd853a220cc899aed18dc6cb7795e9c5ced9c7b2da33b930f32e2dc3ee346e79efc9
-  data.tar.gz: 2e73dabcad603716dbf67e98e68eb1f0726ab3eee2addeb96a7fa737a20f5b6e369c60a3a3a34f7f8805a039e49ed23880e4abbae024e607429bdfd2fcc99e8d
+  metadata.gz: d9cbaa5a78b96340f8ee0533df89ded2834b482ec85f094c491acd20b2a92ab5a5314e4a6185ee8038821338f880c065c6bc6ad142f236015931fafcb3c35fab
+  data.tar.gz: 777c9f11f49749c638646ea25a584513aafcbe3350c7be944fbd8389e12b9de223295bf51675cf6c8e700fd5695b73bad07f9eee23bc9e3c2a0f86fedf44f8c2

data/README.md

@@ -40,7 +40,7 @@ response = client.complete_query request
 View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-discovery_engine-v1/latest)
 for class and method documentation.
 
-See also the [Product Documentation](https://cloud.google.com/discovery-engine/media/docs)
+See also the [Product Documentation](https://cloud.google.com/generative-ai-app-builder/docs)
 for general usage information.
 
 ## Enabling Logging

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

@@ -18,6 +18,7 @@
 
 require "google/cloud/errors"
 require "google/cloud/discoveryengine/v1/completion_service_pb"
+require "google/cloud/location"
 
 module Google
   module Cloud
@@ -138,6 +139,12 @@ module Google
               @quota_project_id = @config.quota_project
               @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
 
+              @location_client = Google::Cloud::Location::Locations::Client.new do |config|
+                config.credentials = credentials
+                config.quota_project = @quota_project_id
+                config.endpoint = @config.endpoint
+              end
+
               @completion_service_stub = ::Gapic::ServiceStub.new(
                 ::Google::Cloud::DiscoveryEngine::V1::CompletionService::Stub,
                 credentials:  credentials,
@@ -147,6 +154,13 @@ module Google
               )
             end
 
+            ##
+            # Get the associated client for mix-in of the Locations.
+            #
+            # @return [Google::Cloud::Location::Locations::Client]
+            #
+            attr_reader :location_client
+
             # Service calls
 
             ##
@@ -162,7 +176,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload complete_query(data_store: nil, query: nil, query_model: nil, user_pseudo_id: nil)
+            # @overload complete_query(data_store: nil, query: nil, query_model: nil, user_pseudo_id: nil, include_tail_suggestions: nil)
             #   Pass arguments to `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).
@@ -184,13 +198,14 @@ module Google
             #     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
-            #     [IndustryVertical.SITE_SEARCH][google.cloud.discoveryengine.v1.IndustryVertical.SITE_SEARCH]
-            #     dataStores.
+            #     [IndustryVertical.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
@@ -206,6 +221,11 @@ module Google
             #
             #     The field must be a UTF-8 encoded string with a length limit of 128
             #     characters. Otherwise, an `INVALID_ARGUMENT` error is returned.
+            #   @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.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::DiscoveryEngine::V1::CompleteQueryResponse]

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

@@ -19,6 +19,7 @@
 require "google/cloud/errors"
 require "google/cloud/discoveryengine/v1/completion_service_pb"
 require "google/cloud/discovery_engine/v1/completion_service/rest/service_stub"
+require "google/cloud/location/rest"
 
 module Google
   module Cloud
@@ -135,9 +136,22 @@ module Google
                 @quota_project_id = @config.quota_project
                 @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
 
+                @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
+                  config.credentials = credentials
+                  config.quota_project = @quota_project_id
+                  config.endpoint = @config.endpoint
+                end
+
                 @completion_service_stub = ::Google::Cloud::DiscoveryEngine::V1::CompletionService::Rest::ServiceStub.new endpoint: @config.endpoint, credentials: credentials
               end
 
+              ##
+              # Get the associated client for mix-in of the Locations.
+              #
+              # @return [Google::Cloud::Location::Locations::Rest::Client]
+              #
+              attr_reader :location_client
+
               # Service calls
 
               ##
@@ -153,7 +167,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload complete_query(data_store: nil, query: nil, query_model: nil, user_pseudo_id: nil)
+              # @overload complete_query(data_store: nil, query: nil, query_model: nil, user_pseudo_id: nil, include_tail_suggestions: nil)
               #   Pass arguments to `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).
@@ -175,13 +189,14 @@ module Google
               #     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
-              #     [IndustryVertical.SITE_SEARCH][google.cloud.discoveryengine.v1.IndustryVertical.SITE_SEARCH]
-              #     dataStores.
+              #     [IndustryVertical.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
@@ -197,6 +212,11 @@ module Google
               #
               #     The field must be a UTF-8 encoded string with a length limit of 128
               #     characters. Otherwise, an `INVALID_ARGUMENT` error is returned.
+              #   @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.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::DiscoveryEngine::V1::CompleteQueryResponse]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]