google-apis-retail_v2 0.44.0 → 0.47.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40c595a903184358447bd18333a927509eda97807e8aca38da03dbb199fadf83
-  data.tar.gz: '0079da13b0d5abcb882624214653ad500d6c051bb0c5c3c5b1fc80e17ce38a89'
+  metadata.gz: c09cea59f0e218ebdd11c839834e82295d3a45fd248a8babc8f75714cb705ac4
+  data.tar.gz: a2a2fcaee18b8271e0f47474168a1992cc3056006f93cd7519614c14e23346d1
 SHA512:
-  metadata.gz: d103b204abbeb3fa2c8b83d460640e8eef92c9e58a33e871c0afd2f5d332a6318cc66b71b0b6d6633f7cc9933564a3d9737d7d49798c70b26240497326f36c95
-  data.tar.gz: 20a46356ae6939c333d3d3318dc575c421e77029df6dc04127988eb289fd4d8ea15c3d04134e3d217631f5d8bdadce1b6eadfdca0f72c740fb5f1fe915c2a70c
+  metadata.gz: 7ed356c9d8a968f2c609dd836d0540b2cca6dc1817a0a2394b138cde4ab3edece4b7fce3766fdb228a4e297b8c17143b47cebd73bc45a2b23e264140c928bd1c
+  data.tar.gz: 05412fac6d26e5cff7450480c54d1b99e1e298de1e02f78d43e2cee1854678708746c292d00191a190cb17a93c9981806f8604447a87735a78f0b0416f73e2e9

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Release history for google-apis-retail_v2
 
+### v0.47.0 (2022-07-19)
+
+* Regenerated from discovery document revision 20220716
+
+### v0.46.0 (2022-07-12)
+
+* Regenerated from discovery document revision 20220707
+
+### v0.45.0 (2022-07-08)
+
+* Regenerated from discovery document revision 20220630
+* Regenerated using generator version 0.9.0
+
 ### v0.44.0 (2022-06-30)
 
 * Regenerated using generator version 0.8.0

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

@@ -680,9 +680,8 @@ module Google
       
         # Custom attributes for the suggestion term. * For "user-data", the attributes
         # are additional custom attributes ingested through BigQuery. * For "cloud-
-        # retail", the attributes are product attributes generated by Cloud Retail. This
-        # is an experimental feature. Contact Retail Search support team if you are
-        # interested in enabling it.
+        # retail", the attributes are product attributes generated by Cloud Retail. It
+        # requires UserEvent.product_details is imported properly.
         # Corresponds to the JSON property `attributes`
         # @return [Hash<String,Google::Apis::RetailV2::GoogleCloudRetailV2CustomAttribute>]
         attr_accessor :attributes
@@ -1411,7 +1410,7 @@ module Google
         # in `PredictRequest.params` to receive empty results instead. Note that the API
         # will never return items with storageStatus of "EXPIRED" or "DELETED"
         # regardless of filter choices. If `filterSyntaxV2` is set to true under the `
-        # params` field, then attribute based expressions are expected instead of the
+        # params` field, then attribute-based expressions are expected instead of the
         # above described tag-based syntax. Examples: * (colors: ANY("Red", "Blue")) AND
         # NOT (categories: ANY("Phones")) * (availability: ANY("IN_STOCK")) AND (colors:
         # ANY("Red") OR categories: ANY("Phones"))
@@ -1442,7 +1441,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :page_size
       
-        # The previous PredictResponse.next_page_token.
+        # This field is not used for now, leave it unset.
         # Corresponds to the JSON property `pageToken`
         # @return [String]
         attr_accessor :page_token
@@ -1464,8 +1463,8 @@ module Google
         # it needs to be one of `'no-diversity', 'low-diversity', 'medium-diversity', '
         # high-diversity', 'auto-diversity'`. This gives request-level control and
         # adjusts prediction results based on product category. * `filterSyntaxV2`:
-        # Boolean. False by default. If set to true, the `filter` field will be
-        # interpreteted according to the new, attribute-based syntax.
+        # Boolean. False by default. If set to true, the `filter` field is interpreteted
+        # according to the new, attribute-based syntax.
         # Corresponds to the JSON property `params`
         # @return [Hash<String,Object>]
         attr_accessor :params
@@ -2403,7 +2402,7 @@ module Google
       
       # Metadata related to the progress of the RemoveFulfillmentPlaces operation.
       # Currently empty because there is no meaningful metadata populated from the
-      # RemoveFulfillmentPlaces method.
+      # ProductService.RemoveFulfillmentPlaces method.
       class GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata
         include Google::Apis::Core::Hashable
       
