google-apis-retail_v2alpha 0.72.0 → 0.74.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0826c11d9c669ef022a9f609f4721474fc17e61b935b3759a5fe790aaee9cc3b'
-  data.tar.gz: 94aba8656a48ec89ad0fe24e029eb5a99c9f8eadf4adf7c9d8f062c79304a4ec
+  metadata.gz: d8f55eda4658a84aed629800971bc2ef19d3f51131af51965ca65bb3be91c40c
+  data.tar.gz: fde1d2f8328e00e17ceadc6c2242e723db3221cc746e1139c4db8b6ac2991e44
 SHA512:
-  metadata.gz: b7ff53530df13273a950e8b576b0b70aecde4fc0e74c1cd5523773d9753c3063ee29ebfbefcbebd2abaae54474838eab76a97c09e3a9422943d59501486e6732
-  data.tar.gz: 2f9fea79c9a717b8897c0bd5a4b321c5c581ed66c8eeb95ec477925782adef3979cdb31f9be6930479f9c1ae36abb1d650d5c8b07d01a8b9b86c975b15be8e46
+  metadata.gz: f0d427471d03fe866cf1b328f8ca6a39044be82d9e882f804f98c7962757ab581251f6bea6096212b8a1e7a0cfa6f00e596ed364a795414ab5a0791bc7529514
+  data.tar.gz: 9a5b4ee35111122ed10fa43440f9419da911283f651d4a633533becdd9e3fdb15d5647f6be40ad06d7516fcbc01263248239e0a973021599bb38da624e1b7bed

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-retail_v2alpha
 
+### v0.74.0 (2023-04-30)
+
+* Regenerated from discovery document revision 20230420
+
+### v0.73.0 (2023-04-23)
+
+* Regenerated from discovery document revision 20230413
+
 ### v0.72.0 (2023-03-26)
 
 * Regenerated from discovery document revision 20230321

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

@@ -555,6 +555,11 @@ module Google
         # @return [String]
         attr_accessor :last_tune_time
       
+        # Additional model features config.
+        # Corresponds to the JSON property `modelFeaturesConfig`
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2ModelModelFeaturesConfig]
+        attr_accessor :model_features_config
+      
         # 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
@@ -644,6 +649,7 @@ module Google
           @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)
+          @model_features_config = args[:model_features_config] if args.key?(:model_features_config)
           @name = args[:name] if args.key?(:name)
           @optimization_objective = args[:optimization_objective] if args.key?(:optimization_objective)
           @periodic_tuning_state = args[:periodic_tuning_state] if args.key?(:periodic_tuning_state)
@@ -656,6 +662,46 @@ module Google
         end
       end
       
+      # More configs of the frequently-bought-together model type.
+      class GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Specifies the context of the model when used in predict requests.
+        # Only settable for the `frequently-bought-together` type. Will default to
+        # MULTI_CONTEXT if not specified.
+        # Corresponds to the JSON property `contextProductsType`
+        # @return [String]
+        attr_accessor :context_products_type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @context_products_type = args[:context_products_type] if args.key?(:context_products_type)
+        end
+      end
+      
+      # Additional model features config.
+      class GoogleCloudRetailV2ModelModelFeaturesConfig
+        include Google::Apis::Core::Hashable
+      
+        # More configs of the frequently-bought-together model type.
+        # Corresponds to the JSON property `frequentlyBoughtTogetherConfig`
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig]
+        attr_accessor :frequently_bought_together_config
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @frequently_bought_together_config = args[:frequently_bought_together_config] if args.key?(:frequently_bought_together_config)
+        end
+      end
+      
       # Represents an ordered combination of valid serving configs, which can be used
       # for `PAGE_OPTIMIZATION` recommendations.
       class GoogleCloudRetailV2ModelServingConfigList
@@ -1383,6 +1429,25 @@ module Google
         # @return [String]
         attr_accessor :exact_searchable_option
       
+        # Set manually for numerical attributes only. If the facet SearchResponse.
+        # FacetSpec.intervals are not set by the customer for a numerical attribute,
+        # then a weekly pipeline will calculate some intervals using some percentiles on
+        # the distribution of all its product numerical attribute values. The latter
+        # computed intervals might not be ideal for the use case of that attribute. For
+        # this reason, the customer can set them manually. As another option, for any
+        # numerical attribute that is passed as a facet key in the request along with
+        # some given intervals, then these given intervals will be the facet intervals
+        # returned in the response.
+        # Corresponds to the JSON property `facetIntervals`
+        # @return [Array<Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaInterval>]
+        attr_accessor :facet_intervals
+      
+        # Each instance represents a list of attribute values to ignore as facet values
+        # for a specific time range.
+        # Corresponds to the JSON property `ignoredFacetValues`
+        # @return [Array<Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaCatalogAttributeIgnoredFacetValues>]
+        attr_accessor :ignored_facet_values
+      
         # 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
@@ -1456,6 +1521,8 @@ module Google
         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)
+          @facet_intervals = args[:facet_intervals] if args.key?(:facet_intervals)
+          @ignored_facet_values = args[:ignored_facet_values] if args.key?(:ignored_facet_values)
           @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)
@@ -1466,6 +1533,44 @@ module Google
         end
       end
       
