google-apis-retail_v2alpha 0.50.0 → 0.53.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d890c1a65e53a027afcd59800f3d47e4e6f818ca8dede7f80961898a042b4a23
-  data.tar.gz: e8f78f4aae8cb0f748030884adabdff2ada82bfbfa145733481925c417dc05ec
+  metadata.gz: 21b93df1e143e62ad68aaf507f3bd12656e2a5db1f4cc5a9fda9ee3e03cc2bb7
+  data.tar.gz: 809c137f35f36feae0a9e988caa7518399a4aa5bfe9009dab87c78a1a6babdb4
 SHA512:
-  metadata.gz: 771439e5fb82eed062625e28f92ecfc434ef8098a9f2d4605b6dfc4ced62a9a22375079195dee54dacdb7aa04d75de17f9e48b50bbe5a1edeca063fe00a48029
-  data.tar.gz: aee7cf4032cc22d6adf63b4feb85cd1af4336143b1a68e630342908e760d4f0b04f929c489a6d7b35a2295290d73e9b7756075b60f67960bf26f06761d338332
+  metadata.gz: d513e46213cdc51515262aaf664e9319d97ad4cdd49fb3afd517572138f2559a6428c2e2eb13ca1b6d9b12a88fbf1037d0df81264d5005a1b22c6f8c5998d476
+  data.tar.gz: 5ae30acff83cfd78f4b6eb545e75ae0867c50e08db663dffa294a7da0c5e46aa4342427a47cdc07aee12ab1680bf0a7770abaa8678362d4f11a39c39670fb2b0

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Release history for google-apis-retail_v2alpha
 
+### v0.53.0 (2022-08-21)
+
+* Unspecified changes
+
+### v0.52.0 (2022-08-12)
+
+* Regenerated from discovery document revision 20220811
+
+### v0.51.0 (2022-08-03)
+
+* Regenerated from discovery document revision 20220729
+
 ### v0.50.0 (2022-07-26)
 
 * Regenerated from discovery document revision 20220722

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

@@ -365,8 +365,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Google Cloud Storage prefix for import errors. This must be an empty, existing
-        # Cloud Storage directory. Import errors will be written to sharded files in
-        # this directory, one per line, as a JSON-encoded `google.rpc.Status` message.
+        # Cloud Storage directory. Import errors are written to sharded files in this
+        # directory, one per line, as a JSON-encoded `google.rpc.Status` message.
         # Corresponds to the JSON property `gcsPrefix`
         # @return [String]
         attr_accessor :gcs_prefix
@@ -381,8 +381,8 @@ module Google
         end
       end
       
-      # Metadata related to the progress of the Import operation. This will be
-      # returned by the google.longrunning.Operation.metadata field.
+      # Metadata related to the progress of the Import operation. This is returned by
+      # the google.longrunning.Operation.metadata field.
       class GoogleCloudRetailV2ImportMetadata
         include Google::Apis::Core::Hashable
       
@@ -397,9 +397,9 @@ module Google
         attr_accessor :failure_count
       
         # 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.
-        # The message data will be JSON string of a Operation. Format of the Pub/Sub
-        # topic is `projects/`project`/topics/`topic``.
+        # import is finished, a notification is sent to specified Pub/Sub topic. The
+        # message data is JSON string of a Operation. Format of the Pub/Sub topic is `
+        # projects/`project`/topics/`topic``.
         # Corresponds to the JSON property `notificationPubsubTopic`
         # @return [String]
         attr_accessor :notification_pubsub_topic
@@ -960,6 +960,54 @@ module Google
         end
       end
       
+      # Request for CatalogService.BatchRemoveCatalogAttributes method.
+      class GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The attribute name keys of the CatalogAttributes to delete. A
+        # maximum of 1000 catalog attributes can be deleted in a batch.
+        # Corresponds to the JSON property `attributeKeys`
+        # @return [Array<String>]
+        attr_accessor :attribute_keys
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @attribute_keys = args[:attribute_keys] if args.key?(:attribute_keys)
+        end
+      end
+      
+      # Response of the CatalogService.BatchRemoveCatalogAttributes.
+      class GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse
+        include Google::Apis::Core::Hashable
+      
+        # Catalog attributes that were deleted. Only attributes that are not in use by
+        # products can be deleted.
+        # Corresponds to the JSON property `deletedCatalogAttributes`
+        # @return [Array<String>]
+        attr_accessor :deleted_catalog_attributes
+      
+        # Catalog attributes that were reset. Attributes that are in use by products
+        # cannot be deleted, however their configuration properties will reset to
+        # default values upon removal request.
+        # Corresponds to the JSON property `resetCatalogAttributes`
+        # @return [Array<String>]
+        attr_accessor :reset_catalog_attributes
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @deleted_catalog_attributes = args[:deleted_catalog_attributes] if args.key?(:deleted_catalog_attributes)
+          @reset_catalog_attributes = args[:reset_catalog_attributes] if args.key?(:reset_catalog_attributes)
+        end
+      end
+      
       # A BigQuery output result.
       class GoogleCloudRetailV2alphaBigQueryOutputResult
         include Google::Apis::Core::Hashable
