google-apis-retail_v2beta 0.59.0 → 0.61.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a32efd6c0d306ff916298fac68ca942a65a3b00e6dcbaae1692de116b277448f
-  data.tar.gz: 554c62cebf22997f21f120a1e14e6ec73e4f0f5cc1bd24d5925ccc5e95490b1f
+  metadata.gz: b3fb77eff1104a388f1f370195d8d0b9b1e0b94f482a95292233a1d21a2543d7
+  data.tar.gz: dd6ebc8162bae9172f726a85b3b891e94cbbedfb6d15f3f9708c1344a481b593
 SHA512:
-  metadata.gz: a075bd30419d258436e480320eed28ad653fe9ce417c23717512d31e9586ec5efaa089f500c42fc7490f4e50728624d4ac8568f997a6de37ad6b7b3055b2f4b1
-  data.tar.gz: 3e180c284d6fc74192470b908354ec57719548039bf6072b65e02be2c4c5d5c7e31be1a5c32bd42bd6ad5d9571141521fc4ace2d2b850a71bd3610e4a633039d
+  metadata.gz: bfb6e3cbd7dec4a2894c024fdbe5e8dfe2c22ceafcf0118c68701476c09d0bfe9f1902ce53a42abcf7ff7512e68189c2f7a8a4a0039870bb644b511b6481cb13
+  data.tar.gz: 77c040e7244f02569722e415f83bfae5d7348862774800519e64cae4344fdd80e2385759bc55c36155eb81b364f01978b98cec3bcb96bd1a2edef2b699dcec01

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-retail_v2beta
 
+### v0.61.0 (2023-01-04)
+
+* Regenerated from discovery document revision 20230102
+
+### v0.60.0 (2022-12-03)
+
+* Regenerated from discovery document revision 20221130
+
 ### v0.59.0 (2022-11-08)
 
 * Regenerated from discovery document revision 20221107

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

@@ -1145,8 +1145,8 @@ module Google
         attr_accessor :optimization_objective
       
         # The PageOptimizationConfig for model training. This determines how many panels
-        # to optimize for, and which serving configurations to consider for each panel.
-        # The purpose of this model is to optimize which ServingConfig to show on which
+        # 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
         # panels in way that optimizes the visitors shopping journey.
         # Corresponds to the JSON property `pageOptimizationConfig`
         # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2alphaModelPageOptimizationConfig]
@@ -1188,14 +1188,14 @@ module Google
       
         # Required. The type of model e.g. `home-page`. Currently supported values: `
         # recommended-for-you`, `others-you-may-like`, `frequently-bought-together`, `
-        # page-optimization`, `similar-items`, `buy-it-again`, and `recently-viewed`(
-        # readonly value). This field together with optimization_objective describe
-        # model metadata to use to control model training and serving. See https://cloud.
-        # google.com/retail/docs/models for more details on what the model metadata
-        # control and which combination of parameters are valid. For invalid
-        # combinations of parameters (e.g. type = `frequently-bought-together` and
-        # optimization_objective = `ctr`), you receive an error 400 if you try to create/
-        # update a recommendation with this set of knobs.
+        # page-optimization`, `similar-items`, `buy-it-again`, `on-sale-items`, and `
+        # recently-viewed`(readonly value). This field together with
+        # optimization_objective describe model metadata to use to control model
+        # training and serving. See https://cloud.google.com/retail/docs/models for more
+        # details on what the model metadata control and which combination of parameters
+        # are valid. For invalid combinations of parameters (e.g. type = `frequently-
+        # bought-together` and optimization_objective = `ctr`), you receive an error 400
+        # if you try to create/update a recommendation with this set of knobs.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -1232,8 +1232,8 @@ module Google
       end
       
       # The PageOptimizationConfig for model training. This determines how many panels
-      # to optimize for, and which serving configurations to consider for each panel.
-      # The purpose of this model is to optimize which ServingConfig to show on which
+      # 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
       # panels in way that optimizes the visitors shopping journey.
       class GoogleCloudRetailV2alphaModelPageOptimizationConfig
         include Google::Apis::Core::Hashable
@@ -2170,7 +2170,8 @@ module Google
       
         # If EXACT_SEARCHABLE_ENABLED, attribute values will be exact searchable. This
         # property only applies to textual custom attributes and requires indexable set
-        # to enabled to enable exact-searchable.
+        # to enabled to enable exact-searchable. If unset, the server behavior defaults
+        # to EXACT_SEARCHABLE_DISABLED.
         # Corresponds to the JSON property `exactSearchableOption`
         # @return [String]
         attr_accessor :exact_searchable_option
@@ -2203,7 +2204,9 @@ module Google
         # custom_attribute`, such as `attributes.xyz`. To be indexable, the attribute
         # name can contain only alpha-numeric characters and underscores. For example,
         # an attribute named `attributes.abc_xyz` can be indexed, but an attribute named