+      # Facet values to ignore on facets during the specified time range for the given
+      # SearchResponse.Facet.key attribute.
+      class GoogleCloudRetailV2alphaCatalogAttributeIgnoredFacetValues
+        include Google::Apis::Core::Hashable
+      
+        # If start time is empty and end time is not empty, then ignore these facet
+        # values before end time.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # Time range for the current list of facet values to ignore. If multiple time
+        # ranges are specified for an facet value for the current attribute, consider
+        # all of them. If both are empty, ignore always. If start time and end time are
+        # set, then start time must be before end time. If start time is not empty and
+        # end time is empty, then will ignore these facet values after the start time.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        # List of facet values to ignore for the following time range. The facet values
+        # are the same as the attribute values.
+        # Corresponds to the JSON property `values`
+        # @return [Array<String>]
+        attr_accessor :values
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @start_time = args[:start_time] if args.key?(:start_time)
+          @values = args[:values] if args.key?(:values)
+        end
+      end
+      
       # The color information of a Product.
       class GoogleCloudRetailV2alphaColorInfo
         include Google::Apis::Core::Hashable
@@ -1530,8 +1635,8 @@ module Google
         attr_accessor :completion_results
       
         # Matched recent searches of this user. The maximum number of recent searches is
-        # 10. This field is a restricted feature. Contact Retail Search support team if
-        # you are interested in enabling it. This feature is only available when
+        # 10. This field is a restricted feature. If you want to enable it, contact
+        # Retail Search support. This feature is only available when
         # CompleteQueryRequest.visitor_id field is set and UserEvent is imported. The
         # recent searches satisfy the follow rules: * They are ordered from latest to
         # oldest. * They are matched with CompleteQueryRequest.query case insensitively.
@@ -1586,11 +1691,26 @@ module Google
         # @return [Hash<String,Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaCustomAttribute>]
         attr_accessor :attributes
       
+        # Facet information for the suggestion term. Gives the number of items resulting
+        # from a search with this suggestion term for each facet. This is an
+        # experimental feature for limited customers. If you want to receive this facet
+        # information, reach out to the Retail support team.
+        # Corresponds to the JSON property `facets`
+        # @return [Array<Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchResponseFacet>]
+        attr_accessor :facets
+      
         # The suggestion for the query.
         # Corresponds to the JSON property `suggestion`
         # @return [String]
         attr_accessor :suggestion
       
+        # Total number of products associated with a search with this suggestion. This
+        # is an experimental feature for limited customers. If you want to receive this
+        # product count information, reach out to the Retail support team.
+        # Corresponds to the JSON property `totalProductCount`
+        # @return [Fixnum]
+        attr_accessor :total_product_count
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1598,7 +1718,9 @@ module Google
         # Update properties of this object
         def update!(**args)
           @attributes = args[:attributes] if args.key?(:attributes)
+          @facets = args[:facets] if args.key?(:facets)
           @suggestion = args[:suggestion] if args.key?(:suggestion)
+          @total_product_count = args[:total_product_count] if args.key?(:total_product_count)
         end
       end
       
@@ -1660,8 +1782,8 @@ module Google
         attr_accessor :last_denylist_import_operation
       
         # Output only. Name of the LRO corresponding to the latest suggestion terms list
-        # import. Can use GetOperation API to retrieve the latest state of the Long
-        # Running Operation.
+        # import. Can use GetOperation API method to retrieve the latest state of the
+        # Long Running Operation.
         # Corresponds to the JSON property `lastSuggestionsImportOperation`
         # @return [String]
         attr_accessor :last_suggestions_import_operation
@@ -2033,16 +2155,16 @@ module Google
         end
       end
       
-      # Metadata for active A/B testing Experiments.
+      # Metadata for active A/B testing Experiment.
       class GoogleCloudRetailV2alphaExperimentInfo
         include Google::Apis::Core::Hashable
       
         # The fully qualified resource name of the experiment that provides the serving
         # config under test, should an active experiment exist. For example: `projects/*/
         # locations/global/catalogs/default_catalog/experiments/experiment_id`
-        # Corresponds to the JSON property `experimentName`
+        # Corresponds to the JSON property `experiment`
         # @return [String]
-        attr_accessor :experiment_name
+        attr_accessor :experiment
       
         # Metadata for active serving config A/B tests.
         # Corresponds to the JSON property `servingConfigExperiment`
@@ -2055,7 +2177,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @experiment_name = args[:experiment_name] if args.key?(:experiment_name)
+          @experiment = args[:experiment] if args.key?(:experiment)
           @serving_config_experiment = args[:serving_config_experiment] if args.key?(:serving_config_experiment)
         end
       end
@@ -2520,9 +2642,11 @@ module Google
         # the import is finished, a notification is sent to specified Pub/Sub topic. The
         # message data is 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 `service-@gcp-sa-retail.iam.
-        # gserviceaccount.com` has the `pubsub.topics.publish` IAM permission on the
-        # topic.
+        # ImportProductsRequest.parent. Make sure that both `cloud-retail-customer-data-
+        # access@system.gserviceaccount.com` and `service-@gcp-sa-retail.iam.
+        # gserviceaccount.com` have the `pubsub.topics.publish` IAM permission on the
+        # topic. Only supported when ImportProductsRequest.reconciliation_mode is set to
+        # `FULL`.
         # Corresponds to the JSON property `notificationPubsubTopic`
         # @return [String]
         attr_accessor :notification_pubsub_topic
@@ -2903,7 +3027,7 @@ module Google
       
       # Represents a link between a Merchant Center account and a branch. Once a link
       # is established, products from the linked merchant center account will be
