google-apis-retail_v2alpha 0.48.0 → 0.51.0

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

@@ -960,6 +960,79 @@ module Google
         end
       end
       
+      # Request for CatalogService.BatchRemoveCatalogAttributes method.
+      class GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The attribute name keys of the CatalogAttributes to delete. A
+        # maximum of 1000 catalog attributes can be deleted in a batch.
+        # Corresponds to the JSON property `attributeKeys`
+        # @return [Array<String>]
+        attr_accessor :attribute_keys
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @attribute_keys = args[:attribute_keys] if args.key?(:attribute_keys)
+        end
+      end
+      
+      # Response of the CatalogService.BatchRemoveCatalogAttributes.
+      class GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse
+        include Google::Apis::Core::Hashable
+      
+        # Catalog attributes that were deleted. Only attributes that are not in use by
+        # products can be deleted.
+        # Corresponds to the JSON property `deletedCatalogAttributes`
+        # @return [Array<String>]
+        attr_accessor :deleted_catalog_attributes
+      
+        # Catalog attributes that were reset. Attributes that are in use by products
+        # cannot be deleted, however their configuration properties will reset to
+        # default values upon removal request.
+        # Corresponds to the JSON property `resetCatalogAttributes`
+        # @return [Array<String>]
+        attr_accessor :reset_catalog_attributes
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @deleted_catalog_attributes = args[:deleted_catalog_attributes] if args.key?(:deleted_catalog_attributes)
+          @reset_catalog_attributes = args[:reset_catalog_attributes] if args.key?(:reset_catalog_attributes)
+        end
+      end
+      
+      # A BigQuery output result.
+      class GoogleCloudRetailV2alphaBigQueryOutputResult
+        include Google::Apis::Core::Hashable
+      
+        # The ID of a BigQuery Dataset.
+        # Corresponds to the JSON property `datasetId`
+        # @return [String]
+        attr_accessor :dataset_id
+      
+        # The ID of a BigQuery Table.
+        # Corresponds to the JSON property `tableId`
+        # @return [String]
+        attr_accessor :table_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @dataset_id = args[:dataset_id] if args.key?(:dataset_id)
+          @table_id = args[:table_id] if args.key?(:table_id)
+        end
+      end
+      
       # BigQuery source import data from.
       class GoogleCloudRetailV2alphaBigQuerySource
         include Google::Apis::Core::Hashable
@@ -971,12 +1044,11 @@ module Google
         # recommendations-ai/docs/upload-catalog#mc). Supported values for user events
         # imports: * `user_event` (default): One JSON UserEvent per line. * `
         # user_event_ga360`: The schema is available here: https://support.google.com/
-        # analytics/answer/3437719. * `user_event_ga4`: This feature is in private
-        # preview. Please contact the support team for importing Google Analytics 4
-        # events. The schema is available here: https://support.google.com/analytics/
-        # answer/7029846. Supported values for auto-completion imports: * `suggestions` (
-        # default): One JSON completion suggestion per line. * `denylist`: One JSON deny
-        # suggestion per line. * `allowlist`: One JSON allow suggestion per line.
+        # analytics/answer/3437719. * `user_event_ga4`: The schema is available here:
+        # https://support.google.com/analytics/answer/7029846. Supported values for auto-
+        # completion imports: * `suggestions` (default): One JSON completion suggestion
+        # per line. * `denylist`: One JSON deny suggestion per line. * `allowlist`: One
+        # JSON allow suggestion per line.
         # Corresponds to the JSON property `dataSchema`
         # @return [String]
         attr_accessor :data_schema
@@ -1087,6 +1159,13 @@ module Google
         # @return [String]
         attr_accessor :dynamic_facetable_option
       
+        # If EXACT_SEARCHABLE_ENABLED, attribute values will be exact searchable. This
+        # property only applies to textual custom attributes and requires indexable set
+        # to enabled to enable exact-searchable.
+        # Corresponds to the JSON property `exactSearchableOption`
+        # @return [String]
+        attr_accessor :exact_searchable_option
+      
         # Output only. Indicates whether this attribute has been used by any products. `
         # True` if at least one Product is using this attribute in Product.attributes.
         # Otherwise, this field is `False`. CatalogAttribute can be pre-loaded by using
@@ -1148,6 +1227,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @dynamic_facetable_option = args[:dynamic_facetable_option] if args.key?(:dynamic_facetable_option)
+          @exact_searchable_option = args[:exact_searchable_option] if args.key?(:exact_searchable_option)
           @in_use = args[:in_use] if args.key?(:in_use)
           @indexable_option = args[:indexable_option] if args.key?(:indexable_option)
           @key = args[:key] if args.key?(:key)
