google-apis-retail_v2alpha 0.35.0 → 0.36.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0fd269bd8d363bde55fb078faa86e74e1a323df56bcdc81846cf82107e23cde
-  data.tar.gz: 42fcacb10da9e023b5393ee211f0a3c01814ece82fc7f95f230dc57f5d30d8a6
+  metadata.gz: fded543728d24f668d94eab627257d7b2b4b35bfa5040463ebe7b947814cc445
+  data.tar.gz: 398dab6a6d9156d5744f23b56fc5b4f8df10f80e8ddb9e85b92936a9fb1c55d5
 SHA512:
-  metadata.gz: 75cb4ab0fd396f681da64abfe00f028f0a80ad9384430069bb97314b6ae685b095d3a23382675aef2dad849107d7243a622c2fcd92b4fe5bc5610fa0769d576f
-  data.tar.gz: 05a66051d85bd1ab7ee804d0cbee4a2e5955c2b2cd6cdcd6cc4ec0b15f020280fd8197a6fa6ef3711cc232e256268d0670918aa6c5e70abb16a57447eb4177f6
+  metadata.gz: 0b5d043eb964f4b1f4a420c0637f14a3e8e4c67f1fee378fc5789d5767ae440f86ce130c760a7df96635e26f6fd8064df8990a97d3dc8217f1bcf296e91a6b14
+  data.tar.gz: a2ccb8df5765151de59180404029c918fafb267dadadc647aa12a1344dee448a1fb966c9178a94a79285763e999177cbe614d9c70d48de78be6419d78541ebd3

data/CHANGELOG.md

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

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

@@ -1540,14 +1540,6 @@ module Google
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaRule]
         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
@@ -1567,7 +1559,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
@@ -3154,13 +3145,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
@@ -3173,8 +3164,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
@@ -3323,7 +3314,7 @@ module Google
         # `availability`: Double quoted Product.availability string. * `create_time` :
         # in ISO 8601 "zulu" format. Supported syntax: * Comparators (">", "<", ">=", "<=
         # ", "="). Examples: * create_time <= "2015-02-13T17:05:46Z" * availability = "
-        # IN_STOCK” * Conjunctions ("AND") Examples: * create_time <= "2015-02-13T17:05:
+        # IN_STOCK" * Conjunctions ("AND") Examples: * create_time <= "2015-02-13T17:05:
         # 46Z" AND availability = "PREORDER" * Disjunctions ("OR") Examples: *
         # create_time <= "2015-02-13T17:05:46Z" OR availability = "IN_STOCK" * Can
         # support nested queries. Examples: * (create_time <= "2015-02-13T17:05:46Z" AND
@@ -3331,7 +3322,7 @@ module Google
         # availability = "IN_STOCK") * Filter Limits: * Filter should not contain more
         # than 6 conditions. * Max nesting depth should not exceed 2 levels. Examples
         # queries: * Delete back order products created before a timestamp. create_time <
-        # = "2015-02-13T17:05:46Z" OR availability = "BACKORDER”
+        # = "2015-02-13T17:05:46Z" OR availability = "BACKORDER"
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
@@ -4175,7 +4166,8 @@ module Google
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestPersonalizationSpec]
         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
@@ -5281,10 +5273,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]
@@ -5432,9 +5426,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_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.35.0"
+      GEM_VERSION = "0.36.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_v2alpha/representations.rb

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

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

@@ -896,7 +896,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
@@ -1417,13 +1419,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::RetailV2alpha::GoogleCloudRetailV2alphaPredictRequest] google_cloud_retail_v2alpha_predict_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1458,11 +1462,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::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequest] google_cloud_retail_v2alpha_search_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1720,13 +1725,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::RetailV2alpha::GoogleCloudRetailV2alphaPredictRequest] google_cloud_retail_v2alpha_predict_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1798,11 +1805,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::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.35.0
+  version: 0.36.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_v2alpha/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2alpha/v0.35.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2alpha/v0.36.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-retail_v2alpha
 post_install_message: 
 rdoc_options: []