service.rb in google-apis-retail_v2beta-0.61.0

- old
+ new

@@ -1687,14 +1687,14 @@
         #   global/catalogs/default_catalog/servingConfigs/*`` or ``placement=projects/*/
         #   locations/global/catalogs/default_catalog/placements/*``. We recommend using
         #   the `servingConfigs` resource. `placements` is a legacy resource. The ID of
         #   the Recommendations AI serving config or placement. Before you can request
         #   predictions from your model, you must create at least one serving config or
-        #   placement for it. For more information, see [Managing serving configurations] (
-        #   https://cloud.google.com/retail/docs/manage-configs). The full list of
-        #   available serving configs can be seen at https://console.cloud.google.com/ai/
-        #   retail/catalogs/default_catalog/configs
+        #   placement for it. For more information, see [Manage serving configs] (https://
+        #   cloud.google.com/retail/docs/manage-configs). The full list of available
+        #   serving configs can be seen at https://console.cloud.google.com/ai/retail/
+        #   catalogs/default_catalog/configs
         # @param [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaPredictRequest] google_cloud_retail_v2beta_predict_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
         #   Available to use for quota purposes for server-side applications. Can be any
@@ -1729,12 +1729,12 @@
         # @param [String] placement
         #   Required. The resource name of the Retail Search serving config, such as `
         #   projects/*/locations/global/catalogs/default_catalog/servingConfigs/
         #   default_serving_config` or the name of the legacy placement resource, such as `
         #   projects/*/locations/global/catalogs/default_catalog/placements/default_search`
-        #   . This field is used to identify the serving configuration name and the set of
-        #   models that will be used to make the search.
+        #   . This field is used to identify the serving config name and the set of models
+        #   that will be used to make the search.
         # @param [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaSearchRequest] google_cloud_retail_v2beta_search_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
         #   Available to use for quota purposes for server-side applications. Can be any
@@ -1993,14 +1993,14 @@
         #   global/catalogs/default_catalog/servingConfigs/*`` or ``placement=projects/*/
         #   locations/global/catalogs/default_catalog/placements/*``. We recommend using
         #   the `servingConfigs` resource. `placements` is a legacy resource. The ID of
         #   the Recommendations AI serving config or placement. Before you can request
         #   predictions from your model, you must create at least one serving config or
-        #   placement for it. For more information, see [Managing serving configurations] (
-        #   https://cloud.google.com/retail/docs/manage-configs). The full list of
-        #   available serving configs can be seen at https://console.cloud.google.com/ai/
-        #   retail/catalogs/default_catalog/configs
+        #   placement for it. For more information, see [Manage serving configs] (https://
+        #   cloud.google.com/retail/docs/manage-configs). The full list of available
+        #   serving configs can be seen at https://console.cloud.google.com/ai/retail/
+        #   catalogs/default_catalog/configs
         # @param [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaPredictRequest] google_cloud_retail_v2beta_predict_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
         #   Available to use for quota purposes for server-side applications. Can be any
@@ -2072,12 +2072,12 @@
         # @param [String] placement
         #   Required. The resource name of the Retail Search serving config, such as `
         #   projects/*/locations/global/catalogs/default_catalog/servingConfigs/
         #   default_serving_config` or the name of the legacy placement resource, such as `
         #   projects/*/locations/global/catalogs/default_catalog/placements/default_search`
-        #   . This field is used to identify the serving configuration name and the set of
-        #   models that will be used to make the search.
+        #   . This field is used to identify the serving config name and the set of models
+        #   that will be used to make the search.
         # @param [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaSearchRequest] google_cloud_retail_v2beta_search_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
         #   Available to use for quota purposes for server-side applications. Can be any
@@ -2117,11 +2117,11 @@
         #   The event timestamp in milliseconds. This prevents browser caching of
         #   otherwise identical get requests. The name is abbreviated to reduce the
         #   payload bytes.
         # @param [String] prebuilt_rule
         #   The prebuilt rule name that can convert a specific type of raw_json. For
-        #   example: "default_schema/v1.0"
+        #   example: "ga4_bq" rule for the GA4 user event schema.
         # @param [String] raw_json
         #   An arbitrary serialized JSON string that contains necessary information that
         #   can comprise a user event. When this field is specified, the user_event field
         #   will be ignored. Note: line-delimited JSON is not supported, a single JSON
         #   only.
@@ -2282,10 +2282,15 @@
         # Writes a single user event.
         # @param [String] parent
         #   Required. The parent catalog resource name, such as `projects/1234/locations/
         #   global/catalogs/default_catalog`.
         # @param [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaUserEvent] google_cloud_retail_v2beta_user_event_object
+        # @param [Boolean] write_async
+        #   If set to true, the user event will be written asynchronously after validation,
+        #   and the API will respond without waiting for the write. Therefore, silent
+        #   failures can occur even if the API returns success. In case of silent failures,
+        #   error messages can be found in Stackdriver logs.
         # @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.
@@ -2299,16 +2304,17 @@
         # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaUserEvent]
         #
         # @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 write_project_location_catalog_user_event(parent, google_cloud_retail_v2beta_user_event_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+        def write_project_location_catalog_user_event(parent, google_cloud_retail_v2beta_user_event_object = nil, write_async: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:post, 'v2beta/{+parent}/userEvents:write', options)
           command.request_representation = Google::Apis::RetailV2beta::GoogleCloudRetailV2betaUserEvent::Representation
           command.request_object = google_cloud_retail_v2beta_user_event_object
           command.response_representation = Google::Apis::RetailV2beta::GoogleCloudRetailV2betaUserEvent::Representation
           command.response_class = Google::Apis::RetailV2beta::GoogleCloudRetailV2betaUserEvent
           command.params['parent'] = parent unless parent.nil?
+          command.query['writeAsync'] = write_async unless write_async.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         