google-apis-retail_v2 0.34.0 → 0.37.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a813962e4570bfe41ed865ea4b7ad39a2947507cee3a4810020185ff1b71ba51
-  data.tar.gz: '078ff530d7ab11b7cd3121ae3a6a880047fb98af9c53ecc8e1641d1214ae4f8b'
+  metadata.gz: dd90dc15eae51189a2fdf09351866ee524f8bd62397647b2353c03ae9ca36bad
+  data.tar.gz: 42363471e109c8942ce12d29f5e0c4b5cac38f46b7e67301e62b71471f31ab0d
 SHA512:
-  metadata.gz: 15cfe72834120580d3152e2d4fa47340b7dbe30b3a41f7c4f179dd1345934e5bf38250600cceaeeb3623d4861c6c6b9ae29b7b11247f2380414b198ee14843df
-  data.tar.gz: 228d224d330e862b8bf89f448a61b7be1cb782bbe683a8e35d95a44c8088cd1daa95a9f6fa4fccc826b421e4f26a782ea33a760d8fc50f08cef098395642bf27
+  metadata.gz: 21ccfd5f4793c22478f7c65f2cc824b8fe80a70aec1170ede60bc7c0fb457627df7c38450b50b7abd388a90c9a9f3788efcad6ca5e43e8a145ff43bb4c592c47
+  data.tar.gz: 5aeaa410de3a3bb4e502047c077c0e20e93cdb0f3420c3ee6abd65cc899bef6907f8ad960d2c70ce4d879d34c76816ab76f013904dea5441d39d5ec2776cf5fe

data/CHANGELOG.md

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

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

@@ -774,12 +774,13 @@ module Google
       class GoogleCloudRetailV2CustomAttribute
         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
@@ -792,11 +793,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
@@ -1109,11 +1112,15 @@ module Google
         # @return [Google::Apis::RetailV2::GoogleCloudRetailV2ProductInputConfig]
         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
@@ -1573,7 +1580,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
@@ -2578,6 +2586,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
@@ -2701,6 +2724,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)
@@ -3030,7 +3054,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
@@ -3491,9 +3517,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_v2/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module RetailV2
       # Version of the google-apis-retail_v2 gem
-      GEM_VERSION = "0.34.0"
+      GEM_VERSION = "0.37.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_v2/representations.rb

@@ -1496,6 +1496,7 @@ module Google
           collection :facet_specs, as: 'facetSpecs', class: Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestFacetSpec, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestFacetSpec::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_v2/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
@@ -929,15 +930,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::RetailV2::GoogleCloudRetailV2PredictRequest] google_cloud_retail_v2_predict_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -972,12 +970,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::RetailV2::GoogleCloudRetailV2SearchRequest] google_cloud_retail_v2_search_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1008,88 +1004,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::RetailV2::GoogleCloudRetailV2PredictRequest] google_cloud_retail_v2_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::RetailV2::GoogleCloudRetailV2PredictResponse] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2PredictResponse]
-        #
-        # @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_v2_predict_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2/{+placement}:predict', options)
-          command.request_representation = Google::Apis::RetailV2::GoogleCloudRetailV2PredictRequest::Representation
-          command.request_object = google_cloud_retail_v2_predict_request_object
-          command.response_representation = Google::Apis::RetailV2::GoogleCloudRetailV2PredictResponse::Representation
-          command.response_class = Google::Apis::RetailV2::GoogleCloudRetailV2PredictResponse
-          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
-        
-        # 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::RetailV2::GoogleCloudRetailV2SearchRequest] google_cloud_retail_v2_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::RetailV2::GoogleCloudRetailV2SearchResponse] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponse]
-        #
-        # @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_v2_search_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2/{+placement}:search', options)
-          command.request_representation = Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequest::Representation
-          command.request_object = google_cloud_retail_v2_search_request_object
-          command.response_representation = Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponse::Representation
-          command.response_class = Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponse
-          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_v2
 version: !ruby/object:Gem::Version
-  version: 0.34.0
+  version: 0.37.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_v2/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2/v0.34.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2/v0.37.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-retail_v2
 post_install_message: 
 rdoc_options: []