@@ -996,12 +1044,11 @@ module Google
         # recommendations-ai/docs/upload-catalog#mc). Supported values for user events
         # imports: * `user_event` (default): One JSON UserEvent per line. * `
         # 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. Supported values for auto-completion imports: * `suggestions` (
-        # default): One JSON completion suggestion per line. * `denylist`: One JSON deny
-        # suggestion per line. * `allowlist`: One JSON allow suggestion per line.
+        # analytics/answer/3437719. * `user_event_ga4`: The schema is available here:
+        # https://support.google.com/analytics/answer/7029846. Supported values for auto-
+        # completion imports: * `suggestions` (default): One JSON completion suggestion
+        # per line. * `denylist`: One JSON deny suggestion per line. * `allowlist`: One
+        # JSON allow suggestion per line.
         # Corresponds to the JSON property `dataSchema`
         # @return [String]
         attr_accessor :data_schema
@@ -1112,6 +1159,13 @@ module Google
         # @return [String]
         attr_accessor :dynamic_facetable_option
       
+        # If EXACT_SEARCHABLE_ENABLED, attribute values will be exact searchable. This
+        # property only applies to textual custom attributes and requires indexable set
+        # to enabled to enable exact-searchable.
+        # Corresponds to the JSON property `exactSearchableOption`
+        # @return [String]
+        attr_accessor :exact_searchable_option
+      
         # Output only. Indicates whether this attribute has been used by any products. `
         # True` if at least one Product is using this attribute in Product.attributes.
         # Otherwise, this field is `False`. CatalogAttribute can be pre-loaded by using
@@ -1173,6 +1227,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @dynamic_facetable_option = args[:dynamic_facetable_option] if args.key?(:dynamic_facetable_option)
+          @exact_searchable_option = args[:exact_searchable_option] if args.key?(:exact_searchable_option)
           @in_use = args[:in_use] if args.key?(:in_use)
           @indexable_option = args[:indexable_option] if args.key?(:indexable_option)
           @key = args[:key] if args.key?(:key)
@@ -1245,7 +1300,7 @@ module Google
         # CompleteQueryRequest.visitor_id field is set and UserEvent is imported. The
         # recent searches satisfy the follow rules: * They are ordered from latest to
         # oldest. * They are matched with CompleteQueryRequest.query case insensitively.
-        # * They are transformed to lower cases. * They are UTF-8 safe. Recent searches
+        # * They are transformed to lower case. * They are UTF-8 safe. Recent searches
         # are deduplicated. More recent searches will be reserved when duplication
         # happens.
         # Corresponds to the JSON property `recentSearchResults`
@@ -1365,16 +1420,16 @@ module Google
         # @return [String]
         attr_accessor :matching_order
       
-        # The maximum number of autocomplete suggestions returned per term. The maximum
-        # allowed max suggestions is 20. Default value is 20. If left unset or set to 0,
-        # then will fallback to default value.
+        # The maximum number of autocomplete suggestions returned per term. Default
+        # value is 20. If left unset or set to 0, then will fallback to default value.
+        # Value range is 1 to 20.
         # Corresponds to the JSON property `maxSuggestions`
         # @return [Fixnum]
         attr_accessor :max_suggestions
       
         # The minimum number of characters needed to be typed in order to get
         # suggestions. Default value is 2. If left unset or set to 0, then will fallback
-        # to default value.
+        # to default value. Value range is 1 to 20.
         # Corresponds to the JSON property `minPrefixLength`
         # @return [Fixnum]
         attr_accessor :min_prefix_length
@@ -1837,7 +1892,7 @@ module Google
         end
       end
       
-      # Google Cloud Storage location for input content. format.
+      # Google Cloud Storage location for input content.
       class GoogleCloudRetailV2alphaGcsSource
         include Google::Apis::Core::Hashable
       
@@ -1848,8 +1903,8 @@ module Google
         # 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.
-        # Supported values for control imports: * 'control' (default): One JSON Control
-        # per line. Supported values for catalog attribute imports: * 'catalog_attribute'
+        # Supported values for control imports: * `control` (default): One JSON Control
+        # per line. Supported values for catalog attribute imports: * `catalog_attribute`
         # (default): One CSV CatalogAttribute per line.
         # Corresponds to the JSON property `dataSchema`
         # @return [String]
@@ -1959,9 +2014,9 @@ module Google
         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.
-        # The message data will be JSON string of a Operation. Format of the Pub/Sub
-        # topic is `projects/`project`/topics/`topic``.
+        # import is finished, a notification is sent to specified Pub/Sub topic. The
+        # message data is JSON string of a Operation. Format of the Pub/Sub topic is `
+        # projects/`project`/topics/`topic``.
         # Corresponds to the JSON property `notificationPubsubTopic`
         # @return [String]
         attr_accessor :notification_pubsub_topic