-      # streamed to the linked branch. LINT.IfChange(MerchantCenterAccountLink)
+      # streamed to the linked branch.
       class GoogleCloudRetailV2alphaMerchantCenterAccountLink
         include Google::Apis::Core::Hashable
       
@@ -2961,7 +3085,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Output only. GCP project ID.
+        # Output only. Google Cloud project ID.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
@@ -3169,6 +3293,11 @@ module Google
         # @return [String]
         attr_accessor :last_tune_time
       
+        # Additional model features config.
+        # Corresponds to the JSON property `modelFeaturesConfig`
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaModelModelFeaturesConfig]
+        attr_accessor :model_features_config
+      
         # 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
@@ -3266,6 +3395,7 @@ module Google
           @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)
+          @model_features_config = args[:model_features_config] if args.key?(:model_features_config)
           @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)
@@ -3279,6 +3409,46 @@ module Google
         end
       end
       
+      # More configs of the frequently-bought-together model type.
+      class GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Specifies the context of the model when used in predict requests.
+        # Only settable for the `frequently-bought-together` type. Will default to
+        # MULTI_CONTEXT if not specified.
+        # Corresponds to the JSON property `contextProductsType`
+        # @return [String]
+        attr_accessor :context_products_type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @context_products_type = args[:context_products_type] if args.key?(:context_products_type)
+        end
+      end
+      
+      # Additional model features config.
+      class GoogleCloudRetailV2alphaModelModelFeaturesConfig
+        include Google::Apis::Core::Hashable
+      
+        # More configs of the frequently-bought-together model type.
+        # Corresponds to the JSON property `frequentlyBoughtTogetherConfig`
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig]
+        attr_accessor :frequently_bought_together_config
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @frequently_bought_together_config = args[:frequently_bought_together_config] if args.key?(:frequently_bought_together_config)
+        end
+      end
+      
       # The PageOptimizationConfig for model training. This determines how many panels
       # to optimize for, and which serving configs to consider for each panel. The
       # purpose of this model is to optimize which ServingConfig to show on which
@@ -4982,11 +5152,11 @@ module Google
         include Google::Apis::Core::Hashable
       
         # A filter to apply on the matching condition results. Supported features: *
-        # filter must be set. * Filter syntax is identical to SearchRequest.filter. See
-        # more details at the Retail Search [user guide](/retail/search/docs/filter-and-
-        # order#filter). * To filter products with product ID "product_1" or "product_2",
-        # and color "Red" or "Blue": *(id: ANY("product_1", "product_2")) * *AND * *(
-        # colorFamilies: ANY("Red", "Blue")) *
+        # filter must be set. * Filter syntax is identical to SearchRequest.filter. For
+        # more information, see [Filter](/retail/docs/filter-and-order#filter). * To
+        # filter products with product ID "product_1" or "product_2", and color "Red" or
+        # "Blue": *(id: ANY("product_1", "product_2")) * *AND * *(colorFamilies: ANY("
+        # Red", "Blue")) *
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
@@ -5138,13 +5308,6 @@ module Google
       class GoogleCloudRetailV2alphaSearchRequest
         include Google::Apis::Core::Hashable
       
-        # Represents the banner in request, for projects that combine banners. For
-        # example: a retailer can sell products under different banners like retailer-
-        # main, retailer-baby, retailer-meds, etc. under one project.
-        # Corresponds to the JSON property `banner`
-        # @return [String]
-        attr_accessor :banner
-      
         # Boost specification to boost certain items.
         # Corresponds to the JSON property `boostSpec`
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestBoostSpec]
@@ -5161,9 +5324,9 @@ module Google
         # checking any filters on the search page. The filter applied to every search
         # request when quality improvement such as query expansion is needed. For
         # example, if a query does not have enough results, an expanded query with
-        # SearchRequest.canonical_filter will be returned as a supplement of the
-        # original query. This field is strongly recommended to achieve high search
-        # quality. See SearchRequest.filter for more details about filter syntax.
+        # SearchRequest.canonical_filter is returned as a supplement of the original
+        # query. This field is strongly recommended to achieve high search quality. For
+        # more information about filter syntax, see SearchRequest.filter.
         # Corresponds to the JSON property `canonicalFilter`
         # @return [String]
         attr_accessor :canonical_filter
@@ -5173,8 +5336,16 @@ module Google
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestDynamicFacetSpec]
         attr_accessor :dynamic_facet_spec
       
+        # The entity for customers that may run multiple different entities, domains,
+        # sites or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`
+        # , `youtube.com`, etc. If this is set, it should be exactly matched with
+        # UserEvent.entity to get search results boosted by entity.
+        # Corresponds to the JSON property `entity`
+        # @return [String]
+        attr_accessor :entity
+      
         # Facet specifications for faceted search. If empty, no facets are returned. A
-        # maximum of 100 values are allowed. Otherwise, an INVALID_ARGUMENT error is
+        # maximum of 200 values are allowed. Otherwise, an INVALID_ARGUMENT error is
         # returned.
         # Corresponds to the JSON property `facetSpecs`
         # @return [Array<Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestFacetSpec>]
@@ -5182,8 +5353,8 @@ module Google
       
         # The filter syntax consists of an expression language for constructing a
         # predicate from one or more fields of the products being filtered. Filter
