google-cloud-retail-v2 0.8.0 → 0.11.0

data/lib/google/cloud/retail/v2/product_service_services_pb.rb

@@ -62,18 +62,21 @@ module Google
             # enqueued and processed downstream. As a consequence, when a response is
             # returned, updates are not immediately manifested in the
             # [Product][google.cloud.retail.v2.Product] queried by
-            # [GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or
-            # [ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
+            # [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct]
+            # or
+            # [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
             #
             # When inventory is updated with
-            # [CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] and
-            # [UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct], the
-            # specified inventory field value(s) will overwrite any existing value(s)
+            # [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct]
+            # and
+            # [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct],
+            # the specified inventory field value(s) will overwrite any existing value(s)
             # while ignoring the last update time for this field. Furthermore, the last
             # update time for the specified inventory fields will be overwritten to the
             # time of the
-            # [CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] or
-            # [UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct]
+            # [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct]
+            # or
+            # [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct]
             # request.
             #
             # If no inventory fields are set in
@@ -85,10 +88,17 @@ module Google
             # then any existing inventory information will be preserved.
             #
             # Pre-existing inventory information can only be updated with
-            # [SetInventory][google.cloud.retail.v2.ProductService.SetInventory],
+            # [ProductService.SetInventory][google.cloud.retail.v2.ProductService.SetInventory],
             # [ProductService.AddFulfillmentPlaces][google.cloud.retail.v2.ProductService.AddFulfillmentPlaces],
             # and
-            # [RemoveFulfillmentPlaces][google.cloud.retail.v2.ProductService.RemoveFulfillmentPlaces].
+            # [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2.ProductService.RemoveFulfillmentPlaces].
+            #
+            # The returned [Operation][]s will be obsolete after 1 day, and
+            # [GetOperation][] API will return NOT_FOUND afterwards.
+            #
+            # If conflicting updates are issued, the [Operation][]s associated with the
+            # stale updates will not be marked as [done][Operation.done] until being
+            # obsolete.
             #
             # This feature is only available for users who have Retail Search enabled.
             # Please enable Retail Search on Cloud Console before using this feature.
@@ -102,8 +112,16 @@ module Google
             # enqueued and processed downstream. As a consequence, when a response is
             # returned, the added place IDs are not immediately manifested in the
             # [Product][google.cloud.retail.v2.Product] queried by
-            # [GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or
-            # [ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
+            # [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct]
+            # or
+            # [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
+            #
+            # The returned [Operation][]s will be obsolete after 1 day, and
+            # [GetOperation][] API will return NOT_FOUND afterwards.
+            #
+            # If conflicting updates are issued, the [Operation][]s associated with the
+            # stale updates will not be marked as [done][Operation.done] until being
+            # obsolete.
             #
             # This feature is only available for users who have Retail Search enabled.
             # Please enable Retail Search on Cloud Console before using this feature.
@@ -117,8 +135,16 @@ module Google
             # enqueued and processed downstream. As a consequence, when a response is
             # returned, the removed place IDs are not immediately manifested in the
             # [Product][google.cloud.retail.v2.Product] queried by
-            # [GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or
-            # [ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
+            # [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct]
+            # or
+            # [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
+            #
+            # The returned [Operation][]s will be obsolete after 1 day, and
+            # [GetOperation][] API will return NOT_FOUND afterwards.
+            #
+            # If conflicting updates are issued, the [Operation][]s associated with the
+            # stale updates will not be marked as [done][Operation.done] until being
+            # obsolete.
             #
             # This feature is only available for users who have Retail Search enabled.
             # Please enable Retail Search on Cloud Console before using this feature.
@@ -133,13 +159,22 @@ module Google
             # and processed downstream. As a consequence, when a response is returned,
             # updates are not immediately manifested in the
             # [Product][google.cloud.retail.v2.Product] queried by
-            # [GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or
-            # [ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
+            # [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct]
+            # or
+            # [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
             #
             # Local inventory information can only be modified using this method.
-            # [CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] and
-            # [UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] has no
-            # effect on local inventories.
+            # [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct]
+            # and
+            # [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct]
+            # has no effect on local inventories.
+            #
+            # The returned [Operation][]s will be obsolete after 1 day, and
+            # [GetOperation][] API will return NOT_FOUND afterwards.
+            #
+            # If conflicting updates are issued, the [Operation][]s associated with the
+            # stale updates will not be marked as [done][Operation.done] until being
+            # obsolete.
             #
             # This feature is only available for users who have Retail Search enabled.
             # Please enable Retail Search on Cloud Console before using this feature.
@@ -152,13 +187,22 @@ module Google
             # enqueued and processed downstream. As a consequence, when a response is
             # returned, removals are not immediately manifested in the
             # [Product][google.cloud.retail.v2.Product] queried by
-            # [GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or
-            # [ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
+            # [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct]
+            # or
+            # [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
             #
             # Local inventory information can only be removed using this method.