@@ -2003,8 +2058,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Google Cloud Storage prefix for import errors. This must be an empty, existing
-        # Cloud Storage directory. Import errors will be written to sharded files in
-        # this directory, one per line, as a JSON-encoded `google.rpc.Status` message.
+        # Cloud Storage directory. Import errors are written to sharded files in this
+        # directory, one per line, as a JSON-encoded `google.rpc.Status` message.
         # Corresponds to the JSON property `gcsPrefix`
         # @return [String]
         attr_accessor :gcs_prefix
@@ -2019,8 +2074,8 @@ module Google
         end
       end
       
-      # Metadata related to the progress of the Import operation. This will be
-      # returned by the google.longrunning.Operation.metadata field.
+      # Metadata related to the progress of the Import operation. This is returned by
+      # the google.longrunning.Operation.metadata field.
       class GoogleCloudRetailV2alphaImportMetadata
         include Google::Apis::Core::Hashable
       
@@ -2035,9 +2090,9 @@ module Google
         attr_accessor :failure_count
       
         # 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.
-        # The message data will be JSON string of a Operation. Format of the Pub/Sub
-        # topic is `projects/`project`/topics/`topic``.
+        # import is finished, a notification is sent to specified Pub/Sub topic. The
+        # message data is JSON string of a Operation. Format of the Pub/Sub topic is `
+        # projects/`project`/topics/`topic``.
         # Corresponds to the JSON property `notificationPubsubTopic`
         # @return [String]
         attr_accessor :notification_pubsub_topic
@@ -2052,6 +2107,11 @@ module Google
         # @return [Fixnum]
         attr_accessor :success_count
       
+        # Metadata related to transform user events operation.
+        # Corresponds to the JSON property `transformedUserEventsMetadata`
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaTransformedUserEventsMetadata]
+        attr_accessor :transformed_user_events_metadata
+      
         # Operation last update time. If the operation is done, this is also the finish
         # time.
         # Corresponds to the JSON property `updateTime`
@@ -2069,6 +2129,7 @@ module Google
           @notification_pubsub_topic = args[:notification_pubsub_topic] if args.key?(:notification_pubsub_topic)
           @request_id = args[:request_id] if args.key?(:request_id)
           @success_count = args[:success_count] if args.key?(:success_count)
+          @transformed_user_events_metadata = args[:transformed_user_events_metadata] if args.key?(:transformed_user_events_metadata)
           @update_time = args[:update_time] if args.key?(:update_time)
         end
       end
@@ -2088,14 +2149,12 @@ module Google
         attr_accessor :input_config
       
         # 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``. 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`.
+        # the import is finished, a notification is sent to specified Pub/Sub topic. The
+        # message data is JSON string of a Operation. Format of the Pub/Sub topic is `
+        # projects/`project`/topics/`topic``. It has to be within the same project as
+        # ImportProductsRequest.parent. Make sure that `service-@gcp-sa-retail.iam.
+        # gserviceaccount.com` has the `pubsub.topics.publish` IAM permission on the
+        # topic.
         # Corresponds to the JSON property `notificationPubsubTopic`
         # @return [String]
         attr_accessor :notification_pubsub_topic
@@ -2111,7 +2170,7 @@ module Google
         # @return [String]
         attr_accessor :request_id
       
-        # If true, will perform the FULL import even if it would delete a large
+        # If true, this performs 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`.
@@ -2120,8 +2179,8 @@ module Google
         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.
+        # Indicates which fields in the provided imported `products` to update. If not
+        # set, all fields are updated.
         # Corresponds to the JSON property `updateMask`
         # @return [String]
         attr_accessor :update_mask
@@ -2470,8 +2529,8 @@ module Google
         attr_accessor :branch_id
       
         # String representing the destination to import for, all if left empty. List of
-        # possible values can be found here. [https://support.google.com/merchants/
-        # answer/7501026] List of allowed string values: "Shopping_ads", "
+        # possible values is given in [Included destination](https://support.google.com/
+        # merchants/answer/7501026). List of allowed string values: "Shopping_ads", "
         # Buy_on_google_listings", "Display_ads", "Local_inventory _ads", "Free_listings"
         # , "Free_local_listings" NOTE: The string values are case sensitive.
         # Corresponds to the JSON property `destinations`
@@ -2538,7 +2597,7 @@ module Google
       
       # Metadata that describes the training and serving parameters of a Model. A
       # Model can be associated with a ServingConfig and then queried through the
-      # Predict api.
+      # Predict API.
       class GoogleCloudRetailV2alphaModel
         include Google::Apis::Core::Hashable
       