-        # expression is case-sensitive. See more details at this [user guide](https://
-        # cloud.google.com/retail/docs/filter-and-order#filter). If this field is
+        # expression is case-sensitive. For more information, see [Filter](https://cloud.
+        # google.com/retail/docs/filter-and-order#filter). If this field is
         # unrecognizable, an INVALID_ARGUMENT is returned.
         # Corresponds to the JSON property `filter`
         # @return [String]
@@ -5198,8 +5369,9 @@ module Google
         # UTF-8 encoding, and international characters are allowed. * The key portion of
         # a label must be unique. However, you can use the same key with multiple
         # resources. * Keys must start with a lowercase letter or international
-        # character. See [Google Cloud Document](https://cloud.google.com/resource-
-        # manager/docs/creating-managing-labels#requirements) for more details.
+        # character. For more information, see [Requirements for labels](https://cloud.
+        # google.com/resource-manager/docs/creating-managing-labels#requirements) in the
+        # Resource Manager documentation.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
@@ -5214,14 +5386,14 @@ module Google
       
         # The order in which products are returned. Products can be ordered by a field
         # in an Product object. Leave it unset if ordered by relevance. OrderBy
-        # expression is case-sensitive. See more details at this [user guide](https://
-        # cloud.google.com/retail/docs/filter-and-order#order). If this field is
+        # expression is case-sensitive. For more information, see [Order](https://cloud.
+        # google.com/retail/docs/filter-and-order#order). If this field is
         # unrecognizable, an INVALID_ARGUMENT is returned.
         # Corresponds to the JSON property `orderBy`
         # @return [String]
         attr_accessor :order_by
       
-        # The categories associated with a category page. Required for category
+        # The categories associated with a category page. Must be set for category
         # navigation queries to achieve good search quality. The format should be the
         # same as UserEvent.page_categories; To represent full path of category, use '>'
         # sign to separate different hierarchies. If '>' is part of the category name,
@@ -5266,8 +5438,8 @@ module Google
       
         # The relevance threshold of the search results. Defaults to RelevanceThreshold.
         # HIGH, which means only the most relevant results are shown, and the least
-        # number of results are returned. See more details at this [user guide](https://
-        # cloud.google.com/retail/docs/result-size#relevance_thresholding).
+        # number of results are returned. For more information, see [Adjust result size](
+        # https://cloud.google.com/retail/docs/result-size#relevance_thresholding).
         # Corresponds to the JSON property `relevanceThreshold`
         # @return [String]
         attr_accessor :relevance_threshold
@@ -5334,11 +5506,11 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @banner = args[:banner] if args.key?(:banner)
           @boost_spec = args[:boost_spec] if args.key?(:boost_spec)
           @branch = args[:branch] if args.key?(:branch)
           @canonical_filter = args[:canonical_filter] if args.key?(:canonical_filter)
           @dynamic_facet_spec = args[:dynamic_facet_spec] if args.key?(:dynamic_facet_spec)
+          @entity = args[:entity] if args.key?(:entity)
           @facet_specs = args[:facet_specs] if args.key?(:facet_specs)
           @filter = args[:filter] if args.key?(:filter)
           @labels = args[:labels] if args.key?(:labels)
@@ -5453,23 +5625,22 @@ module Google
       
         # Enables dynamic position for this facet. If set to true, the position of this
         # facet among all facets in the response is determined by Google Retail Search.
-        # It will be ordered together with dynamic facets if dynamic facets is enabled.
-        # If set to false, the position of this facet in the response will be the same
-        # as in the request, and it will be ranked before the facets with dynamic
-        # position enable and all dynamic facets. For example, you may always want to
-        # have rating facet returned in the response, but it's not necessarily to always
-        # display the rating facet at the top. In that case, you can set
-        # enable_dynamic_position to true so that the position of rating facet in
-        # response will be determined by Google Retail Search. Another example, assuming
-        # you have the following facets in the request: * "rating",
-        # enable_dynamic_position = true * "price", enable_dynamic_position = false * "
-        # brands", enable_dynamic_position = false And also you have a dynamic facets
-        # enable, which will generate a facet 'gender'. Then the final order of the
-        # facets in the response can be ("price", "brands", "rating", "gender") or ("
-        # price", "brands", "gender", "rating") depends on how Google Retail Search
-        # orders "gender" and "rating" facets. However, notice that "price" and "brands"
-        # will always be ranked at 1st and 2nd position since their
-        # enable_dynamic_position are false.
+        # It is ordered together with dynamic facets if dynamic facets is enabled. If
+        # set to false, the position of this facet in the response is the same as in the
+        # request, and it is ranked before the facets with dynamic position enable and
+        # all dynamic facets. For example, you may always want to have rating facet
+        # returned in the response, but it's not necessarily to always display the
+        # rating facet at the top. In that case, you can set enable_dynamic_position to
+        # true so that the position of rating facet in response is determined by Google
+        # Retail Search. Another example, assuming you have the following facets in the
+        # request: * "rating", enable_dynamic_position = true * "price",
+        # enable_dynamic_position = false * "brands", enable_dynamic_position = false
+        # And also you have a dynamic facets enable, which generates a facet "gender".
+        # Then, the final order of the facets in the response can be ("price", "brands",
+        # "rating", "gender") or ("price", "brands", "gender", "rating") depends on how
+        # Google Retail Search orders "gender" and "rating" facets. However, notice that
+        # "price" and "brands" are always ranked at first and second position because
+        # their enable_dynamic_position values are false.
         # Corresponds to the JSON property `enableDynamicPosition`
         # @return [Boolean]
         attr_accessor :enable_dynamic_position