@@ -1245,9 +1325,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::RetailV2alpha::GoogleCloudRetailV2alphaCustomAttribute>]
         attr_accessor :attributes
@@ -1341,16 +1420,16 @@ module Google
         # @return [String]
         attr_accessor :matching_order
       
-        # The maximum number of autocomplete suggestions returned per term. The maximum
-        # allowed max suggestions is 20. Default value is 20. If left unset or set to 0,
-        # then will fallback to default value.
+        # The maximum number of autocomplete suggestions returned per term. Default
+        # value is 20. If left unset or set to 0, then will fallback to default value.
+        # Value range is 1 to 20.
         # Corresponds to the JSON property `maxSuggestions`
         # @return [Fixnum]
         attr_accessor :max_suggestions
       
         # The minimum number of characters needed to be typed in order to get
         # suggestions. Default value is 2. If left unset or set to 0, then will fallback
-        # to default value.
+        # to default value. Value range is 1 to 20.
         # Corresponds to the JSON property `minPrefixLength`
         # @return [Fixnum]
         attr_accessor :min_prefix_length
@@ -1586,6 +1665,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
+      
       # A custom attribute that is not explicitly modeled in Product.
       class GoogleCloudRetailV2alphaCustomAttribute
         include Google::Apis::Core::Hashable
@@ -1707,6 +1806,11 @@ module Google
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaExportErrorsConfig]
         attr_accessor :errors_config
       
+        # Output result.
+        # Corresponds to the JSON property `outputResult`
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaOutputResult]
+        attr_accessor :output_result
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1715,6 +1819,7 @@ module Google
         def update!(**args)
           @error_samples = args[:error_samples] if args.key?(:error_samples)
           @errors_config = args[:errors_config] if args.key?(:errors_config)
+          @output_result = args[:output_result] if args.key?(:output_result)
         end
       end
       
@@ -1734,6 +1839,11 @@ module Google
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaExportErrorsConfig]
         attr_accessor :errors_config
       
+        # Output result.
+        # Corresponds to the JSON property `outputResult`
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaOutputResult]
+        attr_accessor :output_result
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1742,6 +1852,7 @@ module Google
         def update!(**args)
           @error_samples = args[:error_samples] if args.key?(:error_samples)
           @errors_config = args[:errors_config] if args.key?(:errors_config)
+          @output_result = args[:output_result] if args.key?(:output_result)
         end
       end
       
@@ -1996,6 +2107,11 @@ module Google
         # @return [Fixnum]
         attr_accessor :success_count
       
+        # Metadata related to transform user events operation.
+        # Corresponds to the JSON property `transformedUserEventsMetadata`
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaTransformedUserEventsMetadata]
+        attr_accessor :transformed_user_events_metadata
+      
         # Operation last update time. If the operation is done, this is also the finish
         # time.
         # Corresponds to the JSON property `updateTime`
@@ -2013,6 +2129,7 @@ module Google
           @notification_pubsub_topic = args[:notification_pubsub_topic] if args.key?(:notification_pubsub_topic)
           @request_id = args[:request_id] if args.key?(:request_id)
           @success_count = args[:success_count] if args.key?(:success_count)
+          @transformed_user_events_metadata = args[:transformed_user_events_metadata] if args.key?(:transformed_user_events_metadata)
           @update_time = args[:update_time] if args.key?(:update_time)
         end
       end
@@ -2035,11 +2152,9 @@ module Google
         # 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``. 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`.
+        # project as ImportProductsRequest.parent. Make sure that `service-@gcp-sa-
+        # retail.iam.gserviceaccount.com` has the `pubsub.topics.publish` IAM permission
+        # on the topic.
         # Corresponds to the JSON property `notificationPubsubTopic`
         # @return [String]
         attr_accessor :notification_pubsub_topic
@@ -2260,6 +2375,31 @@ module Google
         end
       end
       
+      # Response to a ListModelRequest.
+      class GoogleCloudRetailV2alphaListModelsResponse
+        include Google::Apis::Core::Hashable
+      
+        # List of Models.
+        # Corresponds to the JSON property `models`
+        # @return [Array<Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaModel>]
+        attr_accessor :models
+      
+        # Pagination token, if not returned indicates the last page.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @models = args[:models] if args.key?(:models)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # Response message for ProductService.ListProducts method.
       class GoogleCloudRetailV2alphaListProductsResponse
         include Google::Apis::Core::Hashable