@@ -2416,7 +2415,7 @@ module Google
         end
       end
       
-      # Request message for RemoveFulfillmentPlaces method.
+      # Request message for ProductService.RemoveFulfillmentPlaces method.
       class GoogleCloudRetailV2RemoveFulfillmentPlacesRequest
         include Google::Apis::Core::Hashable
       
@@ -2471,7 +2470,8 @@ module Google
       end
       
       # Response of the RemoveFulfillmentPlacesRequest. Currently empty because there
-      # is no meaningful response populated from the RemoveFulfillmentPlaces method.
+      # is no meaningful response populated from the ProductService.
+      # RemoveFulfillmentPlaces method.
       class GoogleCloudRetailV2RemoveFulfillmentPlacesResponse
         include Google::Apis::Core::Hashable
       
@@ -2486,7 +2486,7 @@ module Google
       
       # Metadata related to the progress of the RemoveLocalInventories operation.
       # Currently empty because there is no meaningful metadata populated from the
-      # RemoveLocalInventories method.
+      # ProductService.RemoveLocalInventories method.
       class GoogleCloudRetailV2RemoveLocalInventoriesMetadata
         include Google::Apis::Core::Hashable
       
@@ -2499,7 +2499,7 @@ module Google
         end
       end
       
-      # Request message for RemoveLocalInventories method.
+      # Request message for ProductService.RemoveLocalInventories method.
       class GoogleCloudRetailV2RemoveLocalInventoriesRequest
         include Google::Apis::Core::Hashable
       
@@ -2537,8 +2537,9 @@ module Google
         end
       end
       
-      # Response of the RemoveLocalInventories API. Currently empty because there is
-      # no meaningful response populated from the RemoveLocalInventories method.
+      # Response of the ProductService.RemoveLocalInventories API. Currently empty
+      # because there is no meaningful response populated from the ProductService.
+      # RemoveLocalInventories method.
       class GoogleCloudRetailV2RemoveLocalInventoriesResponse
         include Google::Apis::Core::Hashable
       
@@ -2961,13 +2962,14 @@ module Google
         # @return [String]
         attr_accessor :key
       
-        # The order in which Facet.values are returned. Allowed values are: * "count
-        # desc", which means order by Facet.FacetValue.count descending. * "value desc",
-        # which means order by Facet.FacetValue.value descending. Only applies to
-        # textual facets. If not set, textual values are sorted in [natural order](https:
-        # //en.wikipedia.org/wiki/Natural_sort_order); numerical intervals are sorted in
-        # the order given by FacetSpec.FacetKey.intervals; FulfillmentInfo.place_ids are
-        # sorted in the order given by FacetSpec.FacetKey.restricted_values.
+        # The order in which SearchResponse.Facet.values are returned. Allowed values
+        # are: * "count desc", which means order by SearchResponse.Facet.values.count
+        # descending. * "value desc", which means order by SearchResponse.Facet.values.
+        # value descending. Only applies to textual facets. If not set, textual values
+        # are sorted in [natural order](https://en.wikipedia.org/wiki/Natural_sort_order)
+        # ; numerical intervals are sorted in the order given by FacetSpec.FacetKey.
+        # intervals; FulfillmentInfo.place_ids are sorted in the order given by
+        # FacetSpec.FacetKey.restricted_values.
         # Corresponds to the JSON property `orderBy`
         # @return [String]
         attr_accessor :order_by
@@ -2985,12 +2987,13 @@ module Google
         # it will override the default behavior of facet computation. The query syntax
         # is the same as a filter expression. See SearchRequest.filter for detail syntax
         # and limitations. Notice that there is no limitation on FacetKey.key when query
-        # is specified. In the response, FacetValue.value will be always "1" and
-        # FacetValue.count will be the number of results that matches the query. For
-        # example, you can set a customized facet for "shipToStore", where FacetKey.key
-        # is "customizedShipToStore", and FacetKey.query is "availability: ANY(\"
-        # IN_STOCK\") AND shipToStore: ANY(\"123\")". Then the facet will count the
-        # products that are both in stock and ship to store "123".
+        # is specified. In the response, SearchResponse.Facet.values.value will be
+        # always "1" and SearchResponse.Facet.values.count will be the number of results
+        # that match the query. For example, you can set a customized facet for "
+        # shipToStore", where FacetKey.key is "customizedShipToStore", and FacetKey.
+        # query is "availability: ANY(\"IN_STOCK\") AND shipToStore: ANY(\"123\")". Then
+        # the facet will count the products that are both in stock and ship to store "
+        # 123".
         # Corresponds to the JSON property `query`
         # @return [String]
         attr_accessor :query
