google-apis-retail_v2beta 0.31.0 → 0.32.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cfa8d39872d8c1e80a88cc41715eda8d418569db52971e5c43bbf65269e4cbd0
-  data.tar.gz: ce3a9467abde4b9e141412b624d3129fad4b22bca5b4f93021c092e2a504cd69
+  metadata.gz: 7ed1149501b935ac487adefb7ab20b4ba4be842671edb762d772258233a378c4
+  data.tar.gz: 2f01c3e3d04013b3da0dc447536886e67cf5f46edf74c99b28cbe1eaf503ac57
 SHA512:
-  metadata.gz: ac8bb8fd515cb5d87f4db15476315dea3a6f5895dfefef08511cb02e61bdf3d9d47237429b091b3284fca314a5af4454f483687bd86d385edb148d942abbddad
-  data.tar.gz: 4a4cee9019d44b7f902be1d787fd89b46443bb14b2bb7303ef5fb56d753df67023de50b5ece967ecd08b5c42ccdbc1dee6ed395e4c3a37c0a8d104a15c80fbd9
+  metadata.gz: 3e0c7ae8e8663ca53776bc49fbff398103d6d028d77dd3d6c87019fa156991932d879cb1129e2a0f84e3661fc0ee5da94543128000d0169151dbba97a32dd3c4
+  data.tar.gz: baec49c4d331c7eb7f05f20cf5c54cceb382f671720512ef9c49dbce035cc6aeb05409cdae4e956fa0c7403edc14287752f28376d013faa187d725bcc93fa2c5

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-retail_v2beta
 
+### v0.32.0 (2022-03-16)
+
+* Regenerated from discovery document revision 20220310
+
 ### v0.31.0 (2022-03-09)
 
 * Regenerated from discovery document revision 20220303

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

@@ -950,6 +950,74 @@ module Google
         end
       end
       
+      # Metadata related to the progress of the PurgeProducts operation. This will be
+      # returned by the google.longrunning.Operation.metadata field.
+      class GoogleCloudRetailV2alphaPurgeProductsMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Operation create time.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Count of entries that encountered errors while processing.
+        # Corresponds to the JSON property `failureCount`
+        # @return [Fixnum]
+        attr_accessor :failure_count
+      
+        # Count of entries that were deleted successfully.
+        # Corresponds to the JSON property `successCount`
+        # @return [Fixnum]
+        attr_accessor :success_count
+      
+        # Operation last update time. If the operation is done, this is also the finish
+        # time.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @failure_count = args[:failure_count] if args.key?(:failure_count)
+          @success_count = args[:success_count] if args.key?(:success_count)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
+      # Response of the PurgeProductsRequest. If the long running operation is
+      # successfully done, then this message is returned by the google.longrunning.
+      # Operations.response field.
+      class GoogleCloudRetailV2alphaPurgeProductsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The total count of products purged as a result of the operation.
+        # Corresponds to the JSON property `purgeCount`
+        # @return [Fixnum]
+        attr_accessor :purge_count
+      
+        # A sample of the product names that will be deleted. Only populated if `force`
+        # is set to false. A max of 100 names will be returned and the names are chosen
+        # at random.
+        # Corresponds to the JSON property `purgeSample`
+        # @return [Array<String>]
+        attr_accessor :purge_sample
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @purge_count = args[:purge_count] if args.key?(:purge_count)
+          @purge_sample = args[:purge_sample] if args.key?(:purge_sample)
+        end
+      end
+      
       # Response of the PurgeUserEventsRequest. If the long running operation is
       # successfully done, then this message is returned by the google.longrunning.
       # Operations.response field.
@@ -1794,6 +1862,14 @@ 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
@@ -1813,6 +1889,7 @@ 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
@@ -2080,7 +2157,10 @@ module Google
         end
       end
       
-      # Product thumbnail/detail image.
+      # Product image. Recommendations AI and Retail Search do not use product images
+      # to improve prediction and search results. However, product images can be
+      # returned in results, and are shown in prediction or search previews in the
+      # console.
       class GoogleCloudRetailV2betaImage
         include Google::Apis::Core::Hashable
       
@@ -2542,9 +2622,11 @@ module Google
         # do not have a stockState value of OUT_OF_STOCK. Examples: * tag=("Red" OR "
         # Blue") tag="New-Arrival" tag=(NOT "promotional") * filterOutOfStockItems tag=(-
         # "promotional") * filterOutOfStockItems If your filter blocks all prediction
-        # results, nothing will be returned. If you want generic (unfiltered) popular
-        # products to be returned instead, set `strictFiltering` to false in `
-        # PredictRequest.params`.
+        # results, the API will return generic (unfiltered) popular products. If you
+        # only want results strictly matching the filters, set `strictFiltering` to True
+        # in `PredictRequest.params` to receive empty results instead. Note that the API
+        # will never return items with storageStatus of "EXPIRED" or "DELETED"
+        # regardless of filter choices.
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
@@ -2951,7 +3033,7 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Product images for the product.Highly recommended to put the main image to the
+        # Product images for the product. We highly recommend putting the main image
         # first. A maximum of 300 images are allowed. Corresponding properties: Google
         # Merchant Center property [image_link](https://support.google.com/merchants/
         # answer/6324350). Schema.org property [Product.image](https://schema.org/image).
