google-apis-retail_v2alpha 0.28.0 → 0.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 76e246cd8a76032a007f6eae66840c78d385787195cc9b522ba38db20c559d59
-  data.tar.gz: 430bed9ceefac161115db657682d1d0bb359121e63fe8156e93ae4865a8244e0
+  metadata.gz: 9807fdb6e6e39b68732e89fa390a54990ef198eb40ad7d414fdb91425377bcf2
+  data.tar.gz: 13e2c7f0e8447c7f24c783145cee04b7a14dda9f2435ed1138bf8d95fc548cb4
 SHA512:
-  metadata.gz: 84cacc133295d72d41740379566a4d74a39d9eb5f36baaf38058a0f28919cce5ddaa2f5116a3dde3442c171187fd7a242018b1867b91ba0dc208896cb9f3687b
-  data.tar.gz: a83c839cb2ecc797f0ef02962ead1e8934d9e45df378477695a4d3975d0ce4337cc323284b6dac46828b7445140a24dfd48a99d928a03bb8ee68329fd21c87ff
+  metadata.gz: c54e46a8009c145aa3682a772110497b082bc1bd67e50262ef4800db708020eb44569956896320497442e8896a76c7d2d0c30c4f19410014fc98907c8b5a6126
+  data.tar.gz: 1f4210851ac96d3123ebabc4900c1d06d43753f0e69873b3153d9067ed14ff183f8c0df6f7fd77ae868cdf19c4e1939d02e9a611ef91e527db0acc291c5d3d8a

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-retail_v2alpha
 
+### v0.29.0 (2022-02-12)
+
+* Regenerated from discovery document revision 20220210
+
 ### v0.28.0 (2022-02-03)
 
 * Regenerated from discovery document revision 20220127

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

@@ -851,7 +851,11 @@ module Google
         # Importing catalog data from Merchant Center](https://cloud.google.com/retail/
         # recommendations-ai/docs/upload-catalog#mc). Supported values for user events
         # imports: * `user_event` (default): One JSON UserEvent per line. * `
-        # user_event_ga360`: Using https://support.google.com/analytics/answer/3437719.
+        # user_event_ga360`: The schema is available here: https://support.google.com/
+        # analytics/answer/3437719. * `user_event_ga4`: This feature is in private
+        # preview. Please contact the support team for importing Google Analytics 4
+        # events. The schema is available here: https://support.google.com/analytics/
+        # answer/7029846.
         # Corresponds to the JSON property `dataSchema`
         # @return [String]
         attr_accessor :data_schema
@@ -873,10 +877,10 @@ module Google
         # day and time zone are either specified elsewhere or are insignificant. The
         # date is relative to the Gregorian Calendar. This can represent one of the
         # following: * A full date, with non-zero year, month, and day values * A month
-        # and day value, with a zero year, such as an anniversary * A year on its own,
-        # with zero month and day values * A year and month value, with a zero day, such
-        # as a credit card expiration date Related types are google.type.TimeOfDay and `
-        # google.protobuf.Timestamp`.
+        # and day, with a zero year (e.g., an anniversary) * A year on its own, with a
+        # zero month and a zero day * A year and month, with a zero day (e.g., a credit
+        # card expiration date) Related types: * google.type.TimeOfDay * google.type.
+        # DateTime * google.protobuf.Timestamp
         # Corresponds to the JSON property `partitionDate`
         # @return [Google::Apis::RetailV2alpha::GoogleTypeDate]
         attr_accessor :partition_date
@@ -1279,10 +1283,12 @@ module Google
       class GoogleCloudRetailV2alphaCustomAttribute
         include Google::Apis::Core::Hashable
       
-        # If true, custom attribute values are indexed, so that it can be filtered,
-        # faceted or boosted in SearchService.Search. This field is ignored in a
-        # UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and
-        # SearchRequest.boost_spec for more details.
+        # This field will only be used when AttributesConfig.attribute_config_level of
+        # the Catalog is 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG', if true, custom attribute
+        # values are indexed, so that it can be filtered, faceted or boosted in
+        # SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.
+        # filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more
+        # details.
         # Corresponds to the JSON property `indexable`
         # @return [Boolean]
         attr_accessor :indexable
@@ -1295,9 +1301,11 @@ module Google
         # @return [Array<Float>]
         attr_accessor :numbers
       