@@ -5533,19 +5704,21 @@ module Google
       
         # Only get facet values that contains the given strings. For example, suppose "
         # categories" has three values "Women > Shoe", "Women > Dress" and "Men > Shoe".
-        # If set "contains" to "Shoe", the "categories" facet will give only "Women >
-        # Shoe" and "Men > Shoe". Only supported on textual fields. Maximum is 10.
+        # If set "contains" to "Shoe", the "categories" facet gives only "Women > Shoe"
+        # and "Men > Shoe". Only supported on textual fields. Maximum is 10.
         # Corresponds to the JSON property `contains`
         # @return [Array<String>]
         attr_accessor :contains
       
-        # For all numerical facet keys that appear in the list of products from the
-        # catalog, the percentiles 0, 10, 30, 50, 70, 90 and 100 are computed from their
-        # distribution weekly. If the model assigns a high score to a numerical facet
-        # key and its intervals are not specified in the search request, these
-        # percentiles will become the bounds for its intervals and will be returned in
-        # the response. If the facet key intervals are specified in the request, then
-        # the specified intervals will be returned instead.
+        # Set only if values should be bucketized into intervals. Must be set for facets
+        # with numerical values. Must not be set for facet with text values. Maximum
+        # number of intervals is 40. For all numerical facet keys that appear in the
+        # list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and
+        # 100 are computed from their distribution weekly. If the model assigns a high
+        # score to a numerical facet key and its intervals are not specified in the
+        # search request, these percentiles become the bounds for its intervals and are
+        # returned in the response. If the facet key intervals are specified in the
+        # request, then the specified intervals are returned instead.
         # Corresponds to the JSON property `intervals`
         # @return [Array<Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaInterval>]
         attr_accessor :intervals
@@ -5579,7 +5752,7 @@ module Google
       
         # Only get facet values that start with the given string prefix. For example,
         # suppose "categories" has three values "Women > Shoe", "Women > Dress" and "Men
-        # > Shoe". If set "prefixes" to "Women", the "categories" facet will give only "
+        # > Shoe". If set "prefixes" to "Women", the "categories" facet gives only "
         # Women > Shoe" and "Women > Dress". Only supported on textual fields. Maximum
         # is 10.
         # Corresponds to the JSON property `prefixes`
@@ -5587,16 +5760,15 @@ module Google
         attr_accessor :prefixes
       
         # The query that is used to compute facet for the given facet key. When provided,
-        # 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
+        # it overrides 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, 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".
+        # is specified. In the response, SearchResponse.Facet.values.value is always "1"
+        # and SearchResponse.Facet.values.count is 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 counts the
+        # products that are both in stock and ship to store "123".
         # Corresponds to the JSON property `query`
         # @return [String]
         attr_accessor :query
@@ -6388,13 +6560,6 @@ module Google
         # @return [String]
         attr_accessor :attribution_token
       
-        # Represents the banner of the user event, for projects that combine banners.
-        # For example: retailer can have events from multiple banners like retailer-main,
-        # retailer-baby, retailer-meds, etc. under one project.
-        # Corresponds to the JSON property `banner`
-        # @return [String]
-        attr_accessor :banner
-      
         # The ID or name of the associated shopping cart. This ID is used to associate
         # multiple items added or present in the cart before purchase. This can only be
         # set for `add-to-cart`, `purchase-complete`, or `shopping-cart-page-view`
@@ -6409,6 +6574,14 @@ module Google
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaCompletionDetail]
         attr_accessor :completion_detail
       
+        # The entity for customers that may run multiple different entities, domains,
+        # sites or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`
+        # , `youtube.com`, etc. We recommend that you set this field to get better per-
+        # entity search, completion, and prediction results.
+        # Corresponds to the JSON property `entity`
+        # @return [String]
+        attr_accessor :entity
+      
         # Only required for UserEventService.ImportUserEvents method. Timestamp of when
         # the user event happened.
         # Corresponds to the JSON property `eventTime`
@@ -6562,9 +6735,9 @@ module Google
         def update!(**args)
           @attributes = args[:attributes] if args.key?(:attributes)
           @attribution_token = args[:attribution_token] if args.key?(:attribution_token)
-          @banner = args[:banner] if args.key?(:banner)
           @cart_id = args[:cart_id] if args.key?(:cart_id)
           @completion_detail = args[:completion_detail] if args.key?(:completion_detail)
+          @entity = args[:entity] if args.key?(:entity)
           @event_time = args[:event_time] if args.key?(:event_time)
           @event_type = args[:event_type] if args.key?(:event_type)
           @experiment_ids = args[:experiment_ids] if args.key?(:experiment_ids)
@@ -7145,7 +7318,7 @@ module Google
       
       # Represents a link between a Merchant Center account and a branch. Once a link
       # is established, products from the linked merchant center account will be
-      # streamed to the linked branch. LINT.IfChange(MerchantCenterAccountLink)
+      # streamed to the linked branch.
       class GoogleCloudRetailV2betaMerchantCenterAccountLink
         include Google::Apis::Core::Hashable
       