@@ -3111,7 +3114,7 @@ module Google
       
         # Contains the spell corrected query, if found. If the spell correction type is
         # AUTOMATIC, then the search results are based on corrected_query. Otherwise the
-        # original query will be used for search.
+        # original query is used for search.
         # Corresponds to the JSON property `correctedQuery`
         # @return [String]
         attr_accessor :corrected_query
@@ -3368,8 +3371,8 @@ module Google
       end
       
       # Metadata related to the progress of the SetInventory operation. Currently
-      # empty because there is no meaningful metadata populated from the SetInventory
-      # method.
+      # empty because there is no meaningful metadata populated from the
+      # ProductService.SetInventory method.
       class GoogleCloudRetailV2SetInventoryMetadata
         include Google::Apis::Core::Hashable
       
@@ -3382,7 +3385,7 @@ module Google
         end
       end
       
-      # Request message for SetInventory method.
+      # Request message for ProductService.SetInventory method.
       class GoogleCloudRetailV2SetInventoryRequest
         include Google::Apis::Core::Hashable
       
@@ -3429,7 +3432,7 @@ module Google
       end
       
       # Response of the SetInventoryRequest. Currently empty because there is no
-      # meaningful response populated from the SetInventory method.
+      # meaningful response populated from the ProductService.SetInventory method.
       class GoogleCloudRetailV2SetInventoryResponse
         include Google::Apis::Core::Hashable
       
@@ -3864,6 +3867,26 @@ module Google
         end
       end
       
+      # Metadata associated with a create operation.
+      class GoogleCloudRetailV2alphaCreateModelMetadata
+        include Google::Apis::Core::Hashable
+      
+        # The resource name of the model that this create applies to. Format: projects/`
+        # project_number`/locations/`location_id`/catalogs/`catalog_id`/models/`model_id`
+        # Corresponds to the JSON property `model`
+        # @return [String]
+        attr_accessor :model
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @model = args[:model] if args.key?(:model)
+        end
+      end
+      
       # Configuration of destination for Export related errors.
       class GoogleCloudRetailV2alphaExportErrorsConfig
         include Google::Apis::Core::Hashable
@@ -4123,6 +4146,231 @@ module Google
         end
       end
       