-        # `attributes.abc-xyz` cannot be indexed.
+        # `attributes.abc-xyz` cannot be indexed. For attributes whoes key start with `
+        # attributes.`, we refer them as custom attributes. Otherwise they are built-in
+        # attributes such as `color` and `brands`.
         # Corresponds to the JSON property `key`
         # @return [String]
         attr_accessor :key
@@ -2216,6 +2219,12 @@ module Google
         # @return [String]
         attr_accessor :recommendations_filtering_option
       
+        # If RETRIEVABLE_ENABLED, attribute values are retrievable in the search results.
+        # If unset, the server behavior defaults to RETRIEVABLE_DISABLED.
+        # Corresponds to the JSON property `retrievableOption`
+        # @return [String]
+        attr_accessor :retrievable_option
+      
         # When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG,
         # if SEARCHABLE_ENABLED, attribute values are searchable by text queries in
         # SearchService.Search. If SEARCHABLE_ENABLED but attribute type is numerical,
@@ -2244,6 +2253,7 @@ module Google
           @indexable_option = args[:indexable_option] if args.key?(:indexable_option)
           @key = args[:key] if args.key?(:key)
           @recommendations_filtering_option = args[:recommendations_filtering_option] if args.key?(:recommendations_filtering_option)
+          @retrievable_option = args[:retrievable_option] if args.key?(:retrievable_option)
           @searchable_option = args[:searchable_option] if args.key?(:searchable_option)
           @type = args[:type] if args.key?(:type)
         end
@@ -2622,9 +2632,9 @@ module Google
       class GoogleCloudRetailV2betaControl
         include Google::Apis::Core::Hashable
       
-        # Output only. List of serving configuration ids that are associated with this
-        # control in the same Catalog. Note the association is managed via the
-        # ServingConfig, this is an output only denormalized view.
+        # Output only. List of serving config ids that are associated with this control
+        # in the same Catalog. Note the association is managed via the ServingConfig,
+        # this is an output only denormalized view.
         # Corresponds to the JSON property `associatedServingConfigIds`
         # @return [Array<String>]
         attr_accessor :associated_serving_config_ids
@@ -3744,14 +3754,14 @@ module Google
       
         # Required. The type of model e.g. `home-page`. Currently supported values: `
         # recommended-for-you`, `others-you-may-like`, `frequently-bought-together`, `
-        # page-optimization`, `similar-items`, `buy-it-again`, and `recently-viewed`(
-        # readonly value). This field together with optimization_objective describe
-        # model metadata to use to control model training and serving. See https://cloud.
-        # google.com/retail/docs/models for more details on what the model metadata
-        # control and which combination of parameters are valid. For invalid
-        # combinations of parameters (e.g. type = `frequently-bought-together` and
-        # optimization_objective = `ctr`), you receive an error 400 if you try to create/
-        # update a recommendation with this set of knobs.
+        # page-optimization`, `similar-items`, `buy-it-again`, `on-sale-items`, and `
+        # recently-viewed`(readonly value). This field together with
+        # optimization_objective describe model metadata to use to control model
+        # training and serving. See https://cloud.google.com/retail/docs/models for more
+        # details on what the model metadata control and which combination of parameters
+        # are valid. For invalid combinations of parameters (e.g. type = `frequently-
+        # bought-together` and optimization_objective = `ctr`), you receive an error 400
+        # if you try to create/update a recommendation with this set of knobs.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -4388,7 +4398,8 @@ module Google
         # For Type.VARIANT, the following fields are always returned in by default: *
         # name * color_info The maximum number of paths is 30. Otherwise, an
         # INVALID_ARGUMENT error is returned. Note: Returning more fields in
-        # SearchResponse can increase response payload size and serving latency.
+        # SearchResponse can increase response payload size and serving latency. This
+        # field is deprecated. Use the retrievable site-wide control instead.
         # Corresponds to the JSON property `retrievableFields`
         # @return [String]
         attr_accessor :retrievable_fields
@@ -6278,7 +6289,8 @@ module Google
         # @return [String]
         attr_accessor :diversity_level
       
-        # What kind of diversity to use - data driven or rule based.
+        # What kind of diversity to use - data driven or rule based. If unset, the
+        # server behavior defaults to RULE_BASED_DIVERSITY.
         # Corresponds to the JSON property `diversityType`
         # @return [String]
         attr_accessor :diversity_type
@@ -6366,7 +6378,7 @@ module Google
         # product items with a similar recommendation probability to be ordered by price,
         # with the highest-priced items first. This setting could result in a decrease
         # in click-through and conversion rates. Allowed values are: * `no-price-
-        # reranking` * `low-price-raranking` * `medium-price-reranking` * `high-price-
+        # reranking` * `low-price-reranking` * `medium-price-reranking` * `high-price-
         # reranking` If not specified, we choose default based on model type. Default
         # value: `no-price-reranking`. Can only be set if solution_types is
         # SOLUTION_TYPE_RECOMMENDATION.

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module RetailV2beta
       # Version of the google-apis-retail_v2beta gem
-      GEM_VERSION = "0.59.0"
+      GEM_VERSION = "0.61.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.11.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20221107"
+      REVISION = "20230102"
     end
   end
 end

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