@@ -7203,7 +7376,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Output only. GCP project ID.
+        # Output only. Google Cloud project ID.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
@@ -7295,6 +7468,11 @@ module Google
         # @return [String]
         attr_accessor :last_tune_time
       
+        # Additional model features config.
+        # Corresponds to the JSON property `modelFeaturesConfig`
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2betaModelModelFeaturesConfig]
+        attr_accessor :model_features_config
+      
         # 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
@@ -7384,6 +7562,7 @@ module Google
           @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)
+          @model_features_config = args[:model_features_config] if args.key?(:model_features_config)
           @name = args[:name] if args.key?(:name)
           @optimization_objective = args[:optimization_objective] if args.key?(:optimization_objective)
           @periodic_tuning_state = args[:periodic_tuning_state] if args.key?(:periodic_tuning_state)
@@ -7396,6 +7575,46 @@ module Google
         end
       end
       
+      # More configs of the frequently-bought-together model type.
+      class GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Specifies the context of the model when used in predict requests.
+        # Only settable for the `frequently-bought-together` type. Will default to
+        # MULTI_CONTEXT if not specified.
+        # Corresponds to the JSON property `contextProductsType`
+        # @return [String]
+        attr_accessor :context_products_type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @context_products_type = args[:context_products_type] if args.key?(:context_products_type)
+        end
+      end
+      
+      # Additional model features config.
+      class GoogleCloudRetailV2betaModelModelFeaturesConfig
+        include Google::Apis::Core::Hashable
+      
+        # More configs of the frequently-bought-together model type.
+        # Corresponds to the JSON property `frequentlyBoughtTogetherConfig`
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig]
+        attr_accessor :frequently_bought_together_config
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @frequently_bought_together_config = args[:frequently_bought_together_config] if args.key?(:frequently_bought_together_config)
+        end
+      end
+      
       # Represents an ordered combination of valid serving configs, which can be used
       # for `PAGE_OPTIMIZATION` recommendations.
       class GoogleCloudRetailV2betaModelServingConfigList

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module RetailV2alpha
       # Version of the google-apis-retail_v2alpha gem
-      GEM_VERSION = "0.72.0"
+      GEM_VERSION = "0.74.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230321"
+      REVISION = "20230420"
     end
   end
 end

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

@@ -130,6 +130,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2ModelModelFeaturesConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2ModelServingConfigList
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -310,6 +322,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2alphaCatalogAttributeIgnoredFacetValues
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2alphaColorInfo
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -598,6 +616,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2alphaModelModelFeaturesConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2alphaModelPageOptimizationConfig
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1168,6 +1198,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2betaModelModelFeaturesConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2betaModelServingConfigList
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1445,6 +1487,8 @@ module Google
           property :display_name, as: 'displayName'
           property :filtering_option, as: 'filteringOption'
           property :last_tune_time, as: 'lastTuneTime'
+          property :model_features_config, as: 'modelFeaturesConfig', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2ModelModelFeaturesConfig, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2ModelModelFeaturesConfig::Representation
+      
           property :name, as: 'name'
           property :optimization_objective, as: 'optimizationObjective'
           property :periodic_tuning_state, as: 'periodicTuningState'
@@ -1458,6 +1502,21 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :context_products_type, as: 'contextProductsType'
+        end
+      end
+      
+      class GoogleCloudRetailV2ModelModelFeaturesConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :frequently_bought_together_config, as: 'frequentlyBoughtTogetherConfig', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig::Representation
+      
+        end
+      end
+      
       class GoogleCloudRetailV2ModelServingConfigList
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1679,6 +1738,10 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :dynamic_facetable_option, as: 'dynamicFacetableOption'
           property :exact_searchable_option, as: 'exactSearchableOption'
+          collection :facet_intervals, as: 'facetIntervals', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaInterval, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaInterval::Representation
+      
+          collection :ignored_facet_values, as: 'ignoredFacetValues', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaCatalogAttributeIgnoredFacetValues, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaCatalogAttributeIgnoredFacetValues::Representation
+      
           property :in_use, as: 'inUse'
           property :indexable_option, as: 'indexableOption'
           property :key, as: 'key'
@@ -1689,6 +1752,15 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2alphaCatalogAttributeIgnoredFacetValues
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :end_time, as: 'endTime'
+          property :start_time, as: 'startTime'
+          collection :values, as: 'values'
+        end
+      end
+      
       class GoogleCloudRetailV2alphaColorInfo
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1722,7 +1794,10 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           hash :attributes, as: 'attributes', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaCustomAttribute, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaCustomAttribute::Representation
       
+          collection :facets, as: 'facets', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchResponseFacet, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchResponseFacet::Representation
+      
           property :suggestion, as: 'suggestion'
+          property :total_product_count, as: 'totalProductCount'
         end
       end
       
@@ -1839,7 +1914,7 @@ module Google
       class GoogleCloudRetailV2alphaExperimentInfo
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          property :experiment_name, as: 'experimentName'
+          property :experiment, as: 'experiment'
           property :serving_config_experiment, as: 'servingConfigExperiment', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaExperimentInfoServingConfigExperiment, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaExperimentInfoServingConfigExperiment::Representation
       
         end
@@ -2155,6 +2230,8 @@ module Google
           property :display_name, as: 'displayName'
           property :filtering_option, as: 'filteringOption'
           property :last_tune_time, as: 'lastTuneTime'