+      # Metadata that describes the training and serving parameters of a Model. A
+      # Model can be associated with a ServingConfig and then queried through the
+      # Predict api.
+      class GoogleCloudRetailV2alphaModel
+        include Google::Apis::Core::Hashable
+      
+        # Output only. Timestamp the Recommendation Model was created at.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Output only. The state of data requirements for this model: DATA_OK and
+        # DATA_ERROR. Recommendation model cannot be trained if the data is in
+        # DATA_ERROR state. Recommendation model can have DATA_ERROR state even if
+        # serving state is ACTIVE: models were trained successfully before, but cannot
+        # be refreshed because model no longer has sufficient data for training.
+        # Corresponds to the JSON property `dataState`
+        # @return [String]
+        attr_accessor :data_state
+      
+        # Required. The display name of the model. Should be human readable, used to
+        # display Recommendation Models in the Retail Pantheon Dashboard. UTF-8 encoded
+        # string with limit of 1024 characters.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # Optional. If RECOMMENDATIONS_FILTERING_ENABLED, recommendation filtering by
+        # attributes is enabled for the model.
+        # Corresponds to the JSON property `filteringOption`
+        # @return [String]
+        attr_accessor :filtering_option
+      
+        # Output only. The timestamp when the latest successful tune finished.
+        # Corresponds to the JSON property `lastTuneTime`
+        # @return [String]
+        attr_accessor :last_tune_time
+      
+        # Required. The fully qualified resource name of the model. Format: projects/`
+        # project_number`/locations/`location_id`/catalogs/`catalog_id`/models/`model_id`
+        # catalog_id has char limit of 50. recommendation_model_id has char limit of 40.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Optional. The optimization objective e.g. `cvr`. Currently supported values: `
+        # ctr`, `cvr`, `revenue-per-order`. If not specified, we choose default based on
+        # model type. Default depends on type of recommendation: `recommended-for-you` =>
+        # `ctr` `others-you-may-like` => `ctr` `frequently-bought-together` => `
+        # revenue_per_order`
+        # Corresponds to the JSON property `optimizationObjective`
+        # @return [String]
+        attr_accessor :optimization_objective
+      
+        # The PageOptimizationConfig for model training. This determines how many panels
+        # to optimize for, and which serving configurations to consider for each panel.
+        # The purpose of this model is to optimize which ServingConfig to show on which
+        # panels in way that optimizes the visitors shopping journey.
+        # Corresponds to the JSON property `pageOptimizationConfig`
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2alphaModelPageOptimizationConfig]
+        attr_accessor :page_optimization_config
+      
+        # Optional. The state of periodic tuning. The period we use is 3 months - to do
+        # a one-off tune earlier use the TuneModel method. Default value is
+        # PERIODIC_TUNING_ENABLED.
+        # Corresponds to the JSON property `periodicTuningState`
+        # @return [String]
+        attr_accessor :periodic_tuning_state
+      
+        # Output only. The serving state of the model: ACTIVE, NOT_ACTIVE.
+        # Corresponds to the JSON property `servingState`
+        # @return [String]
+        attr_accessor :serving_state
+      
+        # Optional. The training state that the model is in (e.g. TRAINING or PAUSED).
+        # Since part of the cost of running the service is frequency of training - this
+        # can be used to determine when to train model in order to control cost. If not
+        # specified: the default value for CreateModel method is TRAINING. the default
+        # value for UpdateModel method is to keep the state the same as before.
+        # Corresponds to the JSON property `trainingState`
+        # @return [String]
+        attr_accessor :training_state
+      
+        # Output only. The tune operation associated with the model. Can be used to
+        # determine if there is an ongoing tune for this recommendation. Empty field
+        # implies no tune is goig on.
+        # Corresponds to the JSON property `tuningOperation`
+        # @return [String]
+        attr_accessor :tuning_operation
+      
+        # Required. The type of model e.g. `home-page`. Currently supported values: `
+        # recommended-for-you`, `others-you-may-like`, `frequently-bought-together`, `
+        # page-optimization`, 'similar-items', 'buy-it-again', `recently-viewed`(
+        # readonly value).
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        # Output only. Timestamp the Recommendation Model was last updated. E.g. if a
+        # Recommendation Model was paused - this would be the time the pause was
+        # initiated.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @data_state = args[:data_state] if args.key?(:data_state)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @filtering_option = args[:filtering_option] if args.key?(:filtering_option)
+          @last_tune_time = args[:last_tune_time] if args.key?(:last_tune_time)
+          @name = args[:name] if args.key?(:name)
+          @optimization_objective = args[:optimization_objective] if args.key?(:optimization_objective)
+          @page_optimization_config = args[:page_optimization_config] if args.key?(:page_optimization_config)
+          @periodic_tuning_state = args[:periodic_tuning_state] if args.key?(:periodic_tuning_state)
+          @serving_state = args[:serving_state] if args.key?(:serving_state)
+          @training_state = args[:training_state] if args.key?(:training_state)
+          @tuning_operation = args[:tuning_operation] if args.key?(:tuning_operation)
+          @type = args[:type] if args.key?(:type)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
+      # The PageOptimizationConfig for model training. This determines how many panels
+      # to optimize for, and which serving configurations to consider for each panel.
+      # The purpose of this model is to optimize which ServingConfig to show on which
+      # panels in way that optimizes the visitors shopping journey.
+      class GoogleCloudRetailV2alphaModelPageOptimizationConfig
+        include Google::Apis::Core::Hashable
+      
+        # Required. The type of UserEvent this page optimization is shown for. Each page
+        # has an associated event type - this will be the corresponding event type for
+        # the page that the page optimization model is used on. Supported types: * `add-
+        # to-cart`: Products being added to cart. * `detail-page-view`: Products detail
+        # page viewed. * `home-page-view`: Homepage viewed * `category-page-view`:
+        # Homepage viewed * `shopping-cart-page-view`: User viewing a shopping cart. `
+        # home-page-view` only allows models with type `recommended-for-you`. All other
+        # page_optimization_event_type allow all Model.types.
+        # Corresponds to the JSON property `pageOptimizationEventType`
+        # @return [String]
+        attr_accessor :page_optimization_event_type
+      
+        # Required. A list of panel configurations. Limit = 5.
+        # Corresponds to the JSON property `panels`
+        # @return [Array<Google::Apis::RetailV2::GoogleCloudRetailV2alphaModelPageOptimizationConfigPanel>]
+        attr_accessor :panels
+      
+        # Optional. How to restrict results across panels e.g. can the same
+        # ServingConfig be shown on multiple panels at once. If unspecified, default to `
+        # UNIQUE_MODEL_RESTRICTION`.
+        # Corresponds to the JSON property `restriction`
+        # @return [String]
+        attr_accessor :restriction
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @page_optimization_event_type = args[:page_optimization_event_type] if args.key?(:page_optimization_event_type)
+          @panels = args[:panels] if args.key?(:panels)
+          @restriction = args[:restriction] if args.key?(:restriction)
+        end
+      end
+      
+      # A candidate to consider for a given panel. Currently only ServingConfig are
+      # valid candidates.
+      class GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate
+        include Google::Apis::Core::Hashable
+      
+        # This has to be a valid ServingConfig identifier. e.g. for a ServingConfig with
+        # full name: `projects/*/locations/global/catalogs/default_catalog/
+        # servingConfigs/my_candidate_config` this would be 'my_candidate_config'
+        # Corresponds to the JSON property `servingConfigId`
+        # @return [String]
+        attr_accessor :serving_config_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @serving_config_id = args[:serving_config_id] if args.key?(:serving_config_id)
+        end
+      end
+      
+      # An individual panel with a list of ServingConfigs to consider for it.
+      class GoogleCloudRetailV2alphaModelPageOptimizationConfigPanel
+        include Google::Apis::Core::Hashable
+      
+        # Required. The candidates to consider on the panel. Limit = 10.
+        # Corresponds to the JSON property `candidates`
+        # @return [Array<Google::Apis::RetailV2::GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate>]
+        attr_accessor :candidates
+      
+        # A candidate to consider for a given panel. Currently only ServingConfig are
+        # valid candidates.
+        # Corresponds to the JSON property `defaultCandidate`
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate]
+        attr_accessor :default_candidate
+      
+        # Optional. The name to display for the panel.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @candidates = args[:candidates] if args.key?(:candidates)
+          @default_candidate = args[:default_candidate] if args.key?(:default_candidate)
+          @display_name = args[:display_name] if args.key?(:display_name)
+        end
+      end
+      
       # Metadata related to the progress of the Purge operation. This will be returned
       # by the google.longrunning.Operation.metadata field.
       class GoogleCloudRetailV2alphaPurgeMetadata
