google-apis-retail_v2alpha 0.51.0 → 0.54.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18dbc96cd791962636ccea2130f4c28457fb1bb7cfa739461f5a0ee32c37d713
-  data.tar.gz: 9e41bb871a70b49c21e5dba070f8bb58b1a915c82f1d169d5f83bbe099286e29
+  metadata.gz: a84b377b5e3876b5d1aa8417ff0f7a5c81a7ddae9fa135b9d8101aab0979ab83
+  data.tar.gz: cf01058dc4d9467ff4604aff45e738332d10cd34ae37ec3b453a0f12076afa1d
 SHA512:
-  metadata.gz: a1519608bf99b6f015a25b68e92694fca58fb2ed8b232ea7bedc7c0235ff223211f55e45f5248a13c0a1b2b253e4768055387d3c3690c50f1c78b6cf030abbb4
-  data.tar.gz: 8a8018b93f65677f84779903983691dfeda63025474d7bdc2d11d158d699863faaaa7527a2e470e3d4461f70278aeb5efcb25d2abda21bdec47e28145be0cb50
+  metadata.gz: 9dc5b47987648a68f7ca7d3e2b1d2212fbf062062b196b2da890cb07e5ca833c442d9e2b0abefcf2b9a8470b04e5e4af97134a583f93469aee510d949cffab8b
+  data.tar.gz: 6dbe5b867aff110e2ddac846dc9677aa60b834251025292d67b5ba0a0dafa4c10e29ca999ea4af56070e1f9231e5f5e349c59f56ee2e0238cd93469d2c3aa0b3

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Release history for google-apis-retail_v2alpha
 
+### v0.54.0 (2022-08-25)
+
+* Regenerated from discovery document revision 20220822
+
+### 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

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
@@ -531,7 +531,7 @@ module Google
         end
       end
       
-      # Metadata for RejoinUserEvents method.
+      # Metadata for `RejoinUserEvents` method.
       class GoogleCloudRetailV2RejoinUserEventsMetadata
         include Google::Apis::Core::Hashable
       
@@ -544,7 +544,7 @@ module Google
         end
       end
       
-      # Response message for RejoinUserEvents method.
+      # Response message for `RejoinUserEvents` method.
       class GoogleCloudRetailV2RejoinUserEventsResponse
         include Google::Apis::Core::Hashable
       
@@ -1300,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`
@@ -1562,8 +1562,8 @@ module Google
       
         # The value of the term to match on. Value cannot be empty. Value can have at
         # most 3 terms if specified as a partial match. Each space separated string is
-        # considered as one term. Example) "a b c" is 3 terms and allowed, " a b c d" is
-        # 4 terms and not allowed for partial match.
+        # considered as one term. For example, "a b c" is 3 terms and allowed, but " a b
+        # c d" is 4 terms and not allowed for a partial match.
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -1605,14 +1605,14 @@ module Google
         end
       end
       
-      # Configures dynamic serving time metadata that is used to pre and post process
-      # search/recommendation model results.
+      # Configures dynamic metadata that can be linked to a ServingConfig and affect
+      # search or recommendation results at serving time.
       class GoogleCloudRetailV2alphaControl
         include Google::Apis::Core::Hashable
       
-        # Output only. List of serving configuration ids that that are associated with
-        # this control. Note the association is managed via the ServingConfig, this is
-        # an output only denormalizeed view. Assumed to be in the same catalog.
+        # Output only. List of serving configuration ids that are associated with this
+        # control in the same Catalog. Note the association is managed via the
+        # ServingConfig, this is an output only denormalized view.
         # Corresponds to the JSON property `associatedServingConfigIds`
         # @return [Array<String>]
         attr_accessor :associated_serving_config_ids
@@ -1636,13 +1636,21 @@ module Google
         attr_accessor :name
       
         # A rule is a condition-action pair * A condition defines when a rule is to be
-        # triggered. * An action specifies what occurs on that trigger. Currently only
-        # boost rules are supported. Currently only supported by the search endpoint.
+        # triggered. * An action specifies what occurs on that trigger. Currently rules
+        # only work for controls with SOLUTION_TYPE_SEARCH.
         # Corresponds to the JSON property `rule`
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaRule]
         attr_accessor :rule
       
-        # Required. Immutable. The solution types that the serving config is used for.
+        # Specifies the use case for the control. Affects what condition fields can be
+        # set. Only settable by search controls. Will default to
+        # SEARCH_SOLUTION_USE_CASE_SEARCH if not specified. Currently only allow one
+        # search_solution_use_case per control.
+        # Corresponds to the JSON property `searchSolutionUseCase`
+        # @return [Array<String>]
+        attr_accessor :search_solution_use_case
+      
+        # Required. Immutable. The solution types that the control is used for.
         # Currently we support setting only one type of solution at creation time. Only `
         # SOLUTION_TYPE_SEARCH` value is supported at the moment. If no solution type is
         # provided at creation time, will default to SOLUTION_TYPE_SEARCH.
