google-apis-retail_v2alpha 0.73.0 → 0.74.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f4154c9d6ff1dd3590856310016be05564b099e9f3005f898b0b563b695270e6
-  data.tar.gz: f4442c982ac8612523538ca476b06f85f21e08fc9ad9aa30d9e2ebf133e6111c
+  metadata.gz: d8f55eda4658a84aed629800971bc2ef19d3f51131af51965ca65bb3be91c40c
+  data.tar.gz: fde1d2f8328e00e17ceadc6c2242e723db3221cc746e1139c4db8b6ac2991e44
 SHA512:
-  metadata.gz: a6ba8a7044e5ff19f5055f60e5256d1e93338778ed15c7d3cbf948324c7545cf2619715ae6f135a848d6a2ca60f7302bfddea45c73577229ee91ebe5512687f4
-  data.tar.gz: 11489b01710879077251c914ba43838331c11d986a6f140b3567f7a701309d07267e2e7e667a55e81e7fe7456e5b1971e579b634c89ecb7ee0e5e8986ab76c9b
+  metadata.gz: f0d427471d03fe866cf1b328f8ca6a39044be82d9e882f804f98c7962757ab581251f6bea6096212b8a1e7a0cfa6f00e596ed364a795414ab5a0791bc7529514
+  data.tar.gz: 9a5b4ee35111122ed10fa43440f9419da911283f651d4a633533becdd9e3fdb15d5647f6be40ad06d7516fcbc01263248239e0a973021599bb38da624e1b7bed

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # 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

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.
@@ -1677,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
@@ -2050,7 +2155,7 @@ 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
       
@@ -2537,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
@@ -3186,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
@@ -3283,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)
@@ -3296,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
@@ -4999,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
@@ -5171,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
@@ -5200,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]
@@ -5216,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
@@ -5232,8 +5386,8 @@ 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]
@@ -5284,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
@@ -5471,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
@@ -5551,8 +5704,8 @@ 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
@@ -5560,12 +5713,12 @@ module Google
         # 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
+        # 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.
+        # 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
@@ -5599,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`
@@ -5607,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
@@ -6424,8 +6576,8 @@ module Google
       
         # 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. It is recommended to set this field to get better per-
-        # entity search, completion and prediction results.
+        # , `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
@@ -7316,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
@@ -7405,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)
@@ -7417,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.73.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 = "20230413"
+      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
@@ -2158,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
@@ -2173,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
@@ -3124,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'
@@ -3137,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

@@ -75,10 +75,10 @@ module Google
         #   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 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 per-entity autocomplete results.
+        #   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
@@ -650,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
@@ -1065,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
@@ -1444,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
@@ -1472,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)
@@ -1956,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.
@@ -2299,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.73.0
+  version: 0.74.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-04-23 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.73.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: []