@@ -4260,7 +4508,7 @@ module Google
       
       # Metadata related to the progress of the RemoveFulfillmentPlaces operation.
       # Currently empty because there is no meaningful metadata populated from the
-      # RemoveFulfillmentPlaces method.
+      # ProductService.RemoveFulfillmentPlaces method.
       class GoogleCloudRetailV2alphaRemoveFulfillmentPlacesMetadata
         include Google::Apis::Core::Hashable
       
@@ -4274,7 +4522,8 @@ module Google
       end
       
       # Response of the RemoveFulfillmentPlacesRequest. Currently empty because there
-      # is no meaningful response populated from the RemoveFulfillmentPlaces method.
+      # is no meaningful response populated from the ProductService.
+      # RemoveFulfillmentPlaces method.
       class GoogleCloudRetailV2alphaRemoveFulfillmentPlacesResponse
         include Google::Apis::Core::Hashable
       
@@ -4289,7 +4538,7 @@ module Google
       
       # Metadata related to the progress of the RemoveLocalInventories operation.
       # Currently empty because there is no meaningful metadata populated from the
-      # RemoveLocalInventories method.
+      # ProductService.RemoveLocalInventories method.
       class GoogleCloudRetailV2alphaRemoveLocalInventoriesMetadata
         include Google::Apis::Core::Hashable
       
@@ -4302,8 +4551,9 @@ module Google
         end
       end
       
-      # Response of the RemoveLocalInventories API. Currently empty because there is
-      # no meaningful response populated from the RemoveLocalInventories method.
+      # Response of the ProductService.RemoveLocalInventories API. Currently empty
+      # because there is no meaningful response populated from the ProductService.
+      # RemoveLocalInventories method.
       class GoogleCloudRetailV2alphaRemoveLocalInventoriesResponse
         include Google::Apis::Core::Hashable
       
@@ -4317,8 +4567,8 @@ module Google
       end
       
       # Metadata related to the progress of the SetInventory operation. Currently
-      # empty because there is no meaningful metadata populated from the SetInventory
-      # method.
+      # empty because there is no meaningful metadata populated from the
+      # ProductService.SetInventory method.
       class GoogleCloudRetailV2alphaSetInventoryMetadata
         include Google::Apis::Core::Hashable
       
@@ -4332,7 +4582,7 @@ module Google
       end
       
       # Response of the SetInventoryRequest. Currently empty because there is no
-      # meaningful response populated from the SetInventory method.
+      # meaningful response populated from the ProductService.SetInventory method.
       class GoogleCloudRetailV2alphaSetInventoryResponse
         include Google::Apis::Core::Hashable
       
@@ -4345,6 +4595,39 @@ module Google
         end
       end
       
