google-apis-retail_v2alpha 0.36.0 → 0.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fded543728d24f668d94eab627257d7b2b4b35bfa5040463ebe7b947814cc445
-  data.tar.gz: 398dab6a6d9156d5744f23b56fc5b4f8df10f80e8ddb9e85b92936a9fb1c55d5
+  metadata.gz: fc97dcae81e3de777b4b63166b309e307df06890111fa84dab2ec3578069b5fa
+  data.tar.gz: cea589c40ae8f3cb627e34316c25912ea01dc7a554bdc1f5aa4ff7922f584e4c
 SHA512:
-  metadata.gz: 0b5d043eb964f4b1f4a420c0637f14a3e8e4c67f1fee378fc5789d5767ae440f86ce130c760a7df96635e26f6fd8064df8990a97d3dc8217f1bcf296e91a6b14
-  data.tar.gz: a2ccb8df5765151de59180404029c918fafb267dadadc647aa12a1344dee448a1fb966c9178a94a79285763e999177cbe614d9c70d48de78be6419d78541ebd3
+  metadata.gz: 2f676dea871f7d524f472fcc09b0fd07e66b904093186222d0d062e02e62c166bbc51bb57c65b4b177d5fd6b3efe14fa5776b5c72a4ce790ef6700472a11ef3b
+  data.tar.gz: bf53d423e21173419dc47fe59f1f0eba340af03d6fec9a94f3f47c84b31d9172277edc728dffcb887a00ec97dedd74f6730c8085767ee84e438d6ed0a459efda

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Release history for google-apis-retail_v2alpha
 
+### v0.39.0 (2022-05-05)
+
+* Regenerated from discovery document revision 20220430
+
+### v0.38.0 (2022-04-28)
+
+* Regenerated from discovery document revision 20220421
+
+### v0.37.0 (2022-04-22)
+
+* Regenerated from discovery document revision 20220414
+
 ### v0.36.0 (2022-04-14)
 
 * Regenerated from discovery document revision 20220408

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

@@ -1567,12 +1567,13 @@ module Google
       class GoogleCloudRetailV2alphaCustomAttribute
         include Google::Apis::Core::Hashable
       
-        # 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.
+        # This field is normally ignored unless AttributesConfig.attribute_config_level
+        # of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode.
+        # You may learn more on [configuration mode] (https://cloud.google.com/retail/
+        # docs/attribute-config#config-modes). 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
@@ -1585,11 +1586,13 @@ module Google
         # @return [Array<Float>]
         attr_accessor :numbers
       
-        # 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.
+        # This field is normally ignored unless AttributesConfig.attribute_config_level
+        # of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode.
+        # You may learn more on [configuration mode] (https://cloud.google.com/retail/
+        # docs/attribute-config#config-modes). 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
@@ -2004,11 +2007,15 @@ module Google
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaProductInputConfig]
         attr_accessor :input_config
       
-        # Pub/Sub topic for receiving notification. If this field is set, when the
-        # import is finished, a notification will be sent to specified Pub/Sub topic.
+        # Full Pub/Sub topic name for receiving notification. If this field is set, when
+        # the import is finished, a notification will be sent to specified Pub/Sub topic.
         # The message data will be JSON string of a Operation. Format of the Pub/Sub
-        # topic is `projects/`project`/topics/`topic``. Only supported when
-        # ImportProductsRequest.reconciliation_mode is set to `FULL`.
+        # topic is `projects/`project`/topics/`topic``. It has to be within the same
+        # project as ImportProductsRequest.parent. Make sure that both `cloud-retail-
+        # customer-data-access@system.gserviceaccount.com` and `service-@gcp-sa-retail.
+        # iam.gserviceaccount.com` have the `pubsub.topics.publish` IAM permission on
+        # the topic. Only supported when ImportProductsRequest.reconciliation_mode is
+        # set to `FULL`.
         # Corresponds to the JSON property `notificationPubsubTopic`
         # @return [String]
         attr_accessor :notification_pubsub_topic
@@ -2024,6 +2031,15 @@ module Google
         # @return [String]
         attr_accessor :request_id
       