@@ -1852,6 +1852,7 @@ module Google
           property :indexable_option, as: 'indexableOption'
           property :key, as: 'key'
           property :recommendations_filtering_option, as: 'recommendationsFilteringOption'
+          property :retrievable_option, as: 'retrievableOption'
           property :searchable_option, as: 'searchableOption'
           property :type, as: 'type'
         end

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

@@ -1689,10 +1689,10 @@ module Google
         #   the `servingConfigs` resource. `placements` is a legacy resource. The ID of
         #   the Recommendations AI serving config or placement. Before you can request
         #   predictions from your model, you must create at least one serving config or
-        #   placement for it. For more information, see [Managing serving configurations] (
-        #   https://cloud.google.com/retail/docs/manage-configs). The full list of
-        #   available serving configs can be seen at https://console.cloud.google.com/ai/
-        #   retail/catalogs/default_catalog/configs
+        #   placement for it. For more information, see [Manage serving configs] (https://
+        #   cloud.google.com/retail/docs/manage-configs). The full list of available
+        #   serving configs can be seen at https://console.cloud.google.com/ai/retail/
+        #   catalogs/default_catalog/configs
         # @param [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaPredictRequest] google_cloud_retail_v2beta_predict_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1731,8 +1731,8 @@ module Google
         #   projects/*/locations/global/catalogs/default_catalog/servingConfigs/
         #   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 configuration name and the set of
-        #   models that will be used to make the search.
+        #   . This field is used to identify the serving config name and the set of models
+        #   that will be used to make the search.
         # @param [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaSearchRequest] google_cloud_retail_v2beta_search_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1995,10 +1995,10 @@ module Google
         #   the `servingConfigs` resource. `placements` is a legacy resource. The ID of
         #   the Recommendations AI serving config or placement. Before you can request
         #   predictions from your model, you must create at least one serving config or
-        #   placement for it. For more information, see [Managing serving configurations] (
-        #   https://cloud.google.com/retail/docs/manage-configs). The full list of
-        #   available serving configs can be seen at https://console.cloud.google.com/ai/
-        #   retail/catalogs/default_catalog/configs
+        #   placement for it. For more information, see [Manage serving configs] (https://
+        #   cloud.google.com/retail/docs/manage-configs). The full list of available
+        #   serving configs can be seen at https://console.cloud.google.com/ai/retail/
+        #   catalogs/default_catalog/configs
         # @param [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaPredictRequest] google_cloud_retail_v2beta_predict_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2074,8 +2074,8 @@ module Google
         #   projects/*/locations/global/catalogs/default_catalog/servingConfigs/
         #   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 configuration name and the set of
-        #   models that will be used to make the search.
+        #   . This field is used to identify the serving config name and the set of models
+        #   that will be used to make the search.
         # @param [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaSearchRequest] google_cloud_retail_v2beta_search_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2119,7 +2119,7 @@ module Google
         #   payload bytes.
         # @param [String] prebuilt_rule
         #   The prebuilt rule name that can convert a specific type of raw_json. For
-        #   example: "default_schema/v1.0"
+        #   example: "ga4_bq" rule for the GA4 user event schema.
         # @param [String] raw_json
         #   An arbitrary serialized JSON string that contains necessary information that
         #   can comprise a user event. When this field is specified, the user_event field
@@ -2284,6 +2284,11 @@ module Google
         #   Required. The parent catalog resource name, such as `projects/1234/locations/
         #   global/catalogs/default_catalog`.
         # @param [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaUserEvent] google_cloud_retail_v2beta_user_event_object
+        # @param [Boolean] write_async
+        #   If set to true, the user event will be written asynchronously after validation,
+        #   and the API will respond without waiting for the write. Therefore, silent
+        #   failures can occur even if the API returns success. In case of silent failures,
+        #   error messages can be found in Stackdriver logs.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2301,13 +2306,14 @@ 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 write_project_location_catalog_user_event(parent, google_cloud_retail_v2beta_user_event_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+        def write_project_location_catalog_user_event(parent, google_cloud_retail_v2beta_user_event_object = nil, write_async: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:post, 'v2beta/{+parent}/userEvents:write', options)
           command.request_representation = Google::Apis::RetailV2beta::GoogleCloudRetailV2betaUserEvent::Representation
           command.request_object = google_cloud_retail_v2beta_user_event_object
           command.response_representation = Google::Apis::RetailV2beta::GoogleCloudRetailV2betaUserEvent::Representation
           command.response_class = Google::Apis::RetailV2beta::GoogleCloudRetailV2betaUserEvent
           command.params['parent'] = parent unless parent.nil?
+          command.query['writeAsync'] = write_async unless write_async.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-retail_v2beta
 version: !ruby/object:Gem::Version
-  version: 0.59.0
+  version: 0.61.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-11-14 00:00:00.000000000 Z
+date: 2023-01-04 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_v2beta/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2beta/v0.59.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2beta/v0.61.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-retail_v2beta
 post_install_message: 
 rdoc_options: []