@@ -2547,23 +2606,23 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
-        # Output only. The state of data requirements for this model: DATA_OK and
-        # DATA_ERROR. Recommendation model cannot be trained if the data is in
-        # DATA_ERROR state. Recommendation model can have DATA_ERROR state even if
-        # serving state is ACTIVE: models were trained successfully before, but cannot
+        # Output only. The state of data requirements for this model: `DATA_OK` and `
+        # DATA_ERROR`. Recommendation model cannot be trained if the data is in `
+        # DATA_ERROR` state. Recommendation model can have `DATA_ERROR` state even if
+        # serving state is `ACTIVE`: models were trained successfully before, but cannot
         # be refreshed because model no longer has sufficient data for training.
         # Corresponds to the JSON property `dataState`
         # @return [String]
         attr_accessor :data_state
       
         # Required. The display name of the model. Should be human readable, used to
-        # display Recommendation Models in the Retail Pantheon Dashboard. UTF-8 encoded
-        # string with limit of 1024 characters.
+        # display Recommendation Models in the Retail Cloud Console Dashboard. UTF-8
+        # encoded string with limit of 1024 characters.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # Optional. If RECOMMENDATIONS_FILTERING_ENABLED, recommendation filtering by
+        # Optional. If `RECOMMENDATIONS_FILTERING_ENABLED`, recommendation filtering by
         # attributes is enabled for the model.
         # Corresponds to the JSON property `filteringOption`
         # @return [String]
@@ -2574,9 +2633,10 @@ module Google
         # @return [String]
         attr_accessor :last_tune_time
       
-        # Required. The fully qualified resource name of the model. Format: projects/`
+        # Required. The fully qualified resource name of the model. Format: `projects/`
         # project_number`/locations/`location_id`/catalogs/`catalog_id`/models/`model_id`
-        # catalog_id has char limit of 50. recommendation_model_id has char limit of 40.
+        # ` catalog_id has char limit of 50. recommendation_model_id has char limit of
+        # 40.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -2599,8 +2659,8 @@ module Google
         attr_accessor :page_optimization_config
       
         # Optional. The state of periodic tuning. The period we use is 3 months - to do
-        # a one-off tune earlier use the TuneModel method. Default value is
-        # PERIODIC_TUNING_ENABLED.
+        # a one-off tune earlier use the `TuneModel` method. Default value is `
+        # PERIODIC_TUNING_ENABLED`.
         # Corresponds to the JSON property `periodicTuningState`
         # @return [String]
         attr_accessor :periodic_tuning_state
@@ -2611,16 +2671,16 @@ module Google
         # @return [Array<Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaModelServingConfigList>]
         attr_accessor :serving_config_lists
       
-        # Output only. The serving state of the model: ACTIVE, NOT_ACTIVE.
+        # Output only. The serving state of the model: `ACTIVE`, `NOT_ACTIVE`.
         # Corresponds to the JSON property `servingState`
         # @return [String]
         attr_accessor :serving_state
       
-        # Optional. The training state that the model is in (e.g. TRAINING or PAUSED).
-        # Since part of the cost of running the service is frequency of training - this
-        # can be used to determine when to train model in order to control cost. If not
-        # specified: the default value for CreateModel method is TRAINING. the default
-        # value for UpdateModel method is to keep the state the same as before.
+        # Optional. The training state that the model is in (e.g. `TRAINING` or `PAUSED`)
+        # . Since part of the cost of running the service is frequency of training -
+        # this can be used to determine when to train model in order to control cost. If
+        # not specified: the default value for `CreateModel` method is `TRAINING`. The
+        # default value for `UpdateModel` method is to keep the state the same as before.
         # Corresponds to the JSON property `trainingState`
         # @return [String]
         attr_accessor :training_state
@@ -2634,7 +2694,7 @@ module Google
       
         # Required. The type of model e.g. `home-page`. Currently supported values: `
         # recommended-for-you`, `others-you-may-like`, `frequently-bought-together`, `
-        # page-optimization`, 'similar-items', 'buy-it-again', `recently-viewed`(
+        # page-optimization`, `similar-items`, `buy-it-again`, and `recently-viewed`(
         # readonly value).
         # Corresponds to the JSON property `type`
         # @return [String]
@@ -2719,9 +2779,10 @@ module Google
       class GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate
         include Google::Apis::Core::Hashable
       
-        # This has to be a valid ServingConfig identifier. e.g. for a ServingConfig with
-        # full name: `projects/*/locations/global/catalogs/default_catalog/
-        # servingConfigs/my_candidate_config` this would be 'my_candidate_config'
+        # This has to be a valid ServingConfig identifier. For example, for a
+        # ServingConfig with full name: `projects/*/locations/global/catalogs/
+        # default_catalog/servingConfigs/my_candidate_config`, this would be `
+        # my_candidate_config`.
         # Corresponds to the JSON property `servingConfigId`
         # @return [String]
         attr_accessor :serving_config_id
@@ -2768,13 +2829,13 @@ module Google
         end
       end
       