+        # If true, will perform the FULL import even if it would delete a large
+        # proportion of the products in the default branch, which could potentially
+        # cause outages if you have live predict/search traffic. Only supported when
+        # ImportProductsRequest.reconciliation_mode is set to `FULL`.
+        # Corresponds to the JSON property `skipDefaultBranchProtection`
+        # @return [Boolean]
+        attr_accessor :skip_default_branch_protection
+        alias_method :skip_default_branch_protection?, :skip_default_branch_protection
+      
         # Indicates which fields in the provided imported 'products' to update. If not
         # set, will by default update all fields.
         # Corresponds to the JSON property `updateMask`
@@ -2041,6 +2057,7 @@ module Google
           @notification_pubsub_topic = args[:notification_pubsub_topic] if args.key?(:notification_pubsub_topic)
           @reconciliation_mode = args[:reconciliation_mode] if args.key?(:reconciliation_mode)
           @request_id = args[:request_id] if args.key?(:request_id)
+          @skip_default_branch_protection = args[:skip_default_branch_protection] if args.key?(:skip_default_branch_protection)
           @update_mask = args[:update_mask] if args.key?(:update_mask)
         end
       end
@@ -2609,7 +2626,8 @@ module Google
         attr_accessor :currency_code
       
         # Price of the product without any discount. If zero, by default set to be the
-        # price.
+        # price. If set, original_price should be greater than or equal to price,
+        # otherwise an INVALID_ARGUMENT error is thrown.
         # Corresponds to the JSON property `originalPrice`
         # @return [Float]
         attr_accessor :original_price
@@ -4117,6 +4135,21 @@ module Google
         # @return [String]
         attr_accessor :filter
       
+        # The labels applied to a resource must meet the following requirements: * Each
+        # resource can have multiple labels, up to a maximum of 64. * Each label must be
+        # a key-value pair. * Keys have a minimum length of 1 character and a maximum
+        # length of 63 characters, and cannot be empty. Values can be empty, and have a
+        # maximum length of 63 characters. * Keys and values can contain only lowercase
+        # letters, numeric characters, underscores, and dashes. All characters must use
+        # UTF-8 encoding, and international characters are allowed. * The key portion of
+        # a label must be unique. However, you can use the same key with multiple
+        # resources. * Keys must start with a lowercase letter or international
+        # character. See [Google Cloud Document](https://cloud.google.com/resource-
+        # manager/docs/creating-managing-labels#requirements) for more details.
+        # Corresponds to the JSON property `labels`
+        # @return [Hash<String,String>]
+        attr_accessor :labels
+      
         # A 0-indexed integer that specifies the current offset (that is, starting
         # result location, amongst the Products deemed by the API as relevant) in search
         # results. This field is only considered if page_token is unset. If this field
@@ -4248,6 +4281,7 @@ module Google
           @dynamic_facet_spec = args[:dynamic_facet_spec] if args.key?(:dynamic_facet_spec)
           @facet_specs = args[:facet_specs] if args.key?(:facet_specs)
           @filter = args[:filter] if args.key?(:filter)
+          @labels = args[:labels] if args.key?(:labels)
           @offset = args[:offset] if args.key?(:offset)
           @order_by = args[:order_by] if args.key?(:order_by)
           @page_categories = args[:page_categories] if args.key?(:page_categories)
@@ -4578,7 +4612,9 @@ module Google
         # @return [String]
         attr_accessor :attribution_token
       
-        # If spell correction applies, the corrected query. Otherwise, empty.
+        # Contains the spell corrected query, if found. If the spell correction type is
+        # AUTOMATIC, then the search results will be based on corrected_query, otherwise
+        # the original query will be used for search.
         # Corresponds to the JSON property `correctedQuery`
         # @return [String]
         attr_accessor :corrected_query
@@ -5216,9 +5252,9 @@ module Google
         # @return [String]
         attr_accessor :page_view_id
       
-        # The main product details related to the event. This field is required for the
-        # following event types: * `add-to-cart` * `detail-page-view` * `purchase-
-        # complete` * `search` In a `search` event, this field represents the products
+        # The main product details related to the event. This field is optional except
+        # for the following event types: * `add-to-cart` * `detail-page-view` * `
+        # purchase-complete` In a `search` event, this field represents the products
         # returned to the end user on the current page (the end user may have not
         # finished browsing the whole page yet). When a new page is returned to the end
         # user, after pagination/filtering/ordering even for the same query, a new `

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.36.0"
+      GEM_VERSION = "0.39.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 = "20220408"
+      REVISION = "20220430"
     end
   end
 end

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