-        # If true, custom attribute values are searchable by text queries in
-        # SearchService.Search. This field is ignored in a UserEvent. Only set if type
-        # text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+        # This field will only be used when AttributesConfig.attribute_config_level of
+        # the Catalog is 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG', if true, custom attribute
+        # values are searchable by text queries in SearchService.Search. This field is
+        # ignored in a UserEvent. Only set if type text is set. Otherwise, a
+        # INVALID_ARGUMENT error is returned.
         # Corresponds to the JSON property `searchable`
         # @return [Boolean]
         attr_accessor :searchable
@@ -2053,9 +2061,9 @@ module Google
         attr_accessor :destinations
       
         # Language of the title/description and other string attributes. Use language
-        # tags defined by BCP 47. ISO 639-1. This specifies the language of offers in
-        # Merchant Center that will be accepted. If empty no language filtering will be
-        # performed.
+        # tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). ISO
+        # 639-1. This specifies the language of offers in Merchant Center that will be
+        # accepted. If empty no language filtering will be performed.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -2068,9 +2076,9 @@ module Google
         attr_accessor :merchant_center_account_id
       
         # Region code of offers to accept. 2-letter Uppercase ISO 3166-1 alpha-2 code.
-        # List of values can be found here under the `region` tag. [https://www.iana.org/
-        # assignments/language-subtag-registry/language-subtag-registry]. If left blank
-        # no region filtering will be performed. Ex. `US`.
+        # List of values can be found [here](https://www.iana.org/assignments/language-
+        # subtag-registry/language-subtag-registry) under the `region` tag. If left
+        # blank no region filtering will be performed. Example value: `US`.
         # Corresponds to the JSON property `regionCode`
         # @return [String]
         attr_accessor :region_code
@@ -2555,7 +2563,7 @@ module Google
       
         # The material of the product. For example, "leather", "wooden". A maximum of 20
         # values are allowed. Each value must be a UTF-8 encoded string with a length
-        # limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.
+        # limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned.
         # Corresponding properties: Google Merchant Center property [material](https://
         # support.google.com/merchants/answer/6324410). Schema.org property [Product.
         # material](https://schema.org/material).
@@ -3810,6 +3818,14 @@ module Google
         # @return [Array<Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestBoostSpecConditionBoostSpec>]
         attr_accessor :condition_boost_specs
       
+        # Whether to skip boostspec validation. If this field is set to true, invalid
+        # BoostSpec.condition_boost_specs will be ignored and valid BoostSpec.
+        # condition_boost_specs will still be applied.
+        # Corresponds to the JSON property `skipBoostSpecValidation`
+        # @return [Boolean]
+        attr_accessor :skip_boost_spec_validation
+        alias_method :skip_boost_spec_validation?, :skip_boost_spec_validation
+      
         def initialize(**args)
            update!(**args)
         end
@@ -3817,6 +3833,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @condition_boost_specs = args[:condition_boost_specs] if args.key?(:condition_boost_specs)
+          @skip_boost_spec_validation = args[:skip_boost_spec_validation] if args.key?(:skip_boost_spec_validation)
         end
       end
       
@@ -4114,6 +4131,12 @@ module Google
         # @return [Array<Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchResponseFacet>]
         attr_accessor :facets
       
+        # The invalid SearchRequest.BoostSpec.condition_boost_specs that are not applied
+        # during serving.
+        # Corresponds to the JSON property `invalidConditionBoostSpecs`
+        # @return [Array<Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestBoostSpecConditionBoostSpec>]
+        attr_accessor :invalid_condition_boost_specs
+      
         # A token that can be sent as SearchRequest.page_token to retrieve the next page.
         # If this field is omitted, there are no subsequent pages.
         # Corresponds to the JSON property `nextPageToken`
@@ -4155,6 +4178,7 @@ module Google
           @attribution_token = args[:attribution_token] if args.key?(:attribution_token)
           @corrected_query = args[:corrected_query] if args.key?(:corrected_query)
           @facets = args[:facets] if args.key?(:facets)
+          @invalid_condition_boost_specs = args[:invalid_condition_boost_specs] if args.key?(:invalid_condition_boost_specs)
           @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
           @query_expansion_info = args[:query_expansion_info] if args.key?(:query_expansion_info)
           @redirect_uri = args[:redirect_uri] if args.key?(:redirect_uri)
@@ -5535,10 +5559,10 @@ module Google
       # day and time zone are either specified elsewhere or are insignificant. The
       # date is relative to the Gregorian Calendar. This can represent one of the
       # following: * A full date, with non-zero year, month, and day values * A month