+          property :model_features_config, as: 'modelFeaturesConfig', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaModelModelFeaturesConfig, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaModelModelFeaturesConfig::Representation
+      
           property :name, as: 'name'
           property :optimization_objective, as: 'optimizationObjective'
           property :page_optimization_config, as: 'pageOptimizationConfig', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaModelPageOptimizationConfig, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaModelPageOptimizationConfig::Representation
@@ -2170,6 +2247,21 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :context_products_type, as: 'contextProductsType'
+        end
+      end
+      
+      class GoogleCloudRetailV2alphaModelModelFeaturesConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :frequently_bought_together_config, as: 'frequentlyBoughtTogetherConfig', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig::Representation
+      
+        end
+      end
+      
       class GoogleCloudRetailV2alphaModelPageOptimizationConfig
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2621,13 +2713,13 @@ module Google
       class GoogleCloudRetailV2alphaSearchRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          property :banner, as: 'banner'
           property :boost_spec, as: 'boostSpec', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestBoostSpec, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestBoostSpec::Representation
       
           property :branch, as: 'branch'
           property :canonical_filter, as: 'canonicalFilter'
           property :dynamic_facet_spec, as: 'dynamicFacetSpec', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestDynamicFacetSpec, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestDynamicFacetSpec::Representation
       
+          property :entity, as: 'entity'
           collection :facet_specs, as: 'facetSpecs', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestFacetSpec, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestFacetSpec::Representation
       
           property :filter, as: 'filter'
@@ -2883,10 +2975,10 @@ module Google
           hash :attributes, as: 'attributes', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaCustomAttribute, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaCustomAttribute::Representation
       
           property :attribution_token, as: 'attributionToken'
-          property :banner, as: 'banner'
           property :cart_id, as: 'cartId'
           property :completion_detail, as: 'completionDetail', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaCompletionDetail, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaCompletionDetail::Representation
       
+          property :entity, as: 'entity'
           property :event_time, as: 'eventTime'
           property :event_type, as: 'eventType'
           collection :experiment_ids, as: 'experimentIds'
@@ -3121,6 +3213,8 @@ module Google
           property :display_name, as: 'displayName'
           property :filtering_option, as: 'filteringOption'
           property :last_tune_time, as: 'lastTuneTime'
+          property :model_features_config, as: 'modelFeaturesConfig', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2betaModelModelFeaturesConfig, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2betaModelModelFeaturesConfig::Representation
+      
           property :name, as: 'name'
           property :optimization_objective, as: 'optimizationObjective'
           property :periodic_tuning_state, as: 'periodicTuningState'
@@ -3134,6 +3228,21 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :context_products_type, as: 'contextProductsType'
+        end
+      end
+      
+      class GoogleCloudRetailV2betaModelModelFeaturesConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :frequently_bought_together_config, as: 'frequentlyBoughtTogetherConfig', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig::Representation
+      
+        end
+      end
+      
       class GoogleCloudRetailV2betaModelServingConfigList
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -57,8 +57,6 @@ module Google
         # @param [String] catalog
         #   Required. Catalog for which the completion is performed. Full resource name of
         #   catalog, such as `projects/*/locations/global/catalogs/default_catalog`.
-        # @param [String] banner
-        #   The banner context for completion suggestions.
         # @param [String] dataset
         #   Determines which dataset to use for fetching completion. "user-data" will use
         #   the imported dataset through CompletionService.ImportCompletionData. "cloud-
@@ -76,6 +74,11 @@ module Google
         # @param [Boolean] enable_attribute_suggestions
         #   If true, attribute suggestions are enabled and provided in response. This
         #   field is only available for "cloud-retail" dataset.
+        # @param [String] entity
+        #   The entity for customers who run multiple entities, domains, sites, or regions,
+        #   for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`,
+        #   etc. If this is set, it must be an exact match with UserEvent.entity to get
+        #   per-entity autocomplete results.
         # @param [Array<String>, String] language_codes
         #   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