-      # Represents an ordered combination of valid serving configs, which / may be
-      # used for PAGE_OPTIMIZATION recommendations.
+      # Represents an ordered combination of valid serving configs, which can be used
+      # for `PAGE_OPTIMIZATION` recommendations.
       class GoogleCloudRetailV2alphaModelServingConfigList
         include Google::Apis::Core::Hashable
       
-        # Optional. A set of valid serving configs that may be used for
-        # PAGE_OPTIMIZATION.
+        # Optional. A set of valid serving configs that may be used for `
+        # PAGE_OPTIMIZATION`.
         # Corresponds to the JSON property `servingConfigIds`
         # @return [Array<String>]
         attr_accessor :serving_config_ids
@@ -2865,15 +2926,15 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Maximum number of results to return per page. Set this property to the number
-        # of prediction results needed. If zero, the service will choose a reasonable
+        # Maximum number of results to return. Set this property to the number of
+        # prediction results needed. If zero, the service will choose a reasonable
         # default. The maximum allowed value is 100. Values above 100 will be coerced to
         # 100.
         # Corresponds to the JSON property `pageSize`
         # @return [Fixnum]
         attr_accessor :page_size
       
-        # This field is not used for now, leave it unset.
+        # This field is not used; leave it unset.
         # Corresponds to the JSON property `pageToken`
         # @return [String]
         attr_accessor :page_token
@@ -3180,7 +3241,7 @@ module Google
       
         # The id of the collection members when type is Type.COLLECTION. Non-existent
         # product ids are allowed. The type of the members must be either Type.PRIMARY
-        # or Type.VARIANT otherwise and INVALID_ARGUMENT error is thrown. Should not set
+        # or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set
         # it for other types. A maximum of 1000 values are allowed. Otherwise, an
         # INVALID_ARGUMENT error is return.
         # Corresponds to the JSON property `collectionMemberIds`
@@ -3529,7 +3590,7 @@ module Google
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaBigQuerySource]
         attr_accessor :big_query_source
       
-        # Google Cloud Storage location for input content. format.
+        # Google Cloud Storage location for input content.
         # Corresponds to the JSON property `gcsSource`
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaGcsSource]
         attr_accessor :gcs_source
@@ -4201,7 +4262,7 @@ module Google
         attr_accessor :do_not_associate_action
       
         # * Rule Condition: - No Condition.query_terms provided is a global match. - 1
-        # or more Condition.query_terms provided is combined with OR operator. * Action
+        # or more Condition.query_terms provided are combined with OR operator. * Action
         # Input: The request query and filter that are applied to the retrieved products,
         # in addition to any filters already provided with the SearchRequest. The AND
         # operator is used to combine the query's existing filters with the filter rule(
@@ -4338,7 +4399,7 @@ module Google
       end
       
       # * Rule Condition: - No Condition.query_terms provided is a global match. - 1
-      # or more Condition.query_terms provided is combined with OR operator. * Action
+      # or more Condition.query_terms provided are combined with OR operator. * Action
       # Input: The request query and filter that are applied to the retrieved products,
       # in addition to any filters already provided with the SearchRequest. The AND
       # operator is used to combine the query's existing filters with the filter rule(
@@ -4967,6 +5028,13 @@ module Google
         # @return [Array<String>]
         attr_accessor :restricted_values
       
+        # Returns the min and max value for each numerical facet intervals. Ignored for
+        # textual facets.
+        # Corresponds to the JSON property `returnMinMax`
+        # @return [Boolean]
+        attr_accessor :return_min_max
+        alias_method :return_min_max?, :return_min_max
+      
         def initialize(**args)
            update!(**args)
         end
@@ -4981,6 +5049,7 @@ module Google
           @prefixes = args[:prefixes] if args.key?(:prefixes)
           @query = args[:query] if args.key?(:query)
           @restricted_values = args[:restricted_values] if args.key?(:restricted_values)
+          @return_min_max = args[:return_min_max] if args.key?(:return_min_max)
         end
       end
       
@@ -5183,6 +5252,18 @@ module Google
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaInterval]
         attr_accessor :interval
       
+        # The maximum value in the FacetValue.interval. Only supported on numerical
+        # facets and returned if SearchRequest.FacetSpec.FacetKey.return_min_max is true.
+        # Corresponds to the JSON property `maxValue`
+        # @return [Float]
+        attr_accessor :max_value
+      
+        # The minimum value in the FacetValue.interval. Only supported on numerical
+        # facets and returned if SearchRequest.FacetSpec.FacetKey.return_min_max is true.
+        # Corresponds to the JSON property `minValue`
+        # @return [Float]
+        attr_accessor :min_value
+      
         # Text value of a facet, such as "Black" for facet "colorFamilies".
         # Corresponds to the JSON property `value`
         # @return [String]
@@ -5196,6 +5277,8 @@ module Google
         def update!(**args)
           @count = args[:count] if args.key?(:count)
           @interval = args[:interval] if args.key?(:interval)