@@ -1661,6 +1669,7 @@ module Google
           @facet_spec = args[:facet_spec] if args.key?(:facet_spec)
           @name = args[:name] if args.key?(:name)
           @rule = args[:rule] if args.key?(:rule)
+          @search_solution_use_case = args[:search_solution_use_case] if args.key?(:search_solution_use_case)
           @solution_types = args[:solution_types] if args.key?(:solution_types)
         end
       end
@@ -1669,8 +1678,9 @@ module Google
       class GoogleCloudRetailV2alphaCreateModelMetadata
         include Google::Apis::Core::Hashable
       
-        # The resource name of the model that this create applies to. Format: projects/`
+        # The resource name of the model that this create applies to. Format: `projects/`
         # project_number`/locations/`location_id`/catalogs/`catalog_id`/models/`model_id`
+        # `
         # Corresponds to the JSON property `model`
         # @return [String]
         attr_accessor :model
@@ -1763,8 +1773,8 @@ module Google
         end
       end
       
-      # Metadata related to the progress of the Export operation. This will be
-      # returned by the google.longrunning.Operation.metadata field.
+      # Metadata related to the progress of the Export operation. This is returned by
+      # the google.longrunning.Operation.metadata field.
       class GoogleCloudRetailV2alphaExportMetadata
         include Google::Apis::Core::Hashable
       
@@ -1892,7 +1902,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
       
@@ -1903,8 +1913,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]
@@ -2014,9 +2024,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
@@ -2058,8 +2068,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
@@ -2074,8 +2084,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
       
@@ -2090,9 +2100,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
@@ -2149,12 +2159,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 `service-@gcp-sa-
-        # retail.iam.gserviceaccount.com` has the `pubsub.topics.publish` IAM permission
-        # on the topic.
+        # 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
@@ -2170,7 +2180,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`.
@@ -2179,8 +2189,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
@@ -2529,8 +2539,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`
@@ -2597,7 +2607,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
       
@@ -2606,23 +2616,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 Cloud Cosole Dashboard. UTF-8
+        # 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]
@@ -2633,9 +2643,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
@@ -2658,8 +2669,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
@@ -2670,16 +2681,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
@@ -2693,7 +2704,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]
@@ -2778,9 +2789,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
@@ -2827,13 +2839,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
@@ -2924,15 +2936,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
@@ -3221,11 +3233,11 @@ module Google
         # belonging to several parallel categories. Strongly recommended using the full
         # path for better search / recommendation quality. To represent full path of
         # category, use '>' sign to separate different hierarchies. If '>' is part of
-        # the category name, please replace it with other character(s). For example, if
-        # a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["
-        # Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented
-        # as: "categories": [ "Shoes & Accessories > Shoes", "Sports & Fitness >
-        # Athletic Clothing > Shoes" ] Must be set for Type.PRIMARY Product otherwise an
+        # the category name, replace it with other character(s). For example, if a shoes
+        # product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports &
+        # Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as: "
+        # categories": [ "Shoes & Accessories > Shoes", "Sports & Fitness > Athletic
+        # Clothing > Shoes" ] Must be set for Type.PRIMARY Product otherwise an
         # INVALID_ARGUMENT error is returned. At most 250 values are allowed per Product.
         # Empty values are not allowed. Each value must be a UTF-8 encoded string with
         # a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is
@@ -3333,6 +3345,13 @@ module Google
         # @return [String]
         attr_accessor :language_code
       
