google-apis-retail_v2beta 0.34.0 → 0.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 793b2cf1d7201939c734535abba728b6fe9548a68c91b0e1ead3ec46b149fc24
-  data.tar.gz: 80c1a58f6f5a6fc3ac0e6251d191194bc32f5658a883a31858d235ae2c83a1c3
+  metadata.gz: b7d68a682bc17e8633f7d6cb72be1e81bb413c9ae863e159aa07b3a687e52fb3
+  data.tar.gz: 64ab0f83650d4c4f95c25afbb02dfb6f84d03a1997b52ced6d19d7dddb418293
 SHA512:
-  metadata.gz: 9d3dc4524f5fcac8007e0e6a397131807a1fdccb2a0e709f0158f7d9fd5e700642aeb883a055d5e52edc06bf00088137cfe36da1fa950be16e1672a21ce89d43
-  data.tar.gz: 3fe5693d31911b07e920fec858a517197286bdbcd36d8fddf5f523715dc1d066331a7cc1fe7f1419fe52a0dc425a721f21640a11bbecdd8cecb2e758ef6ff749
+  metadata.gz: 3286d9e495dd9705f93c810587e2ecc6c441c52ba67ea65104399139dc7e1526eaedfd1ea03ed67a3adf55fc696abc41f62f76a2dd8549f9f18823ac8b0afcd6
+  data.tar.gz: c8f6c508370e56c3d3c2e08a3383021f7e08d0f728e78b6eccd306d58bf29a7f868713d66926617c7d9baebdd9215789ee0340ba1cca8c12dcb26af35c15e814

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-retail_v2beta
 
+### v0.35.0 (2022-04-14)
+
+* Regenerated from discovery document revision 20220408
+
 ### v0.34.0 (2022-03-31)
 
 * Regenerated from discovery document revision 20220324

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

@@ -2106,14 +2106,6 @@ module Google
         # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaRule]
         attr_accessor :rule
       
-        # Required. Specifies the use case for the control. Affects what condition
-        # fields can be set. Only settable by search controls. Will default to
-        # SEARCH_SOLUTION_USE_CASE_SEARCH if not specified. Currently only allow one
-        # search_solution_use_case per control.
-        # Corresponds to the JSON property `searchSolutionUseCase`
-        # @return [Array<String>]
-        attr_accessor :search_solution_use_case
-      
         # Required. Immutable. The solution types that the serving config is used for.
         # Currently we support setting only one type of solution at creation time. Only `
         # SOLUTION_TYPE_SEARCH` value is supported at the moment. If no solution type is
@@ -2133,7 +2125,6 @@ module Google
           @facet_spec = args[:facet_spec] if args.key?(:facet_spec)
           @name = args[:name] if args.key?(:name)
           @rule = args[:rule] if args.key?(:rule)
-          @search_solution_use_case = args[:search_solution_use_case] if args.key?(:search_solution_use_case)
           @solution_types = args[:solution_types] if args.key?(:solution_types)
         end
       end
@@ -3711,13 +3702,13 @@ module Google
         # The type of Products allowed to be ingested into the catalog. Acceptable
         # values are: * `primary` (default): You can ingest Products of all types. When
         # ingesting a Product, its type will default to Product.Type.PRIMARY if unset. *
-        # `variant`: You can only ingest Product.Type.VARIANT Products. This means
-        # Product.primary_product_id cannot be empty. If this field is set to an invalid
-        # value other than these, an INVALID_ARGUMENT error is returned. If this field
-        # is `variant` and merchant_center_product_id_field is `itemGroupId`, an
-        # INVALID_ARGUMENT error is returned. See [Using product levels](https://cloud.
-        # google.com/retail/recommendations-ai/docs/catalog#product-levels) for more
-        # details.
+        # `variant` (incompatible with Retail Search): You can only ingest Product.Type.
+        # VARIANT Products. This means Product.primary_product_id cannot be empty. If
+        # this field is set to an invalid value other than these, an INVALID_ARGUMENT
+        # error is returned. If this field is `variant` and
+        # merchant_center_product_id_field is `itemGroupId`, an INVALID_ARGUMENT error
+        # is returned. See [Product levels](https://cloud.google.com/retail/docs/catalog#
+        # product-levels) for more details.
         # Corresponds to the JSON property `ingestionProductType`
         # @return [String]
         attr_accessor :ingestion_product_type
@@ -3730,8 +3721,8 @@ module Google
         # the item group. If this field is set to an invalid value other than these, an
         # INVALID_ARGUMENT error is returned. If this field is `itemGroupId` and
         # ingestion_product_type is `variant`, an INVALID_ARGUMENT error is returned.
-        # See [Using product levels](https://cloud.google.com/retail/recommendations-ai/
-        # docs/catalog#product-levels) for more details.
+        # See [Product levels](https://cloud.google.com/retail/docs/catalog#product-
+        # levels) for more details.
         # Corresponds to the JSON property `merchantCenterProductIdField`
         # @return [String]
         attr_accessor :merchant_center_product_id_field
@@ -4623,7 +4614,8 @@ module Google
         # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaSearchRequestPersonalizationSpec]
         attr_accessor :personalization_spec
       
-        # Raw search query.
+        # Raw search query. If this field is empty, the request is considered a category
+        # browsing request and returned results are based on filter and page_categories.
         # Corresponds to the JSON property `query`
         # @return [String]
         attr_accessor :query
@@ -5720,10 +5712,12 @@ module Google
         # Required. A unique identifier for tracking visitors. For example, this could
         # be implemented with an HTTP cookie, which should be able to uniquely identify
         # a visitor on a single device. This unique identifier should not change if the