@@ -2455,6 +2595,291 @@ 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 Cloud Cosole 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::RetailV2alpha::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 list of valid serving configs associated with the
+        # PageOptimizationConfig.
+        # Corresponds to the JSON property `servingConfigLists`
+        # @return [Array<Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaModelServingConfigList>]
+        attr_accessor :serving_config_lists
+      
+        # 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_config_lists = args[:serving_config_lists] if args.key?(:serving_config_lists)
+          @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::RetailV2alpha::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::RetailV2alpha::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::RetailV2alpha::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
+      
+      # Represents an ordered combination of valid serving configs, which / may be
+      # used for PAGE_OPTIMIZATION recommendations.
+      class GoogleCloudRetailV2alphaModelServingConfigList
+        include Google::Apis::Core::Hashable
+      
+        # Optional. A set of valid serving configs that may be used for
+        # PAGE_OPTIMIZATION.
+        # Corresponds to the JSON property `servingConfigIds`
+        # @return [Array<String>]
+        attr_accessor :serving_config_ids
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @serving_config_ids = args[:serving_config_ids] if args.key?(:serving_config_ids)
+        end
+      end
+      
+      # Output result.
+      class GoogleCloudRetailV2alphaOutputResult
+        include Google::Apis::Core::Hashable
+      
+        # Export result in BigQuery.
+        # Corresponds to the JSON property `bigqueryResult`
+        # @return [Array<Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaBigQueryOutputResult>]
+        attr_accessor :bigquery_result
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @bigquery_result = args[:bigquery_result] if args.key?(:bigquery_result)
+        end
+      end
+      
+      # Request for pausing training of a model.
+      class GoogleCloudRetailV2alphaPauseModelRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Request message for Predict method.
       class GoogleCloudRetailV2alphaPredictRequest
         include Google::Apis::Core::Hashable
@@ -2476,7 +2901,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"))
@@ -2507,7 +2932,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :page_size
       
-        # This field is not used for now, please leave it unset.
+        # This field is not used for now, leave it unset.
         # Corresponds to the JSON property `pageToken`
         # @return [String]
         attr_accessor :page_token
@@ -2529,8 +2954,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
@@ -2814,7 +3239,7 @@ module Google
       
         # The id of the collection members when type is Type.COLLECTION. Non-existent
         # product ids are allowed. The type of the members must be either Type.PRIMARY
-        # or Type.VARIANT otherwise and INVALID_ARGUMENT error is thrown. Should not set
+        # or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set
         # it for other types. A maximum of 1000 values are allowed. Otherwise, an
         # INVALID_ARGUMENT error is return.
         # Corresponds to the JSON property `collectionMemberIds`
@@ -3794,6 +4219,19 @@ module Google
         end
       end
       
+      # Request for resuming training of a model.
+      class GoogleCloudRetailV2alphaResumeModelRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # A rule is a condition-action pair * A condition defines when a rule is to be
       # triggered. * An action specifies what occurs on that trigger. Currently only
       # boost rules are supported. Currently only supported by the search endpoint.
@@ -3821,13 +4259,13 @@ module Google
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaRuleDoNotAssociateAction]
         attr_accessor :do_not_associate_action
       
-        # * Rule Condition: - No Condition provided is a global match. - 1 or more
-        # Condition provided is combined with OR operator. * Action Input: The request
-        # query and filter that will be applied to the retrieved products, in addition
-        # to any filters already provided with the SearchRequest. The AND operator is
-        # used to combine the query's existing filters with the filter rule(s). NOTE:
-        # May result in 0 results when filters conflict. * Action Result: Filters the
-        # returned objects to be ONLY those that passed the filter.
+        # * Rule Condition: - No Condition.query_terms provided is a global match. - 1
+        # or more Condition.query_terms provided is combined with OR operator. * Action
+        # Input: The request query and filter that are applied to the retrieved products,
+        # in addition to any filters already provided with the SearchRequest. The AND
+        # operator is used to combine the query's existing filters with the filter rule(
+        # s). NOTE: May result in 0 results when filters conflict. * Action Result:
+        # Filters the returned objects to be ONLY those that passed the filter.
         # Corresponds to the JSON property `filterAction`
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaRuleFilterAction]
         attr_accessor :filter_action
@@ -3847,8 +4285,8 @@ module Google
         attr_accessor :oneway_synonyms_action
       
         # Redirects a shopper to a specific page. * Rule Condition: - Must specify