+        # Output only. A list of local inventories specific to different places. This is
+        # only available for users who have Retail Search enabled, and it can be managed
+        # by AddLocalInventories and RemoveLocalInventories APIs.
+        # Corresponds to the JSON property `localInventories`
+        # @return [Array<Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLocalInventory>]
+        attr_accessor :local_inventories
+      
         # 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 200 characters. Otherwise, an INVALID_ARGUMENT error is returned.
@@ -3511,6 +3530,7 @@ module Google
           @id = args[:id] if args.key?(:id)
           @images = args[:images] if args.key?(:images)
           @language_code = args[:language_code] if args.key?(:language_code)
+          @local_inventories = args[:local_inventories] if args.key?(:local_inventories)
           @materials = args[:materials] if args.key?(:materials)
           @name = args[:name] if args.key?(:name)
           @patterns = args[:patterns] if args.key?(:patterns)
@@ -3588,7 +3608,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
@@ -3946,7 +3966,7 @@ module Google
         end
       end
       
-      # Metadata for RejoinUserEvents method.
+      # Metadata for `RejoinUserEvents` method.
       class GoogleCloudRetailV2alphaRejoinUserEventsMetadata
         include Google::Apis::Core::Hashable
       
@@ -3964,8 +3984,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The type of the user event rejoin to define the scope and range of the user
-        # events to be rejoined with the latest product catalog. Defaults to
-        # USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
+        # events to be rejoined with the latest product catalog. Defaults to `
+        # USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to an
         # invalid integer value.
         # Corresponds to the JSON property `userEventRejoinScope`
         # @return [String]
@@ -3981,7 +4001,7 @@ module Google
         end
       end
       
-      # Response message for RejoinUserEvents method.
+      # Response message for `RejoinUserEvents` method.
       class GoogleCloudRetailV2alphaRejoinUserEventsResponse
         include Google::Apis::Core::Hashable
       
@@ -4233,8 +4253,8 @@ module Google
       end
       
       # A rule is a condition-action pair * A condition defines when a rule is to be
-      # triggered. * An action specifies what occurs on that trigger. Currently only
-      # boost rules are supported. Currently only supported by the search endpoint.
+      # triggered. * An action specifies what occurs on that trigger. Currently rules
+      # only work for controls with SOLUTION_TYPE_SEARCH.
       class GoogleCloudRetailV2alphaRule
         include Google::Apis::Core::Hashable
       
