google-apis-retail_v2beta 0.35.0 → 0.38.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7d68a682bc17e8633f7d6cb72be1e81bb413c9ae863e159aa07b3a687e52fb3
-  data.tar.gz: 64ab0f83650d4c4f95c25afbb02dfb6f84d03a1997b52ced6d19d7dddb418293
+  metadata.gz: 8f819a6b4602b73b75b02cd74776d7075e3e295e5d8bd54ead39cccc4c1d58f1
+  data.tar.gz: 1fc0f04c70df32f515002005aa98714fd98d2151d6e7092f2a0f4e6c725060ec
 SHA512:
-  metadata.gz: 3286d9e495dd9705f93c810587e2ecc6c441c52ba67ea65104399139dc7e1526eaedfd1ea03ed67a3adf55fc696abc41f62f76a2dd8549f9f18823ac8b0afcd6
-  data.tar.gz: c8f6c508370e56c3d3c2e08a3383021f7e08d0f728e78b6eccd306d58bf29a7f868713d66926617c7d9baebdd9215789ee0340ba1cca8c12dcb26af35c15e814
+  metadata.gz: 3d31f6b11bc6b40f12b872aae9512c486abe2bc84c15bd637afca1b363d0d1b43d864b1f290b34df47976521b8f47ad5be4338a3b4e99ba1d31f347039ba90c2
+  data.tar.gz: 79e9feab52306e7b3fac846dd1d23dd2b8298ac421af2290f0aa36edd3aed571a9106f1e17a8a3ade3b57866d0a45e4407042653d5d09c0e808a6f27a833b3a5

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Release history for google-apis-retail_v2beta
 
+### v0.38.0 (2022-05-05)
+
+* Regenerated from discovery document revision 20220430
+
+### v0.37.0 (2022-04-28)
+
+* Regenerated from discovery document revision 20220421
+
+### v0.36.0 (2022-04-22)
+
+* Regenerated from discovery document revision 20220414
+
 ### v0.35.0 (2022-04-14)
 
 * Regenerated from discovery document revision 20220408

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

@@ -2133,12 +2133,13 @@ module Google
       class GoogleCloudRetailV2betaCustomAttribute
         include Google::Apis::Core::Hashable
       
-        # This field will only be used when AttributesConfig.attribute_config_level of
-        # the Catalog is 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG', if true, custom attribute
-        # values are indexed, so that it can be filtered, faceted or boosted in
-        # SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.
-        # filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more
-        # details.
+        # This field is normally ignored unless AttributesConfig.attribute_config_level
+        # of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode.
+        # You may learn more on [configuration mode] (https://cloud.google.com/retail/
+        # docs/attribute-config#config-modes). if true, custom attribute values are
+        # indexed, so that it can be filtered, faceted or boosted in SearchService.
+        # Search. This field is ignored in a UserEvent. See SearchRequest.filter,
+        # SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
         # Corresponds to the JSON property `indexable`
         # @return [Boolean]
         attr_accessor :indexable
@@ -2151,11 +2152,13 @@ module Google
         # @return [Array<Float>]
         attr_accessor :numbers
       
-        # This field will only be used when AttributesConfig.attribute_config_level of
-        # the Catalog is 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG', if true, custom attribute
-        # values are searchable by text queries in SearchService.Search. This field is
-        # ignored in a UserEvent. Only set if type text is set. Otherwise, a
-        # INVALID_ARGUMENT error is returned.
+        # This field is normally ignored unless AttributesConfig.attribute_config_level
+        # of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode.
+        # You may learn more on [configuration mode] (https://cloud.google.com/retail/
+        # docs/attribute-config#config-modes). If true, custom attribute values are
+        # searchable by text queries in SearchService.Search. This field is ignored in a
+        # UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error
+        # is returned.
         # Corresponds to the JSON property `searchable`
         # @return [Boolean]
         attr_accessor :searchable
@@ -2570,11 +2573,15 @@ module Google
         # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaProductInputConfig]
         attr_accessor :input_config
       
-        # Pub/Sub topic for receiving notification. If this field is set, when the
-        # import is finished, a notification will be sent to specified Pub/Sub topic.
+        # Full Pub/Sub topic name for receiving notification. If this field is set, when
+        # the import is finished, a notification will be sent to specified Pub/Sub topic.
         # The message data will be JSON string of a Operation. Format of the Pub/Sub
-        # topic is `projects/`project`/topics/`topic``. Only supported when
-        # ImportProductsRequest.reconciliation_mode is set to `FULL`.
+        # topic is `projects/`project`/topics/`topic``. It has to be within the same
+        # project as ImportProductsRequest.parent. Make sure that both `cloud-retail-
+        # customer-data-access@system.gserviceaccount.com` and `service-@gcp-sa-retail.
+        # iam.gserviceaccount.com` have the `pubsub.topics.publish` IAM permission on
+        # the topic. Only supported when ImportProductsRequest.reconciliation_mode is
+        # set to `FULL`.
         # Corresponds to the JSON property `notificationPubsubTopic`
         # @return [String]
         attr_accessor :notification_pubsub_topic