@@ -1594,6 +1594,7 @@ module Google
           property :notification_pubsub_topic, as: 'notificationPubsubTopic'
           property :reconciliation_mode, as: 'reconciliationMode'
           property :request_id, as: 'requestId'
+          property :skip_default_branch_protection, as: 'skipDefaultBranchProtection'
           property :update_mask, as: 'updateMask'
         end
       end
@@ -2109,6 +2110,7 @@ module Google
           collection :facet_specs, as: 'facetSpecs', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestFacetSpec, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestFacetSpec::Representation
       
           property :filter, as: 'filter'
+          hash :labels, as: 'labels'
           property :offset, as: 'offset'
           property :order_by, as: 'orderBy'
           collection :page_categories, as: 'pageCategories'

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

@@ -62,8 +62,9 @@ module Google
         #   the imported dataset through CompletionService.ImportCompletionData. "cloud-
         #   retail" will use the dataset generated by cloud retail based on user events.
         #   If leave empty, it will use the "user-data". Current supported values: * user-
-        #   data * cloud-retail This option requires additional allowlisting. Before using
-        #   cloud-retail, contact Cloud Retail support team first.
+        #   data * cloud-retail: This option requires enabling auto-learning function
+        #   first. See [guidelines](https://cloud.google.com/retail/docs/completion-
+        #   overview#generated-completion-dataset).
         # @param [String] device_type
         #   The device type context for completion suggestions. It is useful to apply
         #   different suggestions on different device types, e.g. `DESKTOP`, `MOBILE`. If
@@ -1419,15 +1420,12 @@ module Google
         # Makes a recommendation prediction.
         # @param [String] placement
         #   Required. Full resource name of the format: `name=projects/*/locations/global/
-        #   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
+        #   catalogs/default_catalog/placements/*` 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
         # @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.
@@ -1462,12 +1460,10 @@ module Google
         # Search enabled. Please enable Retail Search on Cloud Console before using this
         # feature.
         # @param [String] placement
-        #   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.
+        #   Required. The resource name of the search engine placement, 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.
@@ -1722,48 +1718,6 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Makes a recommendation prediction.
-        # @param [String] placement
-        #   Required. Full resource name of the format: `name=projects/*/locations/global/
-        #   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.
-        # @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::GoogleCloudRetailV2alphaPredictResponse] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaPredictResponse]
-        #
-        # @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 predict_project_location_catalog_serving_config(placement, google_cloud_retail_v2alpha_predict_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2alpha/{+placement}:predict', options)
-          command.request_representation = Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaPredictRequest::Representation
-          command.request_object = google_cloud_retail_v2alpha_predict_request_object
-          command.response_representation = Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaPredictResponse::Representation
-          command.response_class = Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaPredictResponse
-          command.params['placement'] = placement unless placement.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
         # Disables a Control on the specified ServingConfig. The control is removed from
         # the ServingConfig. Returns a NOT_FOUND error if the Control is not enabled for
         # the ServingConfig.
@@ -1801,46 +1755,6 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Performs a search. This feature is only available for users who have Retail
-        # Search enabled. Please enable Retail Search on Cloud Console before using this
-        # feature.
-        # @param [String] placement
-        #   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.
-        # @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.
-        # @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::GoogleCloudRetailV2alphaSearchResponse] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchResponse]
-        #
-        # @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 search_project_location_catalog_serving_configs(placement, google_cloud_retail_v2alpha_search_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2alpha/{+placement}:search', options)
-          command.request_representation = Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequest::Representation
-          command.request_object = google_cloud_retail_v2alpha_search_request_object
-          command.response_representation = Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchResponse::Representation
-          command.response_class = Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchResponse
-          command.params['placement'] = placement unless placement.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
         # Writes a single user event from the browser. This uses a GET request to due to
         # browser restriction of POST-ing to a 3rd party domain. This method is used
         # only by the Retail API JavaScript pixel and Google Tag Manager. Users should

metadata

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