-      # and day value, with a zero year, such as an anniversary * A year on its own,
-      # with zero month and day values * A year and month value, with a zero day, such
-      # as a credit card expiration date Related types are google.type.TimeOfDay and `
-      # google.protobuf.Timestamp`.
+      # and day, with a zero year (e.g., an anniversary) * A year on its own, with a
+      # zero month and a zero day * A year and month, with a zero day (e.g., a credit
+      # card expiration date) Related types: * google.type.TimeOfDay * google.type.
+      # DateTime * google.protobuf.Timestamp
       class GoogleTypeDate
         include Google::Apis::Core::Hashable
       

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.28.0"
+      GEM_VERSION = "0.29.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 = "20220127"
+      REVISION = "20220210"
     end
   end
 end

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

@@ -1914,6 +1914,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           collection :condition_boost_specs, as: 'conditionBoostSpecs', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestBoostSpecConditionBoostSpec, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestBoostSpecConditionBoostSpec::Representation
       
+          property :skip_boost_spec_validation, as: 'skipBoostSpecValidation'
         end
       end
       
@@ -1980,6 +1981,8 @@ module Google
           property :corrected_query, as: 'correctedQuery'
           collection :facets, as: 'facets', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchResponseFacet, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchResponseFacet::Representation
       
+          collection :invalid_condition_boost_specs, as: 'invalidConditionBoostSpecs', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestBoostSpecConditionBoostSpec, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestBoostSpecConditionBoostSpec::Representation
+      
           property :next_page_token, as: 'nextPageToken'
           property :query_expansion_info, as: 'queryExpansionInfo', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchResponseQueryExpansionInfo, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchResponseQueryExpansionInfo::Representation
       

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

@@ -124,10 +124,7 @@ module Google
         end
         
         # Get which branch is currently default branch set by CatalogService.
-        # SetDefaultBranch method under a specified parent catalog. This feature is only
-        # available for users who have Retail Search enabled. Please submit a form [here]
-        # (https://cloud.google.com/contact) to contact cloud sales if you are
-        # interested in using Retail Search.
+        # SetDefaultBranch method under a specified parent catalog.
         # @param [String] catalog
         #   The parent catalog resource name, such as `projects/*/locations/global/
         #   catalogs/default_catalog`.
@@ -256,9 +253,7 @@ module Google
         # PredictionService will only return product IDs from branch `newBranch`. *
         # SearchService will only return product IDs from branch `newBranch` (if branch
         # is not explicitly set). * UserEventService will only join events with products
-        # from branch `newBranch`. This feature is only available for users who have
-        # Retail Search enabled. Please submit a form [here](https://cloud.google.com/
-        # contact) to contact cloud sales if you are interested in using Retail Search.
+        # from branch `newBranch`.
         # @param [String] catalog
         #   Full resource name of the catalog, such as `projects/*/locations/global/
         #   catalogs/default_catalog`.
@@ -1737,6 +1732,83 @@ module Google
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
+        
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
+        # @param [String] name
+        #   The name of the operation resource.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::RetailV2alpha::GoogleLongrunningOperation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RetailV2alpha::GoogleLongrunningOperation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project_operation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2alpha/{+name}', options)
+          command.response_representation = Google::Apis::RetailV2alpha::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::RetailV2alpha::GoogleLongrunningOperation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists operations that match the specified filter in the request. If the server
+        # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
+        # binding allows API services to override the binding to use different resource
+        # name schemes, such as `users/*/operations`. To override the binding, API
+        # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
+        # service configuration. For backwards compatibility, the default name includes
+        # the operations collection id, however overriding users must ensure the name
+        # binding is the parent resource, without the operations collection id.
+        # @param [String] name
+        #   The name of the operation's parent resource.
+        # @param [String] filter
+        #   The standard list filter.
+        # @param [Fixnum] page_size
+        #   The standard list page size.
+        # @param [String] page_token
+        #   The standard list page token.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::RetailV2alpha::GoogleLongrunningListOperationsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RetailV2alpha::GoogleLongrunningListOperationsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_project_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2alpha/{+name}/operations', options)
+          command.response_representation = Google::Apis::RetailV2alpha::GoogleLongrunningListOperationsResponse::Representation
+          command.response_class = Google::Apis::RetailV2alpha::GoogleLongrunningListOperationsResponse
+          command.params['name'] = name unless name.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
 
         protected
 

metadata

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