+          @max_value = args[:max_value] if args.key?(:max_value)
+          @min_value = args[:min_value] if args.key?(:min_value)
           @value = args[:value] if args.key?(:value)
         end
       end
@@ -5251,6 +5334,15 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :matching_variant_fields
       
+        # Specifies previous events related to this product for this user based on
+        # UserEvent with same SearchRequest.visitor_id or UserInfo.user_id. This is set
+        # only when SearchRequest.PersonalizationSpec.mode is SearchRequest.
+        # PersonalizationSpec.Mode.AUTO. Possible values: * `purchased`: Indicates that
+        # this product has been purchased before.
+        # Corresponds to the JSON property `personalLabels`
+        # @return [Array<String>]
+        attr_accessor :personal_labels
+      
         # Product captures all metadata information of items to be recommended or
         # searched.
         # Corresponds to the JSON property `product`
@@ -5283,6 +5375,7 @@ module Google
           @id = args[:id] if args.key?(:id)
           @matching_variant_count = args[:matching_variant_count] if args.key?(:matching_variant_count)
           @matching_variant_fields = args[:matching_variant_fields] if args.key?(:matching_variant_fields)
+          @personal_labels = args[:personal_labels] if args.key?(:personal_labels)
           @product = args[:product] if args.key?(:product)
           @variant_rollup_values = args[:variant_rollup_values] if args.key?(:variant_rollup_values)
         end
@@ -5579,6 +5672,32 @@ module Google
         end
       end
       
+      # Metadata related to transform user events operation.
+      class GoogleCloudRetailV2alphaTransformedUserEventsMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Count of entries in the source user events BigQuery table.
+        # Corresponds to the JSON property `sourceEventsCount`
+        # @return [Fixnum]
+        attr_accessor :source_events_count
+      
+        # Count of entries in the transformed user events BigQuery table, which could be
+        # different from the actually imported number of user events.
+        # Corresponds to the JSON property `transformedEventsCount`
+        # @return [Fixnum]
+        attr_accessor :transformed_events_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @source_events_count = args[:source_events_count] if args.key?(:source_events_count)
+          @transformed_events_count = args[:transformed_events_count] if args.key?(:transformed_events_count)
+        end
+      end
+      
       # Metadata associated with a tune operation.
       class GoogleCloudRetailV2alphaTuneModelMetadata
         include Google::Apis::Core::Hashable
@@ -5908,7 +6027,7 @@ module Google
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaBigQuerySource]
         attr_accessor :big_query_source
       
-        # Google Cloud Storage location for input content. format.
+        # Google Cloud Storage location for input content.
         # Corresponds to the JSON property `gcsSource`
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaGcsSource]
         attr_accessor :gcs_source
@@ -6213,8 +6332,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Google Cloud Storage prefix for import errors. This must be an empty, existing
-        # Cloud Storage directory. Import errors will be written to sharded files in
-        # this directory, one per line, as a JSON-encoded `google.rpc.Status` message.
+        # Cloud Storage directory. Import errors are written to sharded files in this
+        # directory, one per line, as a JSON-encoded `google.rpc.Status` message.
         # Corresponds to the JSON property `gcsPrefix`
         # @return [String]
         attr_accessor :gcs_prefix
@@ -6229,8 +6348,8 @@ module Google
         end
       end
       
-      # Metadata related to the progress of the Import operation. This will be
-      # returned by the google.longrunning.Operation.metadata field.
+      # Metadata related to the progress of the Import operation. This is returned by
+      # the google.longrunning.Operation.metadata field.
       class GoogleCloudRetailV2betaImportMetadata
         include Google::Apis::Core::Hashable
       
@@ -6245,9 +6364,9 @@ module Google
         attr_accessor :failure_count
       
         # 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.
-        # The message data will be JSON string of a Operation. Format of the Pub/Sub
-        # topic is `projects/`project`/topics/`topic``.
+        # import is finished, a notification is sent to specified Pub/Sub topic. The
+        # message data is JSON string of a Operation. Format of the Pub/Sub topic is `
+        # projects/`project`/topics/`topic``.
         # Corresponds to the JSON property `notificationPubsubTopic`
         # @return [String]
         attr_accessor :notification_pubsub_topic

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.50.0"
+      GEM_VERSION = "0.53.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.9.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20220722"
+      REVISION = "20220811"
     end
   end
 end

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

@@ -244,6 +244,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2alphaBigQueryOutputResult
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -898,6 +910,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2alphaTransformedUserEventsMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2alphaTuneModelMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1422,6 +1440,21 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :attribute_keys, as: 'attributeKeys'
+        end
+      end
+      
+      class GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :deleted_catalog_attributes, as: 'deletedCatalogAttributes'
+          collection :reset_catalog_attributes, as: 'resetCatalogAttributes'
+        end
+      end
+      
       class GoogleCloudRetailV2alphaBigQueryOutputResult
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1459,6 +1492,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :dynamic_facetable_option, as: 'dynamicFacetableOption'
+          property :exact_searchable_option, as: 'exactSearchableOption'
           property :in_use, as: 'inUse'
           property :indexable_option, as: 'indexableOption'
           property :key, as: 'key'