+      # Metadata associated with a tune operation.
+      class GoogleCloudRetailV2alphaTuneModelMetadata
+        include Google::Apis::Core::Hashable
+      
+        # The resource name of the model that this tune applies to. Format: projects/`
+        # project_number`/locations/`location_id`/catalogs/`catalog_id`/models/`model_id`
+        # Corresponds to the JSON property `model`
+        # @return [String]
+        attr_accessor :model
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @model = args[:model] if args.key?(:model)
+        end
+      end
+      
+      # Response associated with a tune operation.
+      class GoogleCloudRetailV2alphaTuneModelResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # A summary of import result. The UserEventImportSummary summarizes the import
       # status for user events.
       class GoogleCloudRetailV2alphaUserEventImportSummary
@@ -4760,7 +5043,7 @@ module Google
       
       # Metadata related to the progress of the RemoveFulfillmentPlaces operation.
       # Currently empty because there is no meaningful metadata populated from the
-      # RemoveFulfillmentPlaces method.
+      # ProductService.RemoveFulfillmentPlaces method.
       class GoogleCloudRetailV2betaRemoveFulfillmentPlacesMetadata
         include Google::Apis::Core::Hashable
       
@@ -4774,7 +5057,8 @@ module Google
       end
       
       # Response of the RemoveFulfillmentPlacesRequest. Currently empty because there
-      # is no meaningful response populated from the RemoveFulfillmentPlaces method.
+      # is no meaningful response populated from the ProductService.
+      # RemoveFulfillmentPlaces method.
       class GoogleCloudRetailV2betaRemoveFulfillmentPlacesResponse
         include Google::Apis::Core::Hashable
       
@@ -4789,7 +5073,7 @@ module Google
       
       # Metadata related to the progress of the RemoveLocalInventories operation.
       # Currently empty because there is no meaningful metadata populated from the
-      # RemoveLocalInventories method.
+      # ProductService.RemoveLocalInventories method.
       class GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata
         include Google::Apis::Core::Hashable
       
@@ -4802,8 +5086,9 @@ module Google
         end
       end
       
-      # Response of the RemoveLocalInventories API. Currently empty because there is
-      # no meaningful response populated from the RemoveLocalInventories method.
+      # Response of the ProductService.RemoveLocalInventories API. Currently empty
+      # because there is no meaningful response populated from the ProductService.
+      # RemoveLocalInventories method.
       class GoogleCloudRetailV2betaRemoveLocalInventoriesResponse
         include Google::Apis::Core::Hashable
       
@@ -4817,8 +5102,8 @@ module Google
       end
       
       # Metadata related to the progress of the SetInventory operation. Currently
-      # empty because there is no meaningful metadata populated from the SetInventory
-      # method.
+      # empty because there is no meaningful metadata populated from the
+      # ProductService.SetInventory method.
       class GoogleCloudRetailV2betaSetInventoryMetadata
         include Google::Apis::Core::Hashable
       
@@ -4832,7 +5117,7 @@ module Google
       end
       
       # Response of the SetInventoryRequest. Currently empty because there is no
-      # meaningful response populated from the SetInventory method.
+      # meaningful response populated from the ProductService.SetInventory method.
       class GoogleCloudRetailV2betaSetInventoryResponse
         include Google::Apis::Core::Hashable
       

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.44.0"
+      GEM_VERSION = "0.47.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.8.0"
+      GENERATOR_VERSION = "0.9.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20220617"
+      REVISION = "20220716"
     end
   end
 end

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