@@ -3166,7 +3173,8 @@ module Google
         attr_accessor :currency_code
       
         # Price of the product without any discount. If zero, by default set to be the
-        # price.
+        # price. If set, original_price should be greater than or equal to price,
+        # otherwise an INVALID_ARGUMENT error is thrown.
         # Corresponds to the JSON property `originalPrice`
         # @return [Float]
         attr_accessor :original_price
@@ -4565,6 +4573,21 @@ module Google
         # @return [String]
         attr_accessor :filter
       
+        # The 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.
+        # Corresponds to the JSON property `labels`
+        # @return [Hash<String,String>]
+        attr_accessor :labels
+      
         # A 0-indexed integer that specifies the current offset (that is, starting
         # result location, amongst the Products deemed by the API as relevant) in search
         # results. This field is only considered if page_token is unset. If this field
@@ -4688,6 +4711,7 @@ module Google
           @dynamic_facet_spec = args[:dynamic_facet_spec] if args.key?(:dynamic_facet_spec)
           @facet_specs = args[:facet_specs] if args.key?(:facet_specs)
           @filter = args[:filter] if args.key?(:filter)
+          @labels = args[:labels] if args.key?(:labels)
           @offset = args[:offset] if args.key?(:offset)
           @order_by = args[:order_by] if args.key?(:order_by)
           @page_categories = args[:page_categories] if args.key?(:page_categories)
@@ -5017,7 +5041,9 @@ module Google
         # @return [String]
         attr_accessor :attribution_token
       
-        # If spell correction applies, the corrected query. Otherwise, empty.
+        # Contains the spell corrected query, if found. If the spell correction type is
+        # AUTOMATIC, then the search results will be based on corrected_query, otherwise
+        # the original query will be used for search.
         # Corresponds to the JSON property `correctedQuery`
         # @return [String]
         attr_accessor :corrected_query
@@ -5655,9 +5681,9 @@ module Google
         # @return [String]
         attr_accessor :page_view_id
       
-        # The main product details related to the event. This field is required for the
-        # following event types: * `add-to-cart` * `detail-page-view` * `purchase-
-        # complete` * `search` In a `search` event, this field represents the products
+        # The main product details related to the event. This field is optional except
+        # for the following event types: * `add-to-cart` * `detail-page-view` * `
+        # purchase-complete` In a `search` event, this field represents the products
         # returned to the end user on the current page (the end user may have not
         # finished browsing the whole page yet). When a new page is returned to the end
         # user, after pagination/filtering/ordering even for the same query, a new `

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module RetailV2beta
       # Version of the google-apis-retail_v2beta gem
-      GEM_VERSION = "0.35.0"
+      GEM_VERSION = "0.38.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.4.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20220408"
+      REVISION = "20220430"
     end
   end
 end

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

@@ -2272,6 +2272,7 @@ module Google
           collection :facet_specs, as: 'facetSpecs', class: Google::Apis::RetailV2beta::GoogleCloudRetailV2betaSearchRequestFacetSpec, decorator: Google::Apis::RetailV2beta::GoogleCloudRetailV2betaSearchRequestFacetSpec::Representation
       
           property :filter, as: 'filter'
+          hash :labels, as: 'labels'
           property :offset, as: 'offset'
           property :order_by, as: 'orderBy'
           collection :page_categories, as: 'pageCategories'

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

@@ -62,8 +62,9 @@ module Google
         #   the imported dataset through CompletionService.ImportCompletionData. "cloud-
         #   retail" will use the dataset generated by cloud retail based on user events.
         #   If leave empty, it will use the "user-data". Current supported values: * user-
-        #   data * cloud-retail This option requires additional allowlisting. Before using
-        #   cloud-retail, contact Cloud Retail support team first.
+        #   data * cloud-retail: This option requires enabling auto-learning function
+        #   first. See [guidelines](https://cloud.google.com/retail/docs/completion-
+        #   overview#generated-completion-dataset).
         # @param [String] device_type
         #   The device type context for completion suggestions. It is useful to apply
         #   different suggestions on different device types, e.g. `DESKTOP`, `MOBILE`. If
@@ -1373,15 +1374,12 @@ module Google
         # Makes a recommendation prediction.
         # @param [String] placement
         #   Required. Full resource name of the format: `name=projects/*/locations/global/
-        #   catalogs/default_catalog/servingConfigs/*` or `name=projects/*/locations/
-        #   global/catalogs/default_catalog/placements/*`. We recommend using the `
-        #   servingConfigs` resource. `placements` is a legacy resource. The ID of the
-        #   Recommendations AI serving config or placement. Before you can request
-        #   predictions from your model, you must create at least one serving config or
-        #   placement for it. For more information, see [Managing serving configurations].
-        #   (https://cloud.google.com/retail/docs/manage-configs). The full list of
-        #   available serving configs can be seen at https://console.cloud.google.com/ai/
-        #   retail/catalogs/default_catalog/configs
+        #   catalogs/default_catalog/placements/*` The ID of the Recommendations AI
+        #   placement. Before you can request predictions from your model, you must create
+        #   at least one placement for it. For more information, see [Managing placements](
+        #   https://cloud.google.com/retail/recommendations-ai/docs/manage-placements).
+        #   The full list of available placements can be seen at https://console.cloud.
+        #   google.com/recommendation/catalogs/default_catalog/placements
         # @param [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaPredictRequest] google_cloud_retail_v2beta_predict_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1416,12 +1414,10 @@ module Google
         # Search enabled. Please enable Retail Search on Cloud Console before using this
         # feature.
         # @param [String] placement