@@ -4019,12 +4101,13 @@ module Google
         # @return [String]
         attr_accessor :branch
       
-        # The filter applied to every search request when quality improvement such as
-        # query expansion is needed. For example, if a query does not have enough
-        # results, an expanded query with SearchRequest.canonical_filter will be
-        # returned as a supplement of the original query. This field is strongly
-        # recommended to achieve high search quality. See SearchRequest.filter for more
-        # details about filter syntax.
+        # The default filter that is applied when a user performs a search without
+        # checking any filters on the search page. The filter applied to every search
+        # request when quality improvement such as query expansion is needed. For
+        # example, if a query does not have enough results, an expanded query with
+        # SearchRequest.canonical_filter will be returned as a supplement of the
+        # original query. This field is strongly recommended to achieve high search
+        # quality. See SearchRequest.filter for more details about filter syntax.
         # Corresponds to the JSON property `canonicalFilter`
         # @return [String]
         attr_accessor :canonical_filter
@@ -5014,15 +5097,21 @@ module Google
       class GoogleCloudRetailV2betaUserEvent
         include Google::Apis::Core::Hashable
       
-        # Extra user event features to include in the recommendation model. This field
-        # needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is
-        # returned: * The key must be a UTF-8 encoded string with a length limit of 5,
-        # 000 characters. * For text attributes, at most 400 values are allowed. Empty
-        # values are not allowed. Each value must be a UTF-8 encoded string with a
-        # length limit of 256 characters. * For number attributes, at most 400 values
-        # are allowed. For product recommendation, an example of extra user information
-        # is traffic_channel, i.e. how user arrives at the site. Users can arrive at the
-        # site by coming to the site directly, or coming through Google search, and etc.
+        # Extra user event features to include in the recommendation model. If you
+        # provide custom attributes for ingested user events, also include them in the
+        # user events that you associate with prediction requests. Custom attribute
+        # formatting must be consistent between imported events and events provided with
+        # prediction requests. This lets the Retail API use those custom attributes when
+        # training models and serving predictions, which helps improve recommendation
+        # quality. This field needs to pass all below criteria, otherwise an
+        # INVALID_ARGUMENT error is returned: * The key must be a UTF-8 encoded string
+        # with a length limit of 5,000 characters. * For text attributes, at most 400
+        # values are allowed. Empty values are not allowed. Each value must be a UTF-8
+        # encoded string with a length limit of 256 characters. * For number attributes,
+        # at most 400 values are allowed. For product recommendations, an example of
+        # extra user information is traffic_channel, which is how a user arrives at the
+        # site. Users can arrive at the site by coming to the site directly, coming
+        # through Google search, or in other ways.
         # Corresponds to the JSON property `attributes`
         # @return [Hash<String,Google::Apis::RetailV2beta::GoogleCloudRetailV2betaCustomAttribute>]
         attr_accessor :attributes

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.31.0"
+      GEM_VERSION = "0.32.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 = "20220303"
+      REVISION = "20220310"
     end
   end
 end

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

@@ -244,6 +244,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2alphaPurgeProductsMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2alphaPurgeProductsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2alphaPurgeUserEventsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1230,6 +1242,24 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2alphaPurgeProductsMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          property :failure_count, :numeric_string => true, as: 'failureCount'
+          property :success_count, :numeric_string => true, as: 'successCount'
+          property :update_time, as: 'updateTime'
+        end
+      end
+      
+      class GoogleCloudRetailV2alphaPurgeProductsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :purge_count, :numeric_string => true, as: 'purgeCount'
+          collection :purge_sample, as: 'purgeSample'
+        end
+      end
+      
       class GoogleCloudRetailV2alphaPurgeUserEventsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1472,6 +1502,7 @@ 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

@@ -86,12 +86,12 @@ module Google
         #   Required. The query used to generate suggestions. The maximum number of
         #   allowed characters is 255.
         # @param [String] visitor_id
-        #   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 logs in or 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.
+        #   Required field. 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 logs in or 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.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1671,13 +1671,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Triggers a user event rejoin operation with latest product catalog. Events
-        # will not be annotated with detailed product information if product is missing
-        # from the catalog at the time the user event is ingested, and these events are
+        # Starts a user event rejoin operation with latest product catalog. Events will
+        # not be annotated with detailed product information if product is missing from
+        # the catalog at the time the user event is ingested, and these events are
         # stored as unjoined events with a limited usage on training and serving. This
-        # API can be used to trigger a 'join' operation on specified events with latest
+        # method can be used to start a join operation on specified events with latest
         # version of product catalog. It can also be used to correct events joined with
-        # wrong product catalog.
+        # the wrong product catalog. A rejoin operation can take hours or days to
+        # complete.
         # @param [String] parent
         #   Required. The parent catalog resource name, such as `projects/1234/locations/
         #   global/catalogs/default_catalog`.

metadata

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