google-apis-discoveryengine_v1beta 0.22.0 → 0.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: be813845d5d32a7e2cbca0854542fdd8174a53579e9de1a79e9f0764874cb6fc
-  data.tar.gz: 71eb1d3ccc7fbdd8510366e50ef2c4a20ddd3769dbb9e903910e139e26ede3c0
+  metadata.gz: fa300730087756ee24597024b7eaa87866ba68312b54ff6b5213f46098a29533
+  data.tar.gz: 6d529abe22a44bdd90328dffd0dc1afc3b0cf5d1566bcbe221efab9a8d451b8f
 SHA512:
-  metadata.gz: cae9a2da17593a613dcd643af4f36be90a40e87a3679bf6c5e2291edc2490f5bf9dde13cef4f20da4eb9ac8350d35e85e0895f47bdcb3ce429a5785114ec4e19
-  data.tar.gz: ecb5df29d11b27f728b6728153db14883846573d36940b03a3e9f291023d082e1e71faf101df829a0e83dc1bc8ea5d1cf74ae4644dd6dc57a455915bf50a954f
+  metadata.gz: eb5a33d11ec9880446de0c7736c2381bd9520597acc7ae46dd166b95c54de698a55ed24e373c8061dcfeb4d561feb8deb05f02b8f17865afc2c10c65ac63dfeb
+  data.tar.gz: 8b4e68cd386f780eca5bbd785e9be3da903f6032b1591f60d442a899dfacbd4ec6d0f9586a59aac1f3a885995a13ea81583d51901a70665c3c137233ea775830

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-discoveryengine_v1beta
 
+### v0.24.0 (2023-10-15)
+
+* Regenerated from discovery document revision 20231003
+
+### v0.23.0 (2023-10-08)
+
+* Regenerated from discovery document revision 20230928
+
 ### v0.22.0 (2023-10-01)
 
 * Regenerated from discovery document revision 20230925

data/lib/google/apis/discoveryengine_v1beta/classes.rb

@@ -3799,6 +3799,11 @@ module Google
         # @return [Array<Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchResponseFacet>]
         attr_accessor :facets
       
+        # 
+        # Corresponds to the JSON property `geoSearchDebugInfo`
+        # @return [Array<Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchResponseGeoSearchDebugInfo>]
+        attr_accessor :geo_search_debug_info
+      
         # Guided search result. The guided search helps user to refine the search
         # results and narrow down to the real needs from a broaded search results.
         # Corresponds to the JSON property `guidedSearchResult`
@@ -3851,6 +3856,7 @@ module Google
           @attribution_token = args[:attribution_token] if args.key?(:attribution_token)
           @corrected_query = args[:corrected_query] if args.key?(:corrected_query)
           @facets = args[:facets] if args.key?(:facets)
+          @geo_search_debug_info = args[:geo_search_debug_info] if args.key?(:geo_search_debug_info)
           @guided_search_result = args[:guided_search_result] if args.key?(:guided_search_result)
           @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
           @query_expansion_info = args[:query_expansion_info] if args.key?(:query_expansion_info)
@@ -3925,6 +3931,32 @@ module Google
         end
       end
       
+      # Debug information specifically related to forward geocoding issues arising
+      # from Geolocation Search.
+      class GoogleCloudDiscoveryengineV1betaSearchResponseGeoSearchDebugInfo
+        include Google::Apis::Core::Hashable
+      
+        # The error produced.
+        # Corresponds to the JSON property `errorMessage`
+        # @return [String]
+        attr_accessor :error_message
+      
+        # The address from which forward geocoding ingestion produced issues.
+        # Corresponds to the JSON property `originalAddressQuery`
+        # @return [String]
+        attr_accessor :original_address_query
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @error_message = args[:error_message] if args.key?(:error_message)
+          @original_address_query = args[:original_address_query] if args.key?(:original_address_query)
+        end
+      end
+      
       # Guided search result. The guided search helps user to refine the search
       # results and narrow down to the real needs from a broaded search results.
       class GoogleCloudDiscoveryengineV1betaSearchResponseGuidedSearchResult