-        # visitor log in/out of the website. The field must be a UTF-8 encoded string
-        # with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is
-        # returned. The field should not contain PII or user-data. We recommend to use
-        # Google Analystics [Client ID](https://developers.google.com/analytics/
+        # visitor log in/out of the website. Don't set the field to the same fixed ID
+        # for different users. This mixes the event history of those users together,
+        # which results in degraded model quality. The field must be a UTF-8 encoded
+        # string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT
+        # error is returned. The field should not contain PII or user-data. We recommend
+        # to use Google Analystics [Client ID](https://developers.google.com/analytics/
         # devguides/collection/analyticsjs/field-reference#clientId) for this field.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
@@ -5871,9 +5865,11 @@ module Google
         attr_accessor :user_agent
       
         # Highly recommended for logged-in users. Unique identifier for logged-in user,
-        # such as a user name. Always use a hashed value for this ID. The field must be
-        # a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an
-        # INVALID_ARGUMENT error is returned.
+        # such as a user name. Don't set for anonymous users. Always use a hashed value
+        # for this ID. Don't set the field to the same fixed ID for different users.
+        # This mixes the event history of those users together, which results in
+        # degraded model quality. The field must be a UTF-8 encoded string with a length
+        # limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.
         # Corresponds to the JSON property `userId`
         # @return [String]
         attr_accessor :user_id

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.34.0"
+      GEM_VERSION = "0.35.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.4.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20220324"
+      REVISION = "20220408"
     end
   end
 end

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

@@ -1655,7 +1655,6 @@ module Google
           property :name, as: 'name'
           property :rule, as: 'rule', class: Google::Apis::RetailV2beta::GoogleCloudRetailV2betaRule, decorator: Google::Apis::RetailV2beta::GoogleCloudRetailV2betaRule::Representation
       
-          collection :search_solution_use_case, as: 'searchSolutionUseCase'
           collection :solution_types, as: 'solutionTypes'
         end
       end

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

@@ -891,7 +891,9 @@ module Google
         #   output only fields are NOT supported. If not set, all supported fields (the
         #   fields that are neither immutable nor output only) are updated. If an
         #   unsupported or unknown field is provided, an INVALID_ARGUMENT error is
-        #   returned.
+        #   returned. The attribute key can be updated by setting the mask path as "
+        #   attributes.$`key_name`". If a key name is present in the mask but not in the
+        #   patching product from the request, this key will be deleted after the update.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1371,13 +1373,15 @@ module Google
         # Makes a recommendation prediction.
         # @param [String] placement
         #   Required. Full resource name of the format: `name=projects/*/locations/global/
-        #   catalogs/default_catalog/placements/*` or `name=projects/*/locations/global/
-        #   catalogs/default_catalog/servingConfigs/*` The ID of the Recommendations AI
-        #   placement. Before you can request predictions from your model, you must create
-        #   at least one placement for it. For more information, see [Managing placements](
-        #   https://cloud.google.com/retail/recommendations-ai/docs/manage-placements).
-        #   The full list of available placements can be seen at https://console.cloud.
-        #   google.com/recommendation/catalogs/default_catalog/placements
+        #   catalogs/default_catalog/servingConfigs/*` or `name=projects/*/locations/
+        #   global/catalogs/default_catalog/placements/*`. We recommend using 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
         # @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.
@@ -1412,11 +1416,12 @@ module Google
         # Search enabled. Please enable Retail Search on Cloud Console before using this
         # feature.
         # @param [String] placement
-        #   Required. The resource name of the search engine placement, such as `projects/*
-        #   /locations/global/catalogs/default_catalog/placements/default_search` or `
+        #   Required. The resource name of the Retail Search serving config, such as `
         #   projects/*/locations/global/catalogs/default_catalog/servingConfigs/
-        #   default_serving_config` This field is used to identify the serving
-        #   configuration name and the set of models that will be used to make the search.
+        #   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.
         # @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.
@@ -1674,13 +1679,15 @@ module Google
         # Makes a recommendation prediction.
         # @param [String] placement
         #   Required. Full resource name of the format: `name=projects/*/locations/global/
-        #   catalogs/default_catalog/placements/*` or `name=projects/*/locations/global/
-        #   catalogs/default_catalog/servingConfigs/*` The ID of the Recommendations AI
-        #   placement. Before you can request predictions from your model, you must create
-        #   at least one placement for it. For more information, see [Managing placements](
-        #   https://cloud.google.com/retail/recommendations-ai/docs/manage-placements).
-        #   The full list of available placements can be seen at https://console.cloud.
-        #   google.com/recommendation/catalogs/default_catalog/placements
+        #   catalogs/default_catalog/servingConfigs/*` or `name=projects/*/locations/
+        #   global/catalogs/default_catalog/placements/*`. We recommend using 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
         # @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.
@@ -1752,11 +1759,12 @@ module Google
         # Search enabled. Please enable Retail Search on Cloud Console before using this
         # feature.
         # @param [String] placement
-        #   Required. The resource name of the search engine placement, such as `projects/*
-        #   /locations/global/catalogs/default_catalog/placements/default_search` or `
+        #   Required. The resource name of the Retail Search serving config, such as `
         #   projects/*/locations/global/catalogs/default_catalog/servingConfigs/
-        #   default_serving_config` This field is used to identify the serving
-        #   configuration name and the set of models that will be used to make the search.
+        #   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.
         # @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.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-retail_v2beta
 version: !ruby/object:Gem::Version
-  version: 0.34.0
+  version: 0.35.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-04-04 00:00:00.000000000 Z
+date: 2022-04-18 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.34.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2beta/v0.35.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-retail_v2beta
 post_install_message: 
 rdoc_options: []