@@ -1702,6 +1736,8 @@ module Google
           property :notification_pubsub_topic, as: 'notificationPubsubTopic'
           property :request_id, as: 'requestId'
           property :success_count, :numeric_string => true, as: 'successCount'
+          property :transformed_user_events_metadata, as: 'transformedUserEventsMetadata', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaTransformedUserEventsMetadata, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaTransformedUserEventsMetadata::Representation
+      
           property :update_time, as: 'updateTime'
         end
       end
@@ -2388,6 +2424,7 @@ module Google
           collection :prefixes, as: 'prefixes'
           property :query, as: 'query'
           collection :restricted_values, as: 'restrictedValues'
+          property :return_min_max, as: 'returnMinMax'
         end
       end
       
@@ -2449,6 +2486,8 @@ module Google
           property :count, :numeric_string => true, as: 'count'
           property :interval, as: 'interval', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaInterval, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaInterval::Representation
       
+          property :max_value, as: 'maxValue'
+          property :min_value, as: 'minValue'
           property :value, as: 'value'
         end
       end
@@ -2467,6 +2506,7 @@ module Google
           property :id, as: 'id'
           property :matching_variant_count, as: 'matchingVariantCount'
           hash :matching_variant_fields, as: 'matchingVariantFields'
+          collection :personal_labels, as: 'personalLabels'
           property :product, as: 'product', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaProduct, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaProduct::Representation
       
           hash :variant_rollup_values, as: 'variantRollupValues'
@@ -2529,6 +2569,14 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2alphaTransformedUserEventsMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :source_events_count, :numeric_string => true, as: 'sourceEventsCount'
+          property :transformed_events_count, :numeric_string => true, as: 'transformedEventsCount'
+        end
+      end
+      
       class GoogleCloudRetailV2alphaTuneModelMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -472,6 +472,41 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Removes all specified CatalogAttributes from the AttributesConfig.
+        # @param [String] attributes_config
+        #   Required. The attributes config resource shared by all catalog attributes
+        #   being deleted. Format: `projects/`project_number`/locations/`location_id`/
+        #   catalogs/`catalog_id`/attributesConfig`
+        # @param [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesRequest] google_cloud_retail_v2alpha_batch_remove_catalog_attributes_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::GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse]
+        #
+        # @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 batch_project_location_catalog_attributes_config_remove_catalog_attributes(attributes_config, google_cloud_retail_v2alpha_batch_remove_catalog_attributes_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2alpha/{+attributesConfig}:batchRemoveCatalogAttributes', options)
+          command.request_representation = Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesRequest::Representation
+          command.request_object = google_cloud_retail_v2alpha_batch_remove_catalog_attributes_request_object
+          command.response_representation = Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse::Representation
+          command.response_class = Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse
+          command.params['attributesConfig'] = attributes_config unless attributes_config.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Removes the specified CatalogAttribute from the AttributesConfig. If the
         # CatalogAttribute to remove does not exist, a NOT_FOUND error is returned.
         # @param [String] attributes_config
@@ -579,9 +614,13 @@ module Google
         # updating fulfillment information. If the request is valid, the update will be
         # enqueued and processed downstream. As a consequence, when a response is
         # returned, the added place IDs are not immediately manifested in the Product
-        # queried by ProductService.GetProduct or ProductService.ListProducts. This
-        # feature is only available for users who have Retail Search enabled. Please
-        # enable Retail Search on Cloud Console before using this feature.
+        # queried by ProductService.GetProduct or ProductService.ListProducts. The
+        # returned Operations will be obsolete after 1 day, and GetOperation API will
+        # return NOT_FOUND afterwards. If conflicting updates are issued, the Operations
+        # associated with the stale updates will not be marked as 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.
         # @param [String] product
         #   Required. Full resource name of Product, such as `projects/*/locations/global/
         #   catalogs/default_catalog/branches/default_branch/products/some_product_id`. If
@@ -626,9 +665,12 @@ module Google
         # ProductService.GetProduct or ProductService.ListProducts. Local inventory
         # information can only be modified using this method. ProductService.
         # CreateProduct and ProductService.UpdateProduct has no effect on local
-        # inventories. This feature is only available for users who have Retail Search
-        # enabled. Please enable Retail Search on Cloud Console before using this
-        # feature.
+        # inventories. The returned Operations will be obsolete after 1 day, and
+        # GetOperation API will return NOT_FOUND afterwards. If conflicting updates are
+        # issued, the Operations associated with the stale updates will not be marked as
+        # 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.
         # @param [String] product
         #   Required. Full resource name of Product, such as `projects/*/locations/global/
         #   catalogs/default_catalog/branches/default_branch/products/some_product_id`. If
