google-apis-retail_v2alpha 0.73.0 → 0.75.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f4154c9d6ff1dd3590856310016be05564b099e9f3005f898b0b563b695270e6
-  data.tar.gz: f4442c982ac8612523538ca476b06f85f21e08fc9ad9aa30d9e2ebf133e6111c
+  metadata.gz: 0237f5dcb44c07260da0a482c5e89f8120c0ce1453bd0c793f67cf781d9ce991
+  data.tar.gz: 742eec2214ef8ff8e6fdd6d7dc1196b827bda6da0aa3bcc7401e40b9b2a4abae
 SHA512:
-  metadata.gz: a6ba8a7044e5ff19f5055f60e5256d1e93338778ed15c7d3cbf948324c7545cf2619715ae6f135a848d6a2ca60f7302bfddea45c73577229ee91ebe5512687f4
-  data.tar.gz: 11489b01710879077251c914ba43838331c11d986a6f140b3567f7a701309d07267e2e7e667a55e81e7fe7456e5b1971e579b634c89ecb7ee0e5e8986ab76c9b
+  metadata.gz: 27fba2e143c88afb3f993b7d0268e3d3e599c29f562169ef579be20750372c4957b4d0e37b30d48e539ad67348cab1b21ee972ef207b2f0d8b2adeebd3c79dcb
+  data.tar.gz: 75eb0701b172d4aac1f20d2b8c2a0a8619b15f1d04df6b018246822b3e4813630ac1075ee8b0c1d8ea4f40ab3ed6a72f2734fbe2c0bea6bfbbda1a65f310da88

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-retail_v2alpha
 
+### v0.75.0 (2023-05-14)
+
+* Regenerated from discovery document revision 20230504
+
+### 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
       
+      # Additional configs for the frequently-bought-together model type.
+      class GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Specifies the context of the model when it is used in predict
+        # requests. Can only be set for the `frequently-bought-together` type. If it isn'
+        # t specified, it defaults to MULTIPLE_CONTEXT_PRODUCTS.
+        # 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
+      
+        # Additional configs for 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
@@ -1530,8 +1576,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 +1723,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 +2096,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 +2583,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
@@ -2918,17 +2966,17 @@ module Google
         end
       end
       
-      # 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.
+      # Represents a link between a Merchant Center account and a branch. After a link
+      # is established, products from the linked Merchant Center account are streamed
+      # to the linked branch.
       class GoogleCloudRetailV2alphaMerchantCenterAccountLink
         include Google::Apis::Core::Hashable
       
-        # Required. The branch id (e.g. 0/1/2) within the catalog that products from
+        # Required. The branch ID (e.g. 0/1/2) within the catalog that products from
         # merchant_center_account_id are streamed to. When updating this field, an empty
         # value will use the currently configured default branch. However, changing the
         # default branch later on won't change the linked branch here. A single branch
-        # id can only have one linked merchant center account id.
+        # ID can only have one linked Merchant Center account ID.
         # Corresponds to the JSON property `branchId`
         # @return [String]
         attr_accessor :branch_id
@@ -3058,9 +3106,9 @@ module Google
         end
       end
       
-      # 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.
+      # Represents a link between a Merchant Center account and a branch. After a link
+      # is established, products from the linked Merchant Center account are streamed
+      # to the linked branch.
       class GoogleCloudRetailV2alphaMerchantCenterLink
         include Google::Apis::Core::Hashable
       
@@ -3068,7 +3116,7 @@ module Google
         # merchant_center_account_id are streamed to. When updating this field, an empty
         # value will use the currently configured default branch. However, changing the
         # default branch later on won't change the linked branch here. A single branch
-        # ID can only have one linked merchant center account ID.
+        # ID can only have one linked Merchant Center account ID.
         # Corresponds to the JSON property `branchId`
         # @return [String]
         attr_accessor :branch_id
@@ -3098,7 +3146,7 @@ module Google
         # @return [String]
         attr_accessor :language_code
       
-        # Required. The linked [Merchant center account ID](https://developers.google.
+        # Required. The linked [Merchant Center account ID](https://developers.google.
         # com/shopping-content/guides/accountstatuses). The account must be a standalone
         # account or a sub-account of a MCA.
         # Corresponds to the JSON property `merchantCenterAccountId`
@@ -3186,6 +3234,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 +3336,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 +3350,46 @@ module Google
         end
       end
       
+      # Additional configs for the frequently-bought-together model type.
+      class GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Specifies the context of the model when it is used in predict
+        # requests. Can only be set for the `frequently-bought-together` type. If it isn'
+        # t specified, it defaults to MULTIPLE_CONTEXT_PRODUCTS.
+        # 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
+      
+        # Additional configs for 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 +5093,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 +5265,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 +5294,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 +5310,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 +5327,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 +5379,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 +5566,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 +5645,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 +5654,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 +5693,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 +5701,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 +6517,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
@@ -7164,17 +7257,17 @@ module Google
         end
       end
       
-      # 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.
+      # Represents a link between a Merchant Center account and a branch. After a link
+      # is established, products from the linked Merchant Center account are streamed
+      # to the linked branch.
       class GoogleCloudRetailV2betaMerchantCenterAccountLink
         include Google::Apis::Core::Hashable
       
-        # Required. The branch id (e.g. 0/1/2) within the catalog that products from
+        # Required. The branch ID (e.g. 0/1/2) within the catalog that products from
         # merchant_center_account_id are streamed to. When updating this field, an empty
         # value will use the currently configured default branch. However, changing the
         # default branch later on won't change the linked branch here. A single branch
-        # id can only have one linked merchant center account id.
+        # ID can only have one linked Merchant Center account ID.
         # Corresponds to the JSON property `branchId`
         # @return [String]
         attr_accessor :branch_id
@@ -7316,6 +7409,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 +7503,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 +7516,46 @@ module Google
         end
       end
       
+      # Additional configs for the frequently-bought-together model type.
+      class GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Specifies the context of the model when it is used in predict
+        # requests. Can only be set for the `frequently-bought-together` type. If it isn'
+        # t specified, it defaults to MULTIPLE_CONTEXT_PRODUCTS.
+        # 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
+      
+        # Additional configs for 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.75.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 = "20230504"
     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
       
@@ -598,6 +610,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 +1192,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 +1481,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 +1496,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
@@ -2158,6 +2211,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 +2228,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 +3194,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 +3209,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/`
+        #   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)
@@ -1488,9 +1482,9 @@ module Google
         # Deletes a MerchantCenterAccountLink. If the MerchantCenterAccountLink to
         # delete does not exist, a NOT_FOUND error is returned.
         # @param [String] name
-        #   Required. Full resource name. Format: projects/`project_number`/locations/`
+        #   Required. Full resource name. Format: `projects/`project_number`/locations/`
         #   location_id`/catalogs/`catalog_id`/merchantCenterAccountLinks/`
-        #   merchant_center_account_link_id`
+        #   merchant_center_account_link_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1520,8 +1514,8 @@ module Google
         
         # Lists all MerchantCenterAccountLinks under the specified parent Catalog.
         # @param [String] parent
-        #   Required. The parent Catalog of the resource. It must match this format:
-        #   projects/`PROJECT_NUMBER`/locations/global/catalogs/`CATALOG_ID`
+        #   Required. The parent Catalog of the resource. It must match this format: `
+        #   projects/`PROJECT_NUMBER`/locations/global/catalogs/`CATALOG_ID``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -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.75.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-04-23 00:00:00.000000000 Z
+date: 2023-05-14 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.75.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-retail_v2alpha
 post_install_message: 
 rdoc_options: []