-        # Condition. * Action Input: Request Query * Action Result: Redirects shopper to
-        # provided uri.
+        # Condition.query_terms. * Action Input: Request Query * Action Result:
+        # Redirects shopper to provided uri.
         # Corresponds to the JSON property `redirectAction`
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaRuleRedirectAction]
         attr_accessor :redirect_action
@@ -3958,13 +4396,13 @@ module Google
         end
       end
       
-      # * Rule Condition: - No Condition provided is a global match. - 1 or more
-      # Condition provided is combined with OR operator. * Action Input: The request
-      # query and filter that will be applied to the retrieved products, in addition
-      # to any filters already provided with the SearchRequest. The AND operator is
-      # used to combine the query's existing filters with the filter rule(s). NOTE:
-      # May result in 0 results when filters conflict. * Action Result: Filters the
-      # returned objects to be ONLY those that passed the filter.
+      # * Rule Condition: - No Condition.query_terms provided is a global match. - 1
+      # or more Condition.query_terms provided is combined with OR operator. * Action
+      # Input: The request query and filter that are applied to the retrieved products,
+      # in addition to any filters already provided with the SearchRequest. The AND
+      # operator is used to combine the query's existing filters with the filter rule(
+      # s). NOTE: May result in 0 results when filters conflict. * Action Result:
+      # Filters the returned objects to be ONLY those that passed the filter.
       class GoogleCloudRetailV2alphaRuleFilterAction
         include Google::Apis::Core::Hashable
       
@@ -4045,8 +4483,8 @@ module Google
       end
       
       # Redirects a shopper to a specific page. * Rule Condition: - Must specify
-      # Condition. * Action Input: Request Query * Action Result: Redirects shopper to
-      # provided uri.
+      # Condition.query_terms. * Action Input: Request Query * Action Result:
+      # Redirects shopper to provided uri.
       class GoogleCloudRetailV2alphaRuleRedirectAction
         include Google::Apis::Core::Hashable
       
@@ -4588,6 +5026,13 @@ module Google
         # @return [Array<String>]
         attr_accessor :restricted_values
       
+        # Returns the min and max value for each numerical facet intervals. Ignored for
+        # textual facets.
+        # Corresponds to the JSON property `returnMinMax`
+        # @return [Boolean]
+        attr_accessor :return_min_max
+        alias_method :return_min_max?, :return_min_max
+      
         def initialize(**args)
            update!(**args)
         end
@@ -4602,6 +5047,7 @@ module Google
           @prefixes = args[:prefixes] if args.key?(:prefixes)
           @query = args[:query] if args.key?(:query)
           @restricted_values = args[:restricted_values] if args.key?(:restricted_values)
+          @return_min_max = args[:return_min_max] if args.key?(:return_min_max)
         end
       end
       
@@ -4692,7 +5138,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
@@ -4804,6 +5250,18 @@ module Google
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaInterval]
         attr_accessor :interval
       
+        # The maximum value in the FacetValue.interval. Only supported on numerical
+        # facets and returned if SearchRequest.FacetSpec.FacetKey.return_min_max is true.
+        # Corresponds to the JSON property `maxValue`
+        # @return [Float]
+        attr_accessor :max_value
+      
+        # The minimum value in the FacetValue.interval. Only supported on numerical
+        # facets and returned if SearchRequest.FacetSpec.FacetKey.return_min_max is true.
+        # Corresponds to the JSON property `minValue`
+        # @return [Float]
+        attr_accessor :min_value
+      
         # Text value of a facet, such as "Black" for facet "colorFamilies".
         # Corresponds to the JSON property `value`
         # @return [String]
@@ -4817,6 +5275,8 @@ module Google
         def update!(**args)
           @count = args[:count] if args.key?(:count)
           @interval = args[:interval] if args.key?(:interval)
+          @max_value = args[:max_value] if args.key?(:max_value)
+          @min_value = args[:min_value] if args.key?(:min_value)
           @value = args[:value] if args.key?(:value)
         end
       end
@@ -4872,6 +5332,15 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :matching_variant_fields
       
+        # Specifies previous events related to this product for this user based on
+        # UserEvent with same SearchRequest.visitor_id or UserInfo.user_id. This is set
+        # only when SearchRequest.PersonalizationSpec.mode is SearchRequest.
+        # PersonalizationSpec.Mode.AUTO. Possible values: * `purchased`: Indicates that
+        # this product has been purchased before.
+        # Corresponds to the JSON property `personalLabels`
+        # @return [Array<String>]
+        attr_accessor :personal_labels
+      
         # Product captures all metadata information of items to be recommended or
         # searched.
         # Corresponds to the JSON property `product`