-        #   Required. The resource name of the Retail Search serving config, such as `
-        #   projects/*/locations/global/catalogs/default_catalog/servingConfigs/
-        #   default_serving_config` or the name of the legacy placement resource, such as `
-        #   projects/*/locations/global/catalogs/default_catalog/placements/default_search`
-        #   . This field is used to identify the serving configuration name and the set of
-        #   models that will be used to make the search.
+        #   Required. The resource name of the search engine placement, such as `projects/*
+        #   /locations/global/catalogs/default_catalog/placements/default_search`. This
+        #   field is used to identify the serving configuration name and the set of models
+        #   that will be used to make the search.
         # @param [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaSearchRequest] google_cloud_retail_v2beta_search_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1676,48 +1672,6 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Makes a recommendation prediction.
-        # @param [String] placement
-        #   Required. Full resource name of the format: `name=projects/*/locations/global/
-        #   catalogs/default_catalog/servingConfigs/*` or `name=projects/*/locations/
-        #   global/catalogs/default_catalog/placements/*`. We recommend using the `
-        #   servingConfigs` resource. `placements` is a legacy resource. The ID of the
-        #   Recommendations AI serving config or placement. Before you can request
-        #   predictions from your model, you must create at least one serving config or
-        #   placement for it. For more information, see [Managing serving configurations].
-        #   (https://cloud.google.com/retail/docs/manage-configs). The full list of
-        #   available serving configs can be seen at https://console.cloud.google.com/ai/
-        #   retail/catalogs/default_catalog/configs
-        # @param [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaPredictRequest] google_cloud_retail_v2beta_predict_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::RetailV2beta::GoogleCloudRetailV2betaPredictResponse] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaPredictResponse]
-        #
-        # @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 predict_project_location_catalog_serving_config(placement, google_cloud_retail_v2beta_predict_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2beta/{+placement}:predict', options)
-          command.request_representation = Google::Apis::RetailV2beta::GoogleCloudRetailV2betaPredictRequest::Representation
-          command.request_object = google_cloud_retail_v2beta_predict_request_object
-          command.response_representation = Google::Apis::RetailV2beta::GoogleCloudRetailV2betaPredictResponse::Representation
-          command.response_class = Google::Apis::RetailV2beta::GoogleCloudRetailV2betaPredictResponse
-          command.params['placement'] = placement unless placement.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
         # Disables a Control on the specified ServingConfig. The control is removed from
         # the ServingConfig. Returns a NOT_FOUND error if the Control is not enabled for
         # the ServingConfig.
@@ -1755,46 +1709,6 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Performs a search. This feature is only available for users who have Retail
-        # Search enabled. Please enable Retail Search on Cloud Console before using this
-        # feature.
-        # @param [String] placement
-        #   Required. The resource name of the Retail Search serving config, such as `
-        #   projects/*/locations/global/catalogs/default_catalog/servingConfigs/
-        #   default_serving_config` or the name of the legacy placement resource, such as `
-        #   projects/*/locations/global/catalogs/default_catalog/placements/default_search`
-        #   . This field is used to identify the serving configuration name and the set of
-        #   models that will be used to make the search.
-        # @param [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaSearchRequest] google_cloud_retail_v2beta_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::RetailV2beta::GoogleCloudRetailV2betaSearchResponse] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaSearchResponse]
-        #
-        # @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_catalog_serving_configs(placement, google_cloud_retail_v2beta_search_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2beta/{+placement}:search', options)
-          command.request_representation = Google::Apis::RetailV2beta::GoogleCloudRetailV2betaSearchRequest::Representation
-          command.request_object = google_cloud_retail_v2beta_search_request_object
-          command.response_representation = Google::Apis::RetailV2beta::GoogleCloudRetailV2betaSearchResponse::Representation
-          command.response_class = Google::Apis::RetailV2beta::GoogleCloudRetailV2betaSearchResponse
-          command.params['placement'] = placement unless placement.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
         # Writes a single user event from the browser. This uses a GET request to due to
         # browser restriction of POST-ing to a 3rd party domain. This method is used
         # only by the Retail API JavaScript pixel and Google Tag Manager. Users should

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-retail_v2beta
 version: !ruby/object:Gem::Version
-  version: 0.35.0
+  version: 0.38.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-04-18 00:00:00.000000000 Z
+date: 2022-05-09 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-retail_v2beta/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2beta/v0.35.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2beta/v0.38.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-retail_v2beta
 post_install_message: 
 rdoc_options: []