@@ -568,6 +568,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2alphaCreateModelMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2alphaExportErrorsConfig
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -622,6 +628,30 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2alphaModel
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2alphaModelPageOptimizationConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2alphaModelPageOptimizationConfigPanel
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2alphaPurgeMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -694,6 +724,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2alphaTuneModelMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2alphaTuneModelResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2alphaUserEventImportSummary
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1780,6 +1822,13 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2alphaCreateModelMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :model, as: 'model'
+        end
+      end
+      
       class GoogleCloudRetailV2alphaExportErrorsConfig
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1864,6 +1913,55 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2alphaModel
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          property :data_state, as: 'dataState'
+          property :display_name, as: 'displayName'
+          property :filtering_option, as: 'filteringOption'
+          property :last_tune_time, as: 'lastTuneTime'
+          property :name, as: 'name'
+          property :optimization_objective, as: 'optimizationObjective'
+          property :page_optimization_config, as: 'pageOptimizationConfig', class: Google::Apis::RetailV2::GoogleCloudRetailV2alphaModelPageOptimizationConfig, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2alphaModelPageOptimizationConfig::Representation
+      
+          property :periodic_tuning_state, as: 'periodicTuningState'
+          property :serving_state, as: 'servingState'
+          property :training_state, as: 'trainingState'
+          property :tuning_operation, as: 'tuningOperation'
+          property :type, as: 'type'
+          property :update_time, as: 'updateTime'
+        end
+      end
+      
+      class GoogleCloudRetailV2alphaModelPageOptimizationConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :page_optimization_event_type, as: 'pageOptimizationEventType'
+          collection :panels, as: 'panels', class: Google::Apis::RetailV2::GoogleCloudRetailV2alphaModelPageOptimizationConfigPanel, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2alphaModelPageOptimizationConfigPanel::Representation
+      
+          property :restriction, as: 'restriction'
+        end
+      end
+      
+      class GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :serving_config_id, as: 'servingConfigId'
+        end
+      end
+      
+      class GoogleCloudRetailV2alphaModelPageOptimizationConfigPanel
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :candidates, as: 'candidates', class: Google::Apis::RetailV2::GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate::Representation
+      
+          property :default_candidate, as: 'defaultCandidate', class: Google::Apis::RetailV2::GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate::Representation
+      
+          property :display_name, as: 'displayName'
+        end
+      end
+      
       class GoogleCloudRetailV2alphaPurgeMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1944,6 +2042,19 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2alphaTuneModelMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :model, as: 'model'
+        end
+      end
+      
+      class GoogleCloudRetailV2alphaTuneModelResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class GoogleCloudRetailV2alphaUserEventImportSummary
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -72,12 +72,13 @@ module Google
         #   `UNKNOWN_DEVICE_TYPE` * `DESKTOP` * `MOBILE` * A customized string starts with
         #   `OTHER_`, e.g. `OTHER_IPHONE`.
         # @param [Array<String>, String] language_codes
-        #   The language filters applied to the output suggestions. If set, it should
-        #   contain the language of the query. If not set, suggestions are returned
-        #   without considering language restrictions. This is the BCP-47 language code,
-        #   such as "en-US" or "sr-Latn". For more information, see [Tags for Identifying
-        #   Languages](https://tools.ietf.org/html/bcp47). The maximum number of language
-        #   codes is 3.
+        #   Note that this field applies for `user-data` dataset only. For requests with `
+        #   cloud-retail` dataset, setting this field has no effect. The language filters
+        #   applied to the output suggestions. If set, it should contain the language of
+        #   the query. If not set, suggestions are returned without considering language
+        #   restrictions. This is the BCP-47 language code, such as "en-US" or "sr-Latn".
+        #   For more information, see [Tags for Identifying Languages](https://tools.ietf.
+        #   org/html/bcp47). The maximum number of language codes is 3.
         # @param [Fixnum] max_suggestions
         #   Completion max suggestions. If left unset or set to 0, then will fallback to
         #   the configured value CompletionConfig.max_suggestions. The maximum allowed max
@@ -325,9 +326,9 @@ module Google
         # updating fulfillment information. If the request is valid, the update will be
         # enqueued and processed downstream. As a consequence, when a response is
         # returned, the added place IDs are not immediately manifested in the Product
-        # queried by GetProduct or ListProducts. This feature is only available for
-        # users who have Retail Search enabled. Please enable Retail Search on Cloud
-        # Console before using this feature.
+        # queried by ProductService.GetProduct or ProductService.ListProducts. 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] product
         #   Required. Full resource name of Product, such as `projects/*/locations/global/
         #   catalogs/default_catalog/branches/default_branch/products/some_product_id`. If
@@ -368,11 +369,13 @@ module Google
         # asynchronous and does not require the Product to exist before updating
         # inventory information. If the request is valid, the update will be enqueued
         # and processed downstream. As a consequence, when a response is returned,
-        # updates are not immediately manifested in the Product queried by GetProduct or
-        # ListProducts. Local inventory information can only be modified using this
-        # method. CreateProduct and UpdateProduct has no effect on local inventories.
-        # This feature is only available for users who have Retail Search enabled.
-        # Please enable Retail Search on Cloud Console before using this feature.
+        # updates are not immediately manifested in the Product queried by
+        # ProductService.GetProduct or ProductService.ListProducts. Local inventory
+        # information can only be modified using this method. ProductService.
+        # CreateProduct and ProductService.UpdateProduct has no effect on local
+        # inventories. 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] product
         #   Required. Full resource name of Product, such as `projects/*/locations/global/
         #   catalogs/default_catalog/branches/default_branch/products/some_product_id`. If
@@ -678,9 +681,9 @@ module Google
         # updating fulfillment information. If the request is valid, the update will be
         # enqueued and processed downstream. As a consequence, when a response is
         # returned, the removed place IDs are not immediately manifested in the Product