@@ -115,15 +118,15 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def complete_project_location_catalog_query(catalog, banner: nil, dataset: nil, device_type: nil, enable_attribute_suggestions: nil, language_codes: nil, max_suggestions: nil, query: nil, visitor_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def complete_project_location_catalog_query(catalog, dataset: nil, device_type: nil, enable_attribute_suggestions: nil, entity: nil, language_codes: nil, max_suggestions: nil, query: nil, visitor_id: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v2alpha/{+catalog}:completeQuery', options)
           command.response_representation = Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaCompleteQueryResponse::Representation
           command.response_class = Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaCompleteQueryResponse
           command.params['catalog'] = catalog unless catalog.nil?
-          command.query['banner'] = banner unless banner.nil?
           command.query['dataset'] = dataset unless dataset.nil?
           command.query['deviceType'] = device_type unless device_type.nil?
           command.query['enableAttributeSuggestions'] = enable_attribute_suggestions unless enable_attribute_suggestions.nil?
+          command.query['entity'] = entity unless entity.nil?
           command.query['languageCodes'] = language_codes unless language_codes.nil?
           command.query['maxSuggestions'] = max_suggestions unless max_suggestions.nil?
           command.query['query'] = query unless query.nil?
@@ -647,13 +650,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # It is recommended to use the ProductService.AddLocalInventories method instead
-        # of ProductService.AddFulfillmentPlaces. ProductService.AddLocalInventories
-        # achieves the same results but provides more fine-grained control over
-        # ingesting local inventory data. Incrementally adds place IDs to Product.
-        # fulfillment_info.place_ids. This process is asynchronous and does not require
-        # the Product to exist before updating fulfillment information. If the request
-        # is valid, the update will be enqueued and processed downstream. As a
+        # We recommend that you use the ProductService.AddLocalInventories method
+        # instead of the ProductService.AddFulfillmentPlaces method. ProductService.
+        # AddLocalInventories achieves the same results but provides more fine-grained
+        # control over ingesting local inventory data. Incrementally adds place IDs to
+        # Product.fulfillment_info.place_ids. This process is asynchronous and does not
+        # 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, the added place IDs are not
         # immediately manifested in the Product queried by ProductService.GetProduct or
         # ProductService.ListProducts. The returned Operations will be obsolete after 1
@@ -797,7 +800,7 @@ module Google
         #   Product.Type.PRIMARY Product with more than one variants. Otherwise, an
         #   INVALID_ARGUMENT error is returned. All inventory information for the named
         #   Product will be deleted.
-        # @param [Boolean] cascade_delete
+        # @param [Boolean] force
         #   This value only applies to the case when the target product is of type PRIMARY.
         #   When deleting a product of VARIANT/COLLECTION type, this value will be
         #   ignored. When set to true, the subsequent variant products will be deleted.
@@ -820,12 +823,12 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def delete_project_location_catalog_branch_product(name, cascade_delete: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def delete_project_location_catalog_branch_product(name, force: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:delete, 'v2alpha/{+name}', options)
           command.response_representation = Google::Apis::RetailV2alpha::GoogleProtobufEmpty::Representation
           command.response_class = Google::Apis::RetailV2alpha::GoogleProtobufEmpty
           command.params['name'] = name unless name.nil?
-          command.query['cascadeDelete'] = cascade_delete unless cascade_delete.nil?
+          command.query['force'] = force unless force.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -1062,8 +1065,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # It is recommended to use the ProductService.RemoveLocalInventories method
-        # instead of ProductService.RemoveFulfillmentPlaces. ProductService.
+        # We recommend that you use the ProductService.RemoveLocalInventories method
+        # instead of the ProductService.RemoveFulfillmentPlaces method. ProductService.
         # RemoveLocalInventories achieves the same results but provides more fine-
         # grained control over ingesting local inventory data. Incrementally removes
         # place IDs from a Product.fulfillment_info.place_ids. This process is
@@ -1441,17 +1444,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a MerchantCenterAccountLink. MerchantCenterAccountLink cannot be set
-        # to a different oneof field, if so an INVALID_ARGUMENT is returned.
-        # @param [String] name
-        #   Output only. Immutable. Full resource name of the Merchant Center Account Link,
-        #   such as `projects/*/locations/global/catalogs/default_catalog/
-        #   merchantCenterAccountLinks/merchant_center_account_link`.
-        # @param [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaMerchantCenterAccountLink] google_cloud_retail_v2alpha_merchant_center_account_link_object
+        # Creates a MerchantCenterAccountLink.
         # @param [String] parent
         #   Required. The branch resource where this MerchantCenterAccountLink will be
         #   created. Format: projects/`PROJECT_NUMBER`/locations/global/catalogs/`
         #   CATALOG_ID``
+        # @param [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaMerchantCenterAccountLink] google_cloud_retail_v2alpha_merchant_center_account_link_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1469,14 +1467,13 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def create_project_location_catalog_merchant_center_account_link_merchant_center_account_link(name, google_cloud_retail_v2alpha_merchant_center_account_link_object = nil, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2alpha/{+name}', options)
+        def create_project_location_catalog_merchant_center_account_link(parent, google_cloud_retail_v2alpha_merchant_center_account_link_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2alpha/{+parent}/merchantCenterAccountLinks', options)
           command.request_representation = Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaMerchantCenterAccountLink::Representation
           command.request_object = google_cloud_retail_v2alpha_merchant_center_account_link_object
           command.response_representation = Google::Apis::RetailV2alpha::GoogleLongrunningOperation::Representation
           command.response_class = Google::Apis::RetailV2alpha::GoogleLongrunningOperation
-          command.params['name'] = name unless name.nil?
-          command.query['parent'] = parent unless parent.nil?
+          command.params['parent'] = parent unless parent.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -1953,7 +1950,7 @@ module Google
         #   default_serving_config` or the name of the legacy placement resource, such as `
         #   projects/*/locations/global/catalogs/default_catalog/placements/default_search`
         #   . This field is used to identify the serving config name and the set of models
-        #   that will be used to make the search.
+        #   that are used to make the search.
         # @param [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequest] google_cloud_retail_v2alpha_search_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2296,7 +2293,7 @@ module Google
         #   default_serving_config` or the name of the legacy placement resource, such as `
         #   projects/*/locations/global/catalogs/default_catalog/placements/default_search`
         #   . This field is used to identify the serving config name and the set of models
-        #   that will be used to make the search.
+        #   that are used to make the search.
         # @param [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequest] google_cloud_retail_v2alpha_search_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-retail_v2alpha
 version: !ruby/object:Gem::Version
-  version: 0.72.0
+  version: 0.74.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-03-26 00:00:00.000000000 Z
+date: 2023-04-30 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_v2alpha/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2alpha/v0.72.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2alpha/v0.74.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-retail_v2alpha
 post_install_message: 
 rdoc_options: []