data/lib/google/apis/discoveryengine_v1beta/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DiscoveryengineV1beta
       # Version of the google-apis-discoveryengine_v1beta gem
-      GEM_VERSION = "0.22.0"
+      GEM_VERSION = "0.24.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230925"
+      REVISION = "20231003"
     end
   end
 end

data/lib/google/apis/discoveryengine_v1beta/representations.rb

@@ -628,6 +628,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDiscoveryengineV1betaSearchResponseGeoSearchDebugInfo
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDiscoveryengineV1betaSearchResponseGuidedSearchResult
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1707,6 +1713,8 @@ module Google
           property :corrected_query, as: 'correctedQuery'
           collection :facets, as: 'facets', class: Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchResponseFacet, decorator: Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchResponseFacet::Representation
       
+          collection :geo_search_debug_info, as: 'geoSearchDebugInfo', class: Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchResponseGeoSearchDebugInfo, decorator: Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchResponseGeoSearchDebugInfo::Representation
+      
           property :guided_search_result, as: 'guidedSearchResult', class: Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchResponseGuidedSearchResult, decorator: Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchResponseGuidedSearchResult::Representation
       
           property :next_page_token, as: 'nextPageToken'
@@ -1741,6 +1749,14 @@ module Google
         end
       end
       
+      class GoogleCloudDiscoveryengineV1betaSearchResponseGeoSearchDebugInfo
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :error_message, as: 'errorMessage'
+          property :original_address_query, as: 'originalAddressQuery'
+        end
+      end
+      
       class GoogleCloudDiscoveryengineV1betaSearchResponseGuidedSearchResult
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/discoveryengine_v1beta/service.rb

@@ -1490,6 +1490,78 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Makes a recommendation, which requires a contextual user event.
+        # @param [String] serving_config
+        #   Required. Full resource name of the format: `projects/*/locations/global/
+        #   collections/*/dataStores/*/servingConfigs/*` Before you can request
+        #   recommendations from your model, you must create at least one serving config
+        #   for it.
+        # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaRecommendRequest] google_cloud_discoveryengine_v1beta_recommend_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaRecommendResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaRecommendResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def recommend_project_location_collection_engine_serving_config(serving_config, google_cloud_discoveryengine_v1beta_recommend_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta/{+servingConfig}:recommend', options)
+          command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaRecommendRequest::Representation
+          command.request_object = google_cloud_discoveryengine_v1beta_recommend_request_object
+          command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaRecommendResponse::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaRecommendResponse
+          command.params['servingConfig'] = serving_config unless serving_config.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Performs a search.
+        # @param [String] serving_config
+        #   Required. The resource name of the Search serving config, such as `projects/*/
+        #   locations/global/collections/default_collection/dataStores/default_data_store/
+        #   servingConfigs/default_serving_config`. This field is used to identify the
+        #   serving configuration name, set of models used to make the search.
+        # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchRequest] google_cloud_discoveryengine_v1beta_search_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def search_project_location_collection_engine_serving_configs(serving_config, google_cloud_discoveryengine_v1beta_search_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta/{+servingConfig}:search', options)
+          command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchRequest::Representation
+          command.request_object = google_cloud_discoveryengine_v1beta_search_request_object
+          command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchResponse::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchResponse
+          command.params['servingConfig'] = serving_config unless serving_config.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets the latest state of a long-running operation. Clients can use this method
         # to poll the operation result at intervals as recommended by the API service.
         # @param [String] name

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-discoveryengine_v1beta
 version: !ruby/object:Gem::Version
-  version: 0.22.0
+  version: 0.24.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-01 00:00:00.000000000 Z
+date: 2023-10-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-discoveryengine_v1beta/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-discoveryengine_v1beta/v0.22.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-discoveryengine_v1beta/v0.24.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-discoveryengine_v1beta
 post_install_message: 
 rdoc_options: []