@@ -4904,6 +5373,7 @@ module Google
           @id = args[:id] if args.key?(:id)
           @matching_variant_count = args[:matching_variant_count] if args.key?(:matching_variant_count)
           @matching_variant_fields = args[:matching_variant_fields] if args.key?(:matching_variant_fields)
+          @personal_labels = args[:personal_labels] if args.key?(:personal_labels)
           @product = args[:product] if args.key?(:product)
           @variant_rollup_values = args[:variant_rollup_values] if args.key?(:variant_rollup_values)
         end
@@ -5200,6 +5670,79 @@ module Google
         end
       end
       
+      # Metadata related to transform user events operation.
+      class GoogleCloudRetailV2alphaTransformedUserEventsMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Count of entries in the source user events BigQuery table.
+        # Corresponds to the JSON property `sourceEventsCount`
+        # @return [Fixnum]
+        attr_accessor :source_events_count
+      
+        # Count of entries in the transformed user events BigQuery table, which could be
+        # different from the actually imported number of user events.
+        # Corresponds to the JSON property `transformedEventsCount`
+        # @return [Fixnum]
+        attr_accessor :transformed_events_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @source_events_count = args[:source_events_count] if args.key?(:source_events_count)
+          @transformed_events_count = args[:transformed_events_count] if args.key?(:transformed_events_count)
+        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
+      
+      # Request to manually start a tuning process now (instead of waiting for the
+      # periodically scheduled tuning to happen).
+      class GoogleCloudRetailV2alphaTuneModelRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        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
+      
       # UserEvent captures all metadata information Retail API needs to know about how
       # end users interact with customers' website.
       class GoogleCloudRetailV2alphaUserEvent
@@ -5622,6 +6165,31 @@ module Google
         end
       end
       
+      # A BigQuery output result.
+      class GoogleCloudRetailV2betaBigQueryOutputResult
+        include Google::Apis::Core::Hashable
+      
+        # The ID of a BigQuery Dataset.
+        # Corresponds to the JSON property `datasetId`
+        # @return [String]
+        attr_accessor :dataset_id
+      
+        # The ID of a BigQuery Table.
+        # Corresponds to the JSON property `tableId`
+        # @return [String]
+        attr_accessor :table_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @dataset_id = args[:dataset_id] if args.key?(:dataset_id)
+          @table_id = args[:table_id] if args.key?(:table_id)
+        end
+      end
+      
       # Configuration of destination for Export related errors.
       class GoogleCloudRetailV2betaExportErrorsConfig
         include Google::Apis::Core::Hashable
@@ -5686,6 +6254,11 @@ module Google
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2betaExportErrorsConfig]
         attr_accessor :errors_config
       
+        # Output result.
+        # Corresponds to the JSON property `outputResult`
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2betaOutputResult]
+        attr_accessor :output_result
+      
         def initialize(**args)
            update!(**args)
         end
@@ -5694,6 +6267,7 @@ module Google
         def update!(**args)
           @error_samples = args[:error_samples] if args.key?(:error_samples)
           @errors_config = args[:errors_config] if args.key?(:errors_config)
+          @output_result = args[:output_result] if args.key?(:output_result)
         end
       end
       
@@ -5713,6 +6287,11 @@ module Google
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2betaExportErrorsConfig]
         attr_accessor :errors_config
       
+        # Output result.
+        # Corresponds to the JSON property `outputResult`
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2betaOutputResult]
+        attr_accessor :output_result
+      
         def initialize(**args)
            update!(**args)
         end
@@ -5721,6 +6300,7 @@ module Google
         def update!(**args)
           @error_samples = args[:error_samples] if args.key?(:error_samples)
           @errors_config = args[:errors_config] if args.key?(:errors_config)
+          @output_result = args[:output_result] if args.key?(:output_result)
         end
       end
       
@@ -5881,6 +6461,25 @@ module Google
         end
       end
       
+      # Output result.
+      class GoogleCloudRetailV2betaOutputResult
+        include Google::Apis::Core::Hashable
+      
+        # Export result in BigQuery.
+        # Corresponds to the JSON property `bigqueryResult`
+        # @return [Array<Google::Apis::RetailV2alpha::GoogleCloudRetailV2betaBigQueryOutputResult>]
+        attr_accessor :bigquery_result
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @bigquery_result = args[:bigquery_result] if args.key?(:bigquery_result)
+        end
+      end
+      
       # Metadata related to the progress of the Purge operation. This will be returned
       # by the google.longrunning.Operation.metadata field.
       class GoogleCloudRetailV2betaPurgeMetadata