google-apis-retail_v2 0.33.0 → 0.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18e916d64c386f6c9b65fcf3e6d27b2460371aa7dc0a23749c10f5c59b27db0f
-  data.tar.gz: f439bdacce1ca3cefdcde5cfdeb3ad8a026141758711ef1a7cc223c6261021ed
+  metadata.gz: a813962e4570bfe41ed865ea4b7ad39a2947507cee3a4810020185ff1b71ba51
+  data.tar.gz: '078ff530d7ab11b7cd3121ae3a6a880047fb98af9c53ecc8e1641d1214ae4f8b'
 SHA512:
-  metadata.gz: d7d59732abbc3a970e1a29a1eaef0d359ae436415e4166a69a09962fdfc67d766a9071c79050f11f4a77d14dcc30284626a63d24caf5346d3dd05b3929f5bafb
-  data.tar.gz: f1fb7248f0492d2ef6e237b224a75cb1ffb7b9d338e38aa33416eac49b4f5f20e94bdb7b646b14be02c499c0cc3b748a54d9d81bd113414441604114a0defb23
+  metadata.gz: 15cfe72834120580d3152e2d4fa47340b7dbe30b3a41f7c4f179dd1345934e5bf38250600cceaeeb3623d4861c6c6b9ae29b7b11247f2380414b198ee14843df
+  data.tar.gz: 228d224d330e862b8bf89f448a61b7be1cb782bbe683a8e35d95a44c8088cd1daa95a9f6fa4fccc826b421e4f26a782ea33a760d8fc50f08cef098395642bf27

data/CHANGELOG.md

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

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

@@ -2109,13 +2109,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
@@ -2128,8 +2128,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
@@ -2627,7 +2627,8 @@ module Google
         # @return [Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestPersonalizationSpec]
         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
@@ -3547,10 +3548,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]
@@ -3698,9 +3701,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_v2/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module RetailV2
       # Version of the google-apis-retail_v2 gem
-      GEM_VERSION = "0.33.0"
+      GEM_VERSION = "0.34.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_v2/service.rb

@@ -638,7 +638,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
@@ -927,13 +929,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::RetailV2::GoogleCloudRetailV2PredictRequest] google_cloud_retail_v2_predict_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -968,11 +972,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::RetailV2::GoogleCloudRetailV2SearchRequest] google_cloud_retail_v2_search_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1006,13 +1011,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::RetailV2::GoogleCloudRetailV2PredictRequest] google_cloud_retail_v2_predict_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1047,11 +1054,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::RetailV2::GoogleCloudRetailV2SearchRequest] google_cloud_retail_v2_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_v2
 version: !ruby/object:Gem::Version
-  version: 0.33.0
+  version: 0.34.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_v2/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2/v0.33.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2/v0.34.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-retail_v2
 post_install_message: 
 rdoc_options: []