-            # [CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] and
-            # [UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] has no
-            # effect on local inventories.
+            # [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct]
+            # and
+            # [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct]
+            # has no effect on local inventories.
+            #
+            # The returned [Operation][]s will be obsolete after 1 day, and
+            # [GetOperation][] API will return NOT_FOUND afterwards.
+            #
+            # If conflicting updates are issued, the [Operation][]s associated with the
+            # stale updates will not be marked as [done][Operation.done] until being
+            # obsolete.
             #
             # This feature is only available for users who have Retail Search enabled.
             # Please enable Retail Search on Cloud Console before using this feature.

data/lib/google/cloud/retail/v2/search_service/client.rb

@@ -174,7 +174,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param placement [::String]
-            #     Required. The resource name of the search engine placement, such as
+            #     Required. The resource name of the Retail Search serving config, such as
+            #     `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.
@@ -272,7 +274,9 @@ module Google
             #     Boost specification to boost certain products. See more details at this
             #     [user guide](https://cloud.google.com/retail/docs/boosting).
             #
-            #     Notice that if both [ServingConfig.boost_control_ids][] and
+            #     Notice that if both
+            #     {::Google::Cloud::Retail::V2::ServingConfig#boost_control_ids ServingConfig.boost_control_ids}
+            #     and
             #     {::Google::Cloud::Retail::V2::SearchRequest#boost_spec SearchRequest.boost_spec}
             #     are set, the boost conditions from both places are evaluated. If a search
             #     request matches multiple boost conditions, the final boost score is equal
@@ -370,6 +374,15 @@ module Google
             #     request triggers both product search and faceted search.
             #   @param personalization_spec [::Google::Cloud::Retail::V2::SearchRequest::PersonalizationSpec, ::Hash]
             #     The specification for personalization.
+            #
+            #     Notice that if both
+            #     {::Google::Cloud::Retail::V2::ServingConfig#personalization_spec ServingConfig.personalization_spec}
+            #     and
+            #     {::Google::Cloud::Retail::V2::SearchRequest#personalization_spec SearchRequest.personalization_spec}
+            #     are set.
+            #     {::Google::Cloud::Retail::V2::SearchRequest#personalization_spec SearchRequest.personalization_spec}
+            #     will override
+            #     {::Google::Cloud::Retail::V2::ServingConfig#personalization_spec ServingConfig.personalization_spec}.
             #   @param labels [::Hash{::String => ::String}]
             #     The labels applied to a resource must meet the following requirements:
             #

data/lib/google/cloud/retail/v2/search_service_pb.rb

@@ -49,8 +49,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :restricted_values, :string, 3
       repeated :prefixes, :string, 8
       repeated :contains, :string, 9
+      optional :case_insensitive, :bool, 10
       optional :order_by, :string, 4
       optional :query, :string, 5
+      optional :return_min_max, :bool, 11
     end
     add_message "google.cloud.retail.v2.SearchRequest.DynamicFacetSpec" do
       optional :mode, :enum, 1, "google.cloud.retail.v2.SearchRequest.DynamicFacetSpec.Mode"
@@ -116,6 +118,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :matching_variant_count, :int32, 3
       map :matching_variant_fields, :string, :message, 4, "google.protobuf.FieldMask"
       map :variant_rollup_values, :string, :message, 5, "google.protobuf.Value"
+      repeated :personal_labels, :string, 7
     end
     add_message "google.cloud.retail.v2.SearchResponse.Facet" do
       optional :key, :string, 1
@@ -124,6 +127,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.retail.v2.SearchResponse.Facet.FacetValue" do
       optional :count, :int64, 3
+      optional :min_value, :double, 5
+      optional :max_value, :double, 6
       oneof :facet_value do
         optional :value, :string, 1
         optional :interval, :message, 2, "google.cloud.retail.v2.Interval"

data/lib/google/cloud/retail/v2/serving_config_pb.rb

@@ -0,0 +1,44 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/retail/v2/serving_config.proto
+
+require 'google/protobuf'
+
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
+require 'google/cloud/retail/v2/common_pb'
+require 'google/cloud/retail/v2/search_service_pb'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/retail/v2/serving_config.proto", :syntax => :proto3) do
+    add_message "google.cloud.retail.v2.ServingConfig" do
+      optional :name, :string, 1
+      optional :display_name, :string, 2
+      optional :model_id, :string, 3
+      optional :price_reranking_level, :string, 4
+      repeated :facet_control_ids, :string, 5
+      optional :dynamic_facet_spec, :message, 6, "google.cloud.retail.v2.SearchRequest.DynamicFacetSpec"
+      repeated :boost_control_ids, :string, 7
+      repeated :filter_control_ids, :string, 9
+      repeated :redirect_control_ids, :string, 10
+      repeated :twoway_synonyms_control_ids, :string, 18
+      repeated :oneway_synonyms_control_ids, :string, 12
+      repeated :do_not_associate_control_ids, :string, 13
+      repeated :replacement_control_ids, :string, 14
+      repeated :ignore_control_ids, :string, 15
+      optional :diversity_level, :string, 8
+      optional :enable_category_filter_level, :string, 16
+      optional :personalization_spec, :message, 21, "google.cloud.retail.v2.SearchRequest.PersonalizationSpec"
+      repeated :solution_types, :enum, 19, "google.cloud.retail.v2.SolutionType"
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Retail
+      module V2
+        ServingConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ServingConfig").msgclass
+      end
+    end
+  end
+end