-        # queried by GetProduct or ListProducts. This feature is only available for
-        # users who have Retail Search enabled. Please enable Retail Search on Cloud
-        # Console before using this feature.
+        # queried by ProductService.GetProduct or ProductService.ListProducts. 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] product
         #   Required. Full resource name of Product, such as `projects/*/locations/global/
         #   catalogs/default_catalog/branches/default_branch/products/some_product_id`. If
@@ -720,10 +723,11 @@ module Google
         # removal timestamp. This process is asynchronous. If the request is valid, the
         # removal will be enqueued and processed downstream. As a consequence, when a
         # response is returned, removals are not immediately manifested in the Product
-        # queried by GetProduct or ListProducts. Local inventory information can only be
-        # removed using this method. CreateProduct and UpdateProduct has no effect on
-        # local inventories. This feature is only available for users who have Retail
-        # Search enabled. Please enable Retail Search on Cloud Console before using this
+        # queried by ProductService.GetProduct or ProductService.ListProducts. Local
+        # inventory information can only be removed using this method. ProductService.
+        # CreateProduct and ProductService.UpdateProduct has no effect on local
+        # inventories. 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] product
         #   Required. Full resource name of Product, such as `projects/*/locations/global/
@@ -765,19 +769,21 @@ module Google
         # require the Product to exist before updating fulfillment information. If the
         # request is valid, the update will be enqueued and processed downstream. As a
         # consequence, when a response is returned, updates are not immediately
-        # manifested in the Product queried by GetProduct or ListProducts. When
-        # inventory is updated with CreateProduct and UpdateProduct, the specified
-        # inventory field value(s) will overwrite any existing value(s) while ignoring
-        # the last update time for this field. Furthermore, the last update time for the
-        # specified inventory fields will be overwritten to the time of the
-        # CreateProduct or UpdateProduct request. If no inventory fields are set in
-        # CreateProductRequest.product, then any pre-existing inventory information for
-        # this product will be used. If no inventory fields are set in
+        # manifested in the Product queried by ProductService.GetProduct or
+        # ProductService.ListProducts. When inventory is updated with ProductService.
+        # CreateProduct and ProductService.UpdateProduct, the specified inventory field
+        # value(s) will overwrite any existing value(s) while ignoring the last update
+        # time for this field. Furthermore, the last update time for the specified
+        # inventory fields will be overwritten to the time of the ProductService.
+        # CreateProduct or ProductService.UpdateProduct request. If no inventory fields
+        # are set in CreateProductRequest.product, then any pre-existing inventory
+        # information for this product will be used. If no inventory fields are set in
         # SetInventoryRequest.set_mask, then any existing inventory information will be
         # preserved. Pre-existing inventory information can only be updated with
-        # SetInventory, ProductService.AddFulfillmentPlaces, and RemoveFulfillmentPlaces.
-        # This feature is only available for users who have Retail Search enabled.
-        # Please enable Retail Search on Cloud Console before using this feature.
+        # ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and
+        # ProductService.RemoveFulfillmentPlaces. 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] name
         #   Immutable. Full resource name of the product, such as `projects/*/locations/
         #   global/catalogs/default_catalog/branches/default_branch/products/product_id`.
@@ -929,9 +935,9 @@ module Google
         
         # Makes a recommendation prediction.
         # @param [String] placement
-        #   Required. Full resource name of the format: `placement=projects/*/locations/
-        #   global/catalogs/default_catalog/servingConfigs/*` or `placement=projects/*/
-        #   locations/global/catalogs/default_catalog/placements/*`. We recommend using
+        #   Required. Full resource name of the format: ``placement=projects/*/locations/
+        #   global/catalogs/default_catalog/servingConfigs/*`` or ``placement=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
@@ -1011,9 +1017,9 @@ module Google
         
         # Makes a recommendation prediction.
         # @param [String] placement
-        #   Required. Full resource name of the format: `placement=projects/*/locations/
-        #   global/catalogs/default_catalog/servingConfigs/*` or `placement=projects/*/
-        #   locations/global/catalogs/default_catalog/placements/*`. We recommend using
+        #   Required. Full resource name of the format: ``placement=projects/*/locations/
+        #   global/catalogs/default_catalog/servingConfigs/*`` or ``placement=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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-retail_v2
 version: !ruby/object:Gem::Version
-  version: 0.44.0
+  version: 0.47.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-04 00:00:00.000000000 Z
+date: 2022-07-25 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.44.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2/v0.47.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-retail_v2
 post_install_message: 
 rdoc_options: []