@@ -4260,7 +4280,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(
@@ -4397,7 +4417,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(
@@ -4643,9 +4663,9 @@ module Google
         # navigation queries to achieve good search quality. The format should be the
         # same as UserEvent.page_categories; To represent full path of category, use '>'
         # sign to separate different hierarchies. If '>' is part of the category name,
-        # please replace it with other character(s). Category pages include special
-        # pages such as sales or promotions. For instance, a special sale page may have
-        # the category hierarchy: "pageCategories" : ["Sales > 2017 Black Friday Deals"].
+        # replace it with other character(s). Category pages include special pages such
+        # as sales or promotions. For instance, a special sale page may have the
+        # category hierarchy: "pageCategories" : ["Sales > 2017 Black Friday Deals"].
         # Corresponds to the JSON property `pageCategories`
         # @return [Array<String>]
         attr_accessor :page_categories
@@ -5380,9 +5400,7 @@ module Google
       end
       
       # Configures metadata that is used to generate serving time results (e.g. search
-      # results or recommendation predictions). The ServingConfig is passed in the
-      # search and predict request and together with the Catalog.default_branch,
-      # generates results.
+      # results or recommendation predictions).
       class GoogleCloudRetailV2alphaServingConfig
         include Google::Apis::Core::Hashable
       
@@ -5405,16 +5423,21 @@ module Google
         # @return [String]
         attr_accessor :display_name
       
-        # How much diversity to use in recommendation model results e.g. 'medium-
-        # diversity' or 'high-diversity'. Currently supported values: * 'no-diversity' *
-        # 'low-diversity' * 'medium-diversity' * 'high-diversity' * 'auto-diversity' If
+        # How much diversity to use in recommendation model results e.g. `medium-
+        # diversity` or `high-diversity`. Currently supported values: * `no-diversity` *
+        # `low-diversity` * `medium-diversity` * `high-diversity` * `auto-diversity` If
         # not specified, we choose default based on recommendation model type. Default
-        # value: 'no-diversity'. Can only be set if solution_types is
+        # value: `no-diversity`. Can only be set if solution_types is
         # SOLUTION_TYPE_RECOMMENDATION.
         # Corresponds to the JSON property `diversityLevel`
         # @return [String]
         attr_accessor :diversity_level
       
+        # What kind of diversity to use - data driven or rule based.
+        # Corresponds to the JSON property `diversityType`
+        # @return [String]
+        attr_accessor :diversity_type
+      
         # Condition do not associate specifications. If multiple do not associate
         # conditions match, all matching do not associate controls in the list will
         # execute. - Order does not matter. - Maximum number of specifications is 100.
@@ -5428,10 +5451,10 @@ module Google
         # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestDynamicFacetSpec]
         attr_accessor :dynamic_facet_spec
       
-        # Whether to add additional category filters on the 'similar-items' model. If
-        # not specified, we enable it by default. Allowed values are: * 'no-category-
-        # match': No additional filtering of original results from the model and the
-        # customer's filters. * 'relaxed-category-match': Only keep results with
+        # Whether to add additional category filters on the `similar-items` model. If
+        # not specified, we enable it by default. Allowed values are: * `no-category-
+        # match`: No additional filtering of original results from the model and the
+        # customer's filters. * `relaxed-category-match`: Only keep results with
         # categories that match at least one item categories in the PredictRequests's
         # context item. * If customer also sends filters in the PredictRequest, then the
         # results will satisfy both conditions (user given and category match). Can only
@@ -5465,7 +5488,7 @@ module Google
         # @return [Array<String>]
         attr_accessor :ignore_control_ids
       
-        # The id of the model to use at serving time. Currently only
+        # The id of the model in the same Catalog to use at serving time. Currently only
         # RecommendationModels are supported: https://cloud.google.com/retail/
         # recommendations-ai/docs/create-models Can be changed but only to a compatible
         # model (e.g. others-you-may-like CTR to others-you-may-like CVR). Required when
@@ -5489,13 +5512,18 @@ module Google
         # @return [Array<String>]
         attr_accessor :oneway_synonyms_control_ids
       
+        # The specification for personalization.
+        # Corresponds to the JSON property `personalizationSpec`
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestPersonalizationSpec]
+        attr_accessor :personalization_spec
+      
         # How much price ranking we want in serving results. Price reranking causes
         # product items with a similar recommendation probability to be ordered by price,
         # with the highest-priced items first. This setting could result in a decrease
-        # in click-through and conversion rates. Allowed values are: * 'no-price-
-        # reranking' * 'low-price-raranking' * 'medium-price-reranking' * 'high-price-
-        # reranking' If not specified, we choose default based on model type. Default
-        # value: 'no-price-reranking'. Can only be set if solution_types is
+        # in click-through and conversion rates. Allowed values are: * `no-price-
+        # reranking` * `low-price-raranking` * `medium-price-reranking` * `high-price-
+        # reranking` If not specified, we choose default based on model type. Default
+        # value: `no-price-reranking`. Can only be set if solution_types is
         # SOLUTION_TYPE_RECOMMENDATION.
         # Corresponds to the JSON property `priceRerankingLevel`
         # @return [String]
@@ -5539,6 +5567,7 @@ module Google
           @boost_control_ids = args[:boost_control_ids] if args.key?(:boost_control_ids)
           @display_name = args[:display_name] if args.key?(:display_name)
           @diversity_level = args[:diversity_level] if args.key?(:diversity_level)
+          @diversity_type = args[:diversity_type] if args.key?(:diversity_type)
           @do_not_associate_control_ids = args[:do_not_associate_control_ids] if args.key?(:do_not_associate_control_ids)
           @dynamic_facet_spec = args[:dynamic_facet_spec] if args.key?(:dynamic_facet_spec)
           @enable_category_filter_level = args[:enable_category_filter_level] if args.key?(:enable_category_filter_level)
@@ -5548,6 +5577,7 @@ module Google
           @model_id = args[:model_id] if args.key?(:model_id)
           @name = args[:name] if args.key?(:name)
           @oneway_synonyms_control_ids = args[:oneway_synonyms_control_ids] if args.key?(:oneway_synonyms_control_ids)
+          @personalization_spec = args[:personalization_spec] if args.key?(:personalization_spec)
           @price_reranking_level = args[:price_reranking_level] if args.key?(:price_reranking_level)
           @redirect_control_ids = args[:redirect_control_ids] if args.key?(:redirect_control_ids)
           @replacement_control_ids = args[:replacement_control_ids] if args.key?(:replacement_control_ids)
@@ -5700,8 +5730,9 @@ module Google
       class GoogleCloudRetailV2alphaTuneModelMetadata
         include Google::Apis::Core::Hashable
       
-        # The resource name of the model that this tune applies to. Format: projects/`
+        # The resource name of the model that this tune applies to. Format: `projects/`
         # project_number`/locations/`location_id`/catalogs/`catalog_id`/models/`model_id`
+        # `
         # Corresponds to the JSON property `model`
         # @return [String]
         attr_accessor :model
@@ -5851,12 +5882,12 @@ module Google
       
         # The categories associated with a category page. To represent full path of
         # category, use '>' sign to separate different hierarchies. If '>' is part of
-        # the category name, please replace it with other character(s). Category pages
-        # include special pages such as sales or promotions. For instance, a special
-        # sale page may have the category hierarchy: "pageCategories" : ["Sales > 2017
-        # Black Friday Deals"]. Required for `category-page-view` events. At least one
-        # of search_query or page_categories is required for `search` events. Other
-        # event types should not set this field. Otherwise, an INVALID_ARGUMENT error is
+        # the category name, replace it with other character(s). Category pages include
+        # special pages such as sales or promotions. For instance, a special sale page
+        # may have the category hierarchy: "pageCategories" : ["Sales > 2017 Black
+        # Friday Deals"]. Required for `category-page-view` events. At least one of
+        # search_query or page_categories is required for `search` events. Other event
+        # types should not set this field. Otherwise, an INVALID_ARGUMENT error is
         # returned.
         # Corresponds to the JSON property `pageCategories`
         # @return [Array<String>]
@@ -6025,7 +6056,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
@@ -6211,8 +6242,8 @@ module Google
         end
       end
       
-      # Metadata related to the progress of the Export operation. This will be
-      # returned by the google.longrunning.Operation.metadata field.
+      # Metadata related to the progress of the Export operation. This is returned by
+      # the google.longrunning.Operation.metadata field.
       class GoogleCloudRetailV2betaExportMetadata
         include Google::Apis::Core::Hashable
       
@@ -6330,8 +6361,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
@@ -6346,8 +6377,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
       
@@ -6362,9 +6393,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
@@ -6515,7 +6546,7 @@ module Google
         end
       end
       
-      # Metadata for RejoinUserEvents method.
+      # Metadata for `RejoinUserEvents` method.
       class GoogleCloudRetailV2betaRejoinUserEventsMetadata
         include Google::Apis::Core::Hashable
       
@@ -6528,7 +6559,7 @@ module Google
         end
       end
       
-      # Response message for RejoinUserEvents method.
+      # Response message for `RejoinUserEvents` method.
       class GoogleCloudRetailV2betaRejoinUserEventsResponse
         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.51.0"
+      GEM_VERSION = "0.54.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 = "20220729"
+      REVISION = "20220822"
     end
   end
 end

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

@@ -1610,6 +1610,7 @@ module Google
           property :name, as: 'name'
           property :rule, as: 'rule', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaRule, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaRule::Representation
       
+          collection :search_solution_use_case, as: 'searchSolutionUseCase'
           collection :solution_types, as: 'solutionTypes'
         end
       end
@@ -2030,6 +2031,8 @@ module Google
           collection :images, as: 'images', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaImage, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaImage::Representation
       
           property :language_code, as: 'languageCode'
+          collection :local_inventories, as: 'localInventories', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLocalInventory, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLocalInventory::Representation
+      
           collection :materials, as: 'materials'
           property :name, as: 'name'
           collection :patterns, as: 'patterns'
@@ -2519,6 +2522,7 @@ module Google
           collection :boost_control_ids, as: 'boostControlIds'
           property :display_name, as: 'displayName'
           property :diversity_level, as: 'diversityLevel'
+          property :diversity_type, as: 'diversityType'
           collection :do_not_associate_control_ids, as: 'doNotAssociateControlIds'
           property :dynamic_facet_spec, as: 'dynamicFacetSpec', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestDynamicFacetSpec, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestDynamicFacetSpec::Representation
       
@@ -2529,6 +2533,8 @@ module Google
           property :model_id, as: 'modelId'
           property :name, as: 'name'
           collection :oneway_synonyms_control_ids, as: 'onewaySynonymsControlIds'
+          property :personalization_spec, as: 'personalizationSpec', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestPersonalizationSpec, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaSearchRequestPersonalizationSpec::Representation
+      
           property :price_reranking_level, as: 'priceRerankingLevel'
           collection :redirect_control_ids, as: 'redirectControlIds'
           collection :replacement_control_ids, as: 'replacementControlIds'

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

@@ -52,8 +52,8 @@ module Google
         end
         
         # Completes the specified prefix with keyword suggestions. This feature is only
-        # available for users who have Retail Search enabled. Please enable Retail
-        # Search on Cloud Console before using this feature.
+        # available for users who have Retail Search enabled. Enable Retail Search on
+        # Cloud Console before using this feature.
         # @param [String] catalog
         #   Required. Catalog for which the completion is performed. Full resource name of
         #   catalog, such as `projects/*/locations/global/catalogs/default_catalog`.
@@ -159,8 +159,8 @@ module Google
         
         # Gets a CompletionConfig.
         # @param [String] name
-        #   Required. Full CompletionConfig resource name. Format: projects/`
-        #   project_number`/locations/`location_id`/catalogs/`catalog_id`/completionConfig
+        #   Required. Full CompletionConfig resource name. Format: `projects/`
+        #   project_number`/locations/`location_id`/catalogs/`catalog_id`/completionConfig`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -609,14 +609,48 @@ module Google
           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_location_catalog_branch_place_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
+        
         # Incrementally adds place IDs to Product.fulfillment_info.place_ids. This
         # process is asynchronous and does not require the Product to exist before
         # 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. 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
@@ -661,8 +695,11 @@ 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
+        # 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. Enable Retail Search on Cloud Console before using this
         # feature.
         # @param [String] product
         #   Required. Full resource name of Product, such as `projects/*/locations/global/
@@ -1016,9 +1053,12 @@ 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. 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
@@ -1061,8 +1101,11 @@ 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
+        # 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. Enable Retail Search on Cloud Console before using this
         # feature.
         # @param [String] product
         #   Required. Full resource name of Product, such as `projects/*/locations/global/
@@ -1102,23 +1145,26 @@ module Google
         # Updates inventory information for a Product while respecting the last update
         # timestamps of each inventory field. This process is asynchronous and does not
         # require the Product to exist before updating fulfillment information. If the
-        # request is valid, the update will be enqueued and processed downstream. As a
+        # request is valid, the update is enqueued and processed downstream. As a
         # consequence, when a response is returned, updates are not immediately
         # manifested in the Product queried by ProductService.GetProduct or
         # ProductService.ListProducts. When inventory is updated with ProductService.
         # CreateProduct and ProductService.UpdateProduct, the specified inventory field
-        # value(s) will overwrite any existing value(s) while ignoring the last update
-        # time for this field. Furthermore, the last update time for the specified
-        # inventory fields will be overwritten to the time of the ProductService.
-        # CreateProduct or ProductService.UpdateProduct request. If no inventory fields
-        # are set in CreateProductRequest.product, then any pre-existing inventory
-        # information for this product will be used. If no inventory fields are set in
-        # 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.
+        # value(s) overwrite any existing value(s) while ignoring the last update time
+        # for this field. Furthermore, the last update times for the specified inventory
+        # fields are overwritten by the times of the ProductService.CreateProduct or
+        # ProductService.UpdateProduct request. If no inventory fields are set in
+        # CreateProductRequest.product, then any pre-existing inventory information for
+        # this product is used. If no inventory fields are set in SetInventoryRequest.
+        # set_mask, then any existing inventory information is preserved. Pre-existing
+        # inventory information can only be updated with ProductService.SetInventory,
+        # ProductService.AddFulfillmentPlaces, and ProductService.
+        # RemoveFulfillmentPlaces. The returned Operations is obsolete after one day,
+        # and the GetOperation API returns `NOT_FOUND` afterwards. If conflicting
+        # updates are issued, the Operations associated with the stale updates are not
+        # marked as done until they are obsolete. This feature is only available for
+        # users who have Retail Search enabled. 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`.
@@ -1156,8 +1202,8 @@ module Google
         # asynchronous. Partial updating is not supported. The operation is successfully
         # finished only after the imported suggestions are indexed successfully and
         # ready for serving. The process takes hours. This feature is only available for
-        # users who have Retail Search enabled. Please enable Retail Search on Cloud
-        # Console before using this feature.
+        # users who have Retail Search enabled. Enable Retail Search on Cloud Console
+        # before using this feature.
         # @param [String] parent
         #   Required. The catalog which the suggestions dataset belongs to. Format: `
         #   projects/1234/locations/global/catalogs/default_catalog`.
@@ -1266,7 +1312,7 @@ module Google
         
         # Gets a Control.
         # @param [String] name
-        #   Required. The resource name of the Control to delete. Format: `projects/`
+        #   Required. The resource name of the Control to get. Format: `projects/`
         #   project_number`/locations/`location_id`/catalogs/`catalog_id`/controls/`
         #   control_id``
         # @param [String] fields
@@ -1296,7 +1342,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists all Controls linked to this catalog.
+        # Lists all Controls by their parent Catalog.
         # @param [String] parent
         #   Required. The catalog resource name. Format: `projects/`project_number`/
         #   locations/`location_id`/catalogs/`catalog_id``
@@ -1342,7 +1388,7 @@ module Google
         end
         
         # Updates a Control. Control cannot be set to a different oneof field, if so an
-        # INVALID_ARGUMENT is returned. If the Control to delete does not exist, a
+        # INVALID_ARGUMENT is returned. If the Control to update does not exist, a
         # NOT_FOUND error is returned.
         # @param [String] name
         #   Immutable. Fully qualified name `projects/*/locations/global/catalogs/*/
@@ -1384,11 +1430,11 @@ module Google
         
         # Creates a new model.
         # @param [String] parent
-        #   Required. The parent resource under which to create the model. Format:
-        #   projects/`project_number`/locations/`location_id`/catalogs/`catalog_id`
+        #   Required. The parent resource under which to create the model. Format: `
+        #   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.
@@ -1422,8 +1468,9 @@ 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.
         # @param [String] quota_user
@@ -1453,8 +1500,8 @@ module Google
         
         # Lists all the models linked to this event store.
         # @param [String] parent
-        #   Required. The parent for which to list models. Format: projects/`
-        #   project_number`/locations/`location_id`/catalogs/`catalog_id`
+        #   Required. The parent for which to list models. Format: `projects/`
+        #   project_number`/locations/`location_id`/catalogs/`catalog_id``
         # @param [Fixnum] page_size
         #   Optional. Maximum number of results to return. If unspecified, defaults to 50.
         #   Max allowed value is 1000.
@@ -1490,17 +1537,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
@@ -1533,8 +1581,8 @@ module Google
         
         # Pauses the training of an existing model.
         # @param [String] name
-        #   Required. The name of the model to pause. Format: projects/`project_number`/
-        #   locations/`location_id`/catalogs/`catalog_id`/models/`model_id`
+        #   Required. The name of the model to pause. Format: `projects/`project_number`/
+        #   locations/`location_id`/catalogs/`catalog_id`/models/`model_id``
         # @param [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaPauseModelRequest] google_cloud_retail_v2alpha_pause_model_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1567,8 +1615,8 @@ module Google
         
         # Resumes the training of an existing model.
         # @param [String] name
-        #   Required. The name of the model to resume. Format: projects/`project_number`/
-        #   locations/`location_id`/catalogs/`catalog_id`/models/`model_id`
+        #   Required. The name of the model to resume. Format: `projects/`project_number`/
+        #   locations/`location_id`/catalogs/`catalog_id`/models/`model_id``
         # @param [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaResumeModelRequest] google_cloud_retail_v2alpha_resume_model_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1601,8 +1649,9 @@ module Google
         
         # Tunes an existing model.
         # @param [String] name
-        #   Required. The resource name of the model to tune. Format: projects/`
+        #   Required. The resource name of the model to tune. Format: `projects/`
         #   project_number`/locations/`location_id`/catalogs/`catalog_id`/models/`model_id`
+        #   `
         # @param [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaTuneModelRequest] google_cloud_retail_v2alpha_tune_model_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1753,7 +1802,7 @@ module Google
         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
+        # Search enabled. 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 `
@@ -1799,9 +1848,9 @@ module Google
         # Returns a FAILED_PRECONDITION error if the addition could exceed maximum
         # number of control allowed for that type of control.
         # @param [String] serving_config
-        #   Required. The source ServingConfig resource name . Format: projects/`
+        #   Required. The source ServingConfig resource name . Format: `projects/`
         #   project_number`/locations/`location_id`/catalogs/`catalog_id`/servingConfigs/`
-        #   serving_config_id`
+        #   serving_config_id``
         # @param [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaAddControlRequest] google_cloud_retail_v2alpha_add_control_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1875,9 +1924,9 @@ module Google
         # Deletes a ServingConfig. Returns a NotFound error if the ServingConfig does
         # not exist.
         # @param [String] name
-        #   Required. The resource name of the ServingConfig to delete. Format: projects/`
+        #   Required. The resource name of the ServingConfig to delete. Format: `projects/`
         #   project_number`/locations/`location_id`/catalogs/`catalog_id`/servingConfigs/`
-        #   serving_config_id`
+        #   serving_config_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1908,9 +1957,9 @@ module Google
         # Gets a ServingConfig. Returns a NotFound error if the ServingConfig does not
         # exist.
         # @param [String] name
-        #   Required. The resource name of the ServingConfig to get. Format: projects/`
+        #   Required. The resource name of the ServingConfig to get. Format: `projects/`
         #   project_number`/locations/`location_id`/catalogs/`catalog_id`/servingConfigs/`
-        #   serving_config_id`
+        #   serving_config_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1940,8 +1989,8 @@ module Google
         
         # Lists all ServingConfigs linked to this catalog.
         # @param [String] parent
-        #   Required. The catalog resource name. Format: projects/`project_number`/
-        #   locations/`location_id`/catalogs/`catalog_id`
+        #   Required. The catalog resource name. Format: `projects/`project_number`/
+        #   locations/`location_id`/catalogs/`catalog_id``
         # @param [Fixnum] page_size
         #   Optional. Maximum number of results to return. If unspecified, defaults to 100.
         #   If a value greater than 100 is provided, at most 100 results are returned.
@@ -2062,9 +2111,9 @@ module Google
         # the ServingConfig. Returns a NOT_FOUND error if the Control is not enabled for
         # the ServingConfig.
         # @param [String] serving_config
-        #   Required. The source ServingConfig resource name . Format: projects/`
+        #   Required. The source ServingConfig resource name . Format: `projects/`
         #   project_number`/locations/`location_id`/catalogs/`catalog_id`/servingConfigs/`
-        #   serving_config_id`
+        #   serving_config_id``
         # @param [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaRemoveControlRequest] google_cloud_retail_v2alpha_remove_control_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2096,7 +2145,7 @@ module Google
         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
+        # Search enabled. 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 `
@@ -2185,9 +2234,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
@@ -2257,12 +2306,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Starts a user event rejoin operation with latest product catalog. Events will
-        # not be annotated with detailed product information if product is missing from
-        # the catalog at the time the user event is ingested, and these events are
-        # stored as unjoined events with a limited usage on training and serving. This
-        # method can be used to start a join operation on specified events with latest
-        # version of product catalog. It can also be used to correct events joined with
+        # Starts a user-event rejoin operation with latest product catalog. Events are
+        # not annotated with detailed product information for products that are missing
+        # from the catalog when the user event is ingested. These events are stored as
+        # unjoined events with limited usage on training and serving. You can use this
+        # method to start a join operation on specified events with the latest version
+        # of product catalog. You can also use this method to correct events joined with
         # the wrong product catalog. A rejoin operation can take hours or days to
         # complete.
         # @param [String] parent

metadata

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