@@ -981,9 +1023,13 @@ module Google
         # updating fulfillment information. If the request is valid, the update will be
         # enqueued and processed downstream. As a consequence, when a response is
         # returned, the removed place IDs are not immediately manifested in the Product
-        # queried by ProductService.GetProduct or ProductService.ListProducts. This
-        # feature is only available for users who have Retail Search enabled. Please
-        # enable Retail Search on Cloud Console before using this feature.
+        # queried by ProductService.GetProduct or ProductService.ListProducts. The
+        # returned Operations will be obsolete after 1 day, and GetOperation API will
+        # return NOT_FOUND afterwards. If conflicting updates are issued, the Operations
+        # associated with the stale updates will not be marked as 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.
         # @param [String] product
         #   Required. Full resource name of Product, such as `projects/*/locations/global/
         #   catalogs/default_catalog/branches/default_branch/products/some_product_id`. If
@@ -1026,9 +1072,12 @@ module Google
         # queried by ProductService.GetProduct or ProductService.ListProducts. Local
         # inventory information can only be removed using this method. ProductService.
         # CreateProduct and ProductService.UpdateProduct has no effect on local
-        # inventories. This feature is only available for users who have Retail Search
-        # enabled. Please enable Retail Search on Cloud Console before using this
-        # feature.
+        # inventories. The returned Operations will be obsolete after 1 day, and
+        # GetOperation API will return NOT_FOUND afterwards. If conflicting updates are
+        # issued, the Operations associated with the stale updates will not be marked as
+        # 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.
         # @param [String] product
         #   Required. Full resource name of Product, such as `projects/*/locations/global/
         #   catalogs/default_catalog/branches/default_branch/products/some_product_id`. If
@@ -1081,9 +1130,12 @@ module Google
         # SetInventoryRequest.set_mask, then any existing inventory information will be
         # preserved. Pre-existing inventory information can only be updated with
         # ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and
-        # ProductService.RemoveFulfillmentPlaces. This feature is only available for
-        # users who have Retail Search enabled. Please enable Retail Search on Cloud
-        # Console before using this feature.
+        # ProductService.RemoveFulfillmentPlaces. The returned Operations will be
+        # obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards.
+        # If conflicting updates are issued, the Operations associated with the stale
+        # updates will not be marked as 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.
         # @param [String] name
         #   Immutable. Full resource name of the product, such as `projects/*/locations/
         #   global/catalogs/default_catalog/branches/default_branch/products/product_id`.
@@ -1353,7 +1405,7 @@ module Google
         #   projects/`project_number`/locations/`location_id`/catalogs/`catalog_id`
         # @param [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaModel] google_cloud_retail_v2alpha_model_object
         # @param [Boolean] dry_run
-        #   Optional. Whether to run a dry_run to validate the request (without actually
+        #   Optional. Whether to run a dry run to validate the request (without actually
         #   creating the model).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1387,7 +1439,7 @@ module Google
         
         # Deletes an existing model.
         # @param [String] name
-        #   Required. The resource name of the [Model] to delete. Format: projects/`
+        #   Required. The resource name of the Model to delete. Format: projects/`
         #   project_number`/locations/`location_id`/catalogs/`catalog_id`/models/`model_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1455,17 +1507,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Update of model metadata. Only fields that currently can be updated are:
-        # filtering_option, periodic_tuning_state. If other values are provided, this
-        # API method will ignore them.
+        # Update of model metadata. Only fields that currently can be updated are: `
+        # filtering_option` and `periodic_tuning_state`. If other values are provided,
+        # this API method ignores them.
         # @param [String] name
-        #   Required. The fully qualified resource name of the model. Format: projects/`
+        #   Required. The fully qualified resource name of the model. Format: `projects/`
         #   project_number`/locations/`location_id`/catalogs/`catalog_id`/models/`model_id`
-        #   catalog_id has char limit of 50. recommendation_model_id has char limit of 40.
+        #   ` catalog_id has char limit of 50. recommendation_model_id has char limit of
+        #   40.
         # @param [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaModel] google_cloud_retail_v2alpha_model_object
         # @param [String] update_mask
         #   Optional. Indicates which fields in the provided 'model' to update. If not set,
-        #   will by default update all fields.
+        #   by default updates all fields.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2150,9 +2203,9 @@ module Google
         
         # Bulk import of User events. Request processing might be synchronous. Events
         # that already exist are skipped. Use this method for backfilling historical
-        # user events. Operation.response is of type ImportResponse. Note that it is
-        # possible for a subset of the items to be successfully inserted. Operation.
-        # metadata is of type ImportMetadata.
+        # user events. `Operation.response` is of type `ImportResponse`. Note that it is
+        # possible for a subset of the items to be successfully inserted. `Operation.
+        # metadata` is of type `ImportMetadata`.
         # @param [String] parent
         #   Required. `projects/1234/locations/global/catalogs/default_catalog`
         # @param [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaImportUserEventsRequest] google_cloud_retail_v2alpha_import_user_events_request_object

metadata

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