Sample code: + * + *
{@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
+ * BatchRemoveCatalogAttributesRequest request =
+ * BatchRemoveCatalogAttributesRequest.newBuilder()
+ * .setAttributesConfig(
+ * AttributesConfigName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString())
+ * .addAllAttributeKeys(new ArrayList())
+ * .build();
+ * BatchRemoveCatalogAttributesResponse response =
+ * catalogServiceClient.batchRemoveCatalogAttributes(request);
+ * }
+ * }
+ *
+ * @param request The request object containing all of the parameters for the API call.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final BatchRemoveCatalogAttributesResponse batchRemoveCatalogAttributes(
+ BatchRemoveCatalogAttributesRequest request) {
+ return batchRemoveCatalogAttributesCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Removes all specified [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s from the
+ * [AttributesConfig][google.cloud.retail.v2beta.AttributesConfig].
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
+ * BatchRemoveCatalogAttributesRequest request =
+ * BatchRemoveCatalogAttributesRequest.newBuilder()
+ * .setAttributesConfig(
+ * AttributesConfigName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString())
+ * .addAllAttributeKeys(new ArrayList())
+ * .build();
+ * ApiFuture future =
+ * catalogServiceClient.batchRemoveCatalogAttributesCallable().futureCall(request);
+ * // Do something.
+ * BatchRemoveCatalogAttributesResponse response = future.get();
+ * }
+ * }
+ */
+ public final UnaryCallable<
+ BatchRemoveCatalogAttributesRequest, BatchRemoveCatalogAttributesResponse>
+ batchRemoveCatalogAttributesCallable() {
+ return stub.batchRemoveCatalogAttributesCallable();
+ }
+
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Replaces the specified [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute] in the
diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/CatalogServiceSettings.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/CatalogServiceSettings.java
index 09c6f2b2e2a9..292407f99a59 100644
--- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/CatalogServiceSettings.java
+++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/CatalogServiceSettings.java
@@ -132,6 +132,13 @@ public UnaryCallSettingsThis feature is only available for users who have Retail Search enabled. Please enable Retail - * Search on Cloud Console before using this feature. + *
This feature is only available for users who have Retail Search enabled. Enable Retail Search + * on Cloud Console before using this feature. * *
This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: @@ -205,8 +205,8 @@ public final OperationsClient getHttpJsonOperationsClient() { /** * 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. + *
This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *
Sample code: * @@ -239,8 +239,8 @@ public final CompleteQueryResponse completeQuery(CompleteQueryRequest request) { /** * 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. + *
This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *
Sample code:
*
@@ -278,8 +278,8 @@ public final UnaryCallable 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.
+ * This feature is only available for users who have Retail Search enabled. Enable Retail
+ * Search on Cloud Console before using this feature.
*
* Sample code:
*
@@ -315,8 +315,8 @@ public final UnaryCallable 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.
+ * This feature is only available for users who have Retail Search enabled. Enable Retail
+ * Search on Cloud Console before using this feature.
*
* Sample code:
*
@@ -352,8 +352,8 @@ public final UnaryCallable 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.
+ * This feature is only available for users who have Retail Search enabled. Enable Retail
+ * Search on Cloud Console before using this feature.
*
* Sample code:
*
diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/ControlServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/ControlServiceClient.java
index e5f274225bbc..9b31bc1ac109 100644
--- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/ControlServiceClient.java
+++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/ControlServiceClient.java
@@ -421,7 +421,7 @@ public final UnaryCallable [Control][google.cloud.retail.v2beta.Control] cannot be set to a different oneof field, if
* so an INVALID_ARGUMENT is returned. If the [Control][google.cloud.retail.v2beta.Control] to
- * delete does not exist, a NOT_FOUND error is returned.
+ * update does not exist, a NOT_FOUND error is returned.
*
* Sample code:
*
@@ -456,7 +456,7 @@ public final Control updateControl(Control control, FieldMask updateMask) {
*
* [Control][google.cloud.retail.v2beta.Control] cannot be set to a different oneof field, if
* so an INVALID_ARGUMENT is returned. If the [Control][google.cloud.retail.v2beta.Control] to
- * delete does not exist, a NOT_FOUND error is returned.
+ * update does not exist, a NOT_FOUND error is returned.
*
* Sample code:
*
@@ -486,7 +486,7 @@ public final Control updateControl(UpdateControlRequest request) {
*
* [Control][google.cloud.retail.v2beta.Control] cannot be set to a different oneof field, if
* so an INVALID_ARGUMENT is returned. If the [Control][google.cloud.retail.v2beta.Control] to
- * delete does not exist, a NOT_FOUND error is returned.
+ * update does not exist, a NOT_FOUND error is returned.
*
* Sample code:
*
@@ -524,7 +524,7 @@ public final UnaryCallable Sample code:
*
@@ -640,7 +640,7 @@ public final ListControlsPagedResponse listControls(CatalogName parent) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Lists all Controls linked to this catalog.
+ * Lists all Controls by their parent [Catalog][google.cloud.retail.v2beta.Catalog].
*
* Sample code:
*
@@ -666,7 +666,7 @@ public final ListControlsPagedResponse listControls(String parent) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Lists all Controls linked to this catalog.
+ * Lists all Controls by their parent [Catalog][google.cloud.retail.v2beta.Catalog].
*
* Sample code:
*
@@ -696,7 +696,7 @@ public final ListControlsPagedResponse listControls(ListControlsRequest request)
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Lists all Controls linked to this catalog.
+ * Lists all Controls by their parent [Catalog][google.cloud.retail.v2beta.Catalog].
*
* Sample code:
*
@@ -727,7 +727,7 @@ public final ListControlsPagedResponse listControls(ListControlsRequest request)
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Lists all Controls linked to this catalog.
+ * Lists all Controls by their parent [Catalog][google.cloud.retail.v2beta.Catalog].
*
* Sample code:
*
diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/ModelServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/ModelServiceClient.java
new file mode 100644
index 000000000000..fa064dbf2768
--- /dev/null
+++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/ModelServiceClient.java
@@ -0,0 +1,1069 @@
+/*
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.cloud.retail.v2beta;
+
+import com.google.api.core.ApiFuture;
+import com.google.api.core.ApiFutures;
+import com.google.api.core.BetaApi;
+import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.httpjson.longrunning.OperationsClient;
+import com.google.api.gax.longrunning.OperationFuture;
+import com.google.api.gax.paging.AbstractFixedSizeCollection;
+import com.google.api.gax.paging.AbstractPage;
+import com.google.api.gax.paging.AbstractPagedListResponse;
+import com.google.api.gax.rpc.OperationCallable;
+import com.google.api.gax.rpc.PageContext;
+import com.google.api.gax.rpc.UnaryCallable;
+import com.google.cloud.retail.v2beta.stub.ModelServiceStub;
+import com.google.cloud.retail.v2beta.stub.ModelServiceStubSettings;
+import com.google.common.util.concurrent.MoreExecutors;
+import com.google.longrunning.Operation;
+import com.google.protobuf.Empty;
+import com.google.protobuf.FieldMask;
+import java.io.IOException;
+import java.util.List;
+import java.util.concurrent.TimeUnit;
+import javax.annotation.Generated;
+
+// AUTO-GENERATED DOCUMENTATION AND CLASS.
+/**
+ * Service Description: Service for performing CRUD operations on models. Recommendation models
+ * contain all the metadata necessary to generate a set of models for the `Predict()` API. A model
+ * is queried indirectly via a ServingConfig, which associates a model with a given Placement (e.g.
+ * Frequently Bought Together on Home Page).
+ *
+ * This service allows you to do the following:
+ *
+ * This class provides the ability to make remote calls to the backing service through method
+ * calls that map to API methods. Sample code to get started:
+ *
+ * Note: close() needs to be called on the ModelServiceClient object to clean up resources such
+ * as threads. In the example above, try-with-resources is used, which automatically calls close().
+ *
+ * The surface of this class includes several types of Java methods for each of the API's
+ * methods:
+ *
+ * See the individual methods for example code.
+ *
+ * Many parameters require resource names to be formatted in a particular way. To assist with
+ * these names, this class includes a format method for each type of name, and additionally a parse
+ * method to extract the individual identifiers contained within names that are returned.
+ *
+ * This class can be customized by passing in a custom instance of ModelServiceSettings to
+ * create(). For example:
+ *
+ * To customize credentials:
+ *
+ * To customize the endpoint:
+ *
+ * To use REST (HTTP1.1/JSON) transport (instead of gRPC) for sending and receiving requests over
+ * the wire:
+ *
+ * Please refer to the GitHub repository's samples for more quickstart code snippets.
+ */
+@BetaApi
+@Generated("by gapic-generator-java")
+public class ModelServiceClient implements BackgroundResource {
+ private final ModelServiceSettings settings;
+ private final ModelServiceStub stub;
+ private final OperationsClient httpJsonOperationsClient;
+ private final com.google.longrunning.OperationsClient operationsClient;
+
+ /** Constructs an instance of ModelServiceClient with default settings. */
+ public static final ModelServiceClient create() throws IOException {
+ return create(ModelServiceSettings.newBuilder().build());
+ }
+
+ /**
+ * Constructs an instance of ModelServiceClient, using the given settings. The channels are
+ * created based on the settings passed in, or defaults for any settings that are not set.
+ */
+ public static final ModelServiceClient create(ModelServiceSettings settings) throws IOException {
+ return new ModelServiceClient(settings);
+ }
+
+ /**
+ * Constructs an instance of ModelServiceClient, using the given stub for making calls. This is
+ * for advanced usage - prefer using create(ModelServiceSettings).
+ */
+ public static final ModelServiceClient create(ModelServiceStub stub) {
+ return new ModelServiceClient(stub);
+ }
+
+ /**
+ * Constructs an instance of ModelServiceClient, using the given settings. This is protected so
+ * that it is easy to make a subclass, but otherwise, the static factory methods should be
+ * preferred.
+ */
+ protected ModelServiceClient(ModelServiceSettings settings) throws IOException {
+ this.settings = settings;
+ this.stub = ((ModelServiceStubSettings) settings.getStubSettings()).createStub();
+ this.operationsClient =
+ com.google.longrunning.OperationsClient.create(this.stub.getOperationsStub());
+ this.httpJsonOperationsClient = OperationsClient.create(this.stub.getHttpJsonOperationsStub());
+ }
+
+ protected ModelServiceClient(ModelServiceStub stub) {
+ this.settings = null;
+ this.stub = stub;
+ this.operationsClient =
+ com.google.longrunning.OperationsClient.create(this.stub.getOperationsStub());
+ this.httpJsonOperationsClient = OperationsClient.create(this.stub.getHttpJsonOperationsStub());
+ }
+
+ public final ModelServiceSettings getSettings() {
+ return settings;
+ }
+
+ public ModelServiceStub getStub() {
+ return stub;
+ }
+
+ /**
+ * Returns the OperationsClient that can be used to query the status of a long-running operation
+ * returned by another API method call.
+ */
+ public final com.google.longrunning.OperationsClient getOperationsClient() {
+ return operationsClient;
+ }
+
+ /**
+ * Returns the OperationsClient that can be used to query the status of a long-running operation
+ * returned by another API method call.
+ */
+ @BetaApi
+ public final OperationsClient getHttpJsonOperationsClient() {
+ return httpJsonOperationsClient;
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Creates a new model.
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * The default instance has everything set to sensible defaults:
+ *
+ * The builder of this class is recursive, so contained classes are themselves builders. When
+ * build() is called, the tree of builders is called to create the complete settings object.
+ *
+ * For example, to set the total timeout of pauseModel to 30 seconds:
+ *
+ * Note: This method does not support applying settings to streaming methods.
+ */
+ public Builder applyToAllUnaryMethods(
+ ApiFunction This process is asynchronous and does not require the
* [Product][google.cloud.retail.v2beta.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, updates are not immediately manifested in the
+ * If the 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][google.cloud.retail.v2beta.Product] queried by
* [ProductService.GetProduct][google.cloud.retail.v2beta.ProductService.GetProduct] or
* [ProductService.ListProducts][google.cloud.retail.v2beta.ProductService.ListProducts].
@@ -975,20 +975,20 @@ public final UnaryCallable When inventory is updated with
* [ProductService.CreateProduct][google.cloud.retail.v2beta.ProductService.CreateProduct] and
* [ProductService.UpdateProduct][google.cloud.retail.v2beta.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
+ * specified inventory field 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][google.cloud.retail.v2beta.ProductService.CreateProduct] or
* [ProductService.UpdateProduct][google.cloud.retail.v2beta.ProductService.UpdateProduct]
* request.
*
* If no inventory fields are set in
* [CreateProductRequest.product][google.cloud.retail.v2beta.CreateProductRequest.product], then
- * any pre-existing inventory information for this product will be used.
+ * any pre-existing inventory information for this product is used.
*
* If no inventory fields are set in
* [SetInventoryRequest.set_mask][google.cloud.retail.v2beta.SetInventoryRequest.set_mask], then
- * any existing inventory information will be preserved.
+ * any existing inventory information is preserved.
*
* Pre-existing inventory information can only be updated with
* [ProductService.SetInventory][google.cloud.retail.v2beta.ProductService.SetInventory],
@@ -996,8 +996,15 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s is obsolete after one day, and the
+ * [GetOperation][google.longrunning.Operations.GetOperation] API returns `NOT_FOUND` afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates are not marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1083,8 +1090,8 @@ public final OperationFuture This process is asynchronous and does not require the
* [Product][google.cloud.retail.v2beta.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, updates are not immediately manifested in the
+ * If the 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][google.cloud.retail.v2beta.Product] queried by
* [ProductService.GetProduct][google.cloud.retail.v2beta.ProductService.GetProduct] or
* [ProductService.ListProducts][google.cloud.retail.v2beta.ProductService.ListProducts].
@@ -1092,20 +1099,20 @@ public final OperationFuture When inventory is updated with
* [ProductService.CreateProduct][google.cloud.retail.v2beta.ProductService.CreateProduct] and
* [ProductService.UpdateProduct][google.cloud.retail.v2beta.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
+ * specified inventory field 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][google.cloud.retail.v2beta.ProductService.CreateProduct] or
* [ProductService.UpdateProduct][google.cloud.retail.v2beta.ProductService.UpdateProduct]
* request.
*
* If no inventory fields are set in
* [CreateProductRequest.product][google.cloud.retail.v2beta.CreateProductRequest.product], then
- * any pre-existing inventory information for this product will be used.
+ * any pre-existing inventory information for this product is used.
*
* If no inventory fields are set in
* [SetInventoryRequest.set_mask][google.cloud.retail.v2beta.SetInventoryRequest.set_mask], then
- * any existing inventory information will be preserved.
+ * any existing inventory information is preserved.
*
* Pre-existing inventory information can only be updated with
* [ProductService.SetInventory][google.cloud.retail.v2beta.ProductService.SetInventory],
@@ -1113,8 +1120,15 @@ public final OperationFuture This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s is obsolete after one day, and the
+ * [GetOperation][google.longrunning.Operations.GetOperation] API returns `NOT_FOUND` afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates are not marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1148,8 +1162,8 @@ public final OperationFuture This process is asynchronous and does not require the
* [Product][google.cloud.retail.v2beta.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, updates are not immediately manifested in the
+ * If the 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][google.cloud.retail.v2beta.Product] queried by
* [ProductService.GetProduct][google.cloud.retail.v2beta.ProductService.GetProduct] or
* [ProductService.ListProducts][google.cloud.retail.v2beta.ProductService.ListProducts].
@@ -1157,20 +1171,20 @@ public final OperationFuture When inventory is updated with
* [ProductService.CreateProduct][google.cloud.retail.v2beta.ProductService.CreateProduct] and
* [ProductService.UpdateProduct][google.cloud.retail.v2beta.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
+ * specified inventory field 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][google.cloud.retail.v2beta.ProductService.CreateProduct] or
* [ProductService.UpdateProduct][google.cloud.retail.v2beta.ProductService.UpdateProduct]
* request.
*
* If no inventory fields are set in
* [CreateProductRequest.product][google.cloud.retail.v2beta.CreateProductRequest.product], then
- * any pre-existing inventory information for this product will be used.
+ * any pre-existing inventory information for this product is used.
*
* If no inventory fields are set in
* [SetInventoryRequest.set_mask][google.cloud.retail.v2beta.SetInventoryRequest.set_mask], then
- * any existing inventory information will be preserved.
+ * any existing inventory information is preserved.
*
* Pre-existing inventory information can only be updated with
* [ProductService.SetInventory][google.cloud.retail.v2beta.ProductService.SetInventory],
@@ -1178,8 +1192,15 @@ public final OperationFuture This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s is obsolete after one day, and the
+ * [GetOperation][google.longrunning.Operations.GetOperation] API returns `NOT_FOUND` afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates are not marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1213,8 +1234,8 @@ public final OperationFuture This process is asynchronous and does not require the
* [Product][google.cloud.retail.v2beta.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, updates are not immediately manifested in the
+ * If the 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][google.cloud.retail.v2beta.Product] queried by
* [ProductService.GetProduct][google.cloud.retail.v2beta.ProductService.GetProduct] or
* [ProductService.ListProducts][google.cloud.retail.v2beta.ProductService.ListProducts].
@@ -1222,20 +1243,20 @@ public final OperationFuture When inventory is updated with
* [ProductService.CreateProduct][google.cloud.retail.v2beta.ProductService.CreateProduct] and
* [ProductService.UpdateProduct][google.cloud.retail.v2beta.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
+ * specified inventory field 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][google.cloud.retail.v2beta.ProductService.CreateProduct] or
* [ProductService.UpdateProduct][google.cloud.retail.v2beta.ProductService.UpdateProduct]
* request.
*
* If no inventory fields are set in
* [CreateProductRequest.product][google.cloud.retail.v2beta.CreateProductRequest.product], then
- * any pre-existing inventory information for this product will be used.
+ * any pre-existing inventory information for this product is used.
*
* If no inventory fields are set in
* [SetInventoryRequest.set_mask][google.cloud.retail.v2beta.SetInventoryRequest.set_mask], then
- * any existing inventory information will be preserved.
+ * any existing inventory information is preserved.
*
* Pre-existing inventory information can only be updated with
* [ProductService.SetInventory][google.cloud.retail.v2beta.ProductService.SetInventory],
@@ -1243,8 +1264,15 @@ public final OperationFuture This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s is obsolete after one day, and the
+ * [GetOperation][google.longrunning.Operations.GetOperation] API returns `NOT_FOUND` afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates are not marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1282,8 +1310,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1328,8 +1364,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1373,8 +1417,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1418,8 +1470,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1463,8 +1523,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1507,8 +1575,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1553,8 +1629,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1598,8 +1682,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1643,8 +1735,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1690,8 +1790,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1739,8 +1847,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1790,8 +1906,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1840,8 +1964,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1890,8 +2022,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1940,8 +2080,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -1986,8 +2134,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -2035,8 +2191,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -2083,8 +2247,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -2130,8 +2302,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
@@ -2179,8 +2359,16 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and
+ * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND
+ * afterwards.
+ *
+ * If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated
+ * with the stale updates will not be marked as [done][google.longrunning.Operation.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.
*
* Sample code:
*
diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/SearchServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/SearchServiceClient.java
index 2fc1ffd695cf..357269726e1c 100644
--- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/SearchServiceClient.java
+++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/SearchServiceClient.java
@@ -37,8 +37,8 @@
/**
* Service Description: Service for search.
*
- * This feature is only available for users who have Retail Search enabled. Please enable Retail
- * Search on Cloud Console before using this feature.
+ * This feature is only available for users who have Retail Search enabled. Enable Retail Search
+ * on Cloud Console before using this feature.
*
* This class provides the ability to make remote calls to the backing service through method
* calls that map to API methods. Sample code to get started:
@@ -196,8 +196,8 @@ public SearchServiceStub getStub() {
/**
* Performs a search.
*
- * This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * This feature is only available for users who have Retail Search enabled. Enable Retail
+ * Search on Cloud Console before using this feature.
*
* Sample code:
*
@@ -246,8 +246,8 @@ public final SearchPagedResponse search(SearchRequest request) {
/**
* Performs a search.
*
- * This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * This feature is only available for users who have Retail Search enabled. Enable Retail
+ * Search on Cloud Console before using this feature.
*
* Sample code:
*
@@ -296,8 +296,8 @@ public final UnaryCallable This feature is only available for users who have Retail Search enabled. Please enable
- * Retail Search on Cloud Console before using this feature.
+ * This feature is only available for users who have Retail Search enabled. Enable Retail
+ * Search on Cloud Console before using this feature.
*
* Sample code:
*
diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/ServingConfigServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/ServingConfigServiceClient.java
index c9ed82ae0f64..0a62d58f511b 100644
--- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/ServingConfigServiceClient.java
+++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/ServingConfigServiceClient.java
@@ -343,7 +343,7 @@ public final ServingConfig createServingConfig(CreateServingConfigRequest reques
* }
*
* @param name Required. The resource name of the ServingConfig to delete. Format:
- * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+ * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final void deleteServingConfig(ServingConfigName name) {
@@ -375,7 +375,7 @@ public final void deleteServingConfig(ServingConfigName name) {
* }
*
* @param name Required. The resource name of the ServingConfig to delete. Format:
- * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+ * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final void deleteServingConfig(String name) {
@@ -557,7 +557,7 @@ public final ServingConfig updateServingConfig(UpdateServingConfigRequest reques
* }
*
* @param name Required. The resource name of the ServingConfig to get. Format:
- * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+ * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ServingConfig getServingConfig(ServingConfigName name) {
@@ -587,7 +587,7 @@ public final ServingConfig getServingConfig(ServingConfigName name) {
* }
*
* @param name Required. The resource name of the ServingConfig to get. Format:
- * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+ * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ServingConfig getServingConfig(String name) {
@@ -675,7 +675,7 @@ public final UnaryCallable 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.
+ * `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`.
*
* Sample code:
*
@@ -437,8 +437,8 @@ public final OperationFuture 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.
+ * `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`.
*
* Sample code:
*
@@ -469,8 +469,8 @@ public final OperationFuture 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.
+ * `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`.
*
* Sample code:
*
@@ -497,11 +497,11 @@ public final UnaryCallable Sample code:
@@ -527,11 +527,11 @@ public final UnaryCallable Sample code:
@@ -557,11 +557,11 @@ public final UnaryCallable Sample code:
diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/gapic_metadata.json b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/gapic_metadata.json
index e5e1a2552016..33d1590fae58 100644
--- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/gapic_metadata.json
+++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/gapic_metadata.json
@@ -13,6 +13,9 @@
"AddCatalogAttribute": {
"methods": ["addCatalogAttribute", "addCatalogAttributeCallable"]
},
+ "BatchRemoveCatalogAttributes": {
+ "methods": ["batchRemoveCatalogAttributes", "batchRemoveCatalogAttributesCallable"]
+ },
"GetAttributesConfig": {
"methods": ["getAttributesConfig", "getAttributesConfig", "getAttributesConfig", "getAttributesConfigCallable"]
},
@@ -86,6 +89,36 @@
}
}
},
+ "ModelService": {
+ "clients": {
+ "grpc": {
+ "libraryClient": "ModelServiceClient",
+ "rpcs": {
+ "CreateModel": {
+ "methods": ["createModelAsync", "createModelAsync", "createModelAsync", "createModelOperationCallable", "createModelCallable"]
+ },
+ "DeleteModel": {
+ "methods": ["deleteModel", "deleteModel", "deleteModel", "deleteModelCallable"]
+ },
+ "ListModels": {
+ "methods": ["listModels", "listModels", "listModels", "listModelsPagedCallable", "listModelsCallable"]
+ },
+ "PauseModel": {
+ "methods": ["pauseModel", "pauseModel", "pauseModel", "pauseModelCallable"]
+ },
+ "ResumeModel": {
+ "methods": ["resumeModel", "resumeModel", "resumeModelCallable"]
+ },
+ "TuneModel": {
+ "methods": ["tuneModelAsync", "tuneModelAsync", "tuneModelAsync", "tuneModelOperationCallable", "tuneModelCallable"]
+ },
+ "UpdateModel": {
+ "methods": ["updateModel", "updateModel", "updateModelCallable"]
+ }
+ }
+ }
+ }
+ },
"PredictionService": {
"clients": {
"grpc": {
diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/package-info.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/package-info.java
index a28b696189c2..df6716a51db6 100644
--- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/package-info.java
+++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/package-info.java
@@ -39,8 +39,8 @@
*
* Service Description: Auto-completion service for retail.
*
- * This feature is only available for users who have Retail Search enabled. Please enable Retail
- * Search on Cloud Console before using this feature.
+ * This feature is only available for users who have Retail Search enabled. Enable Retail Search
+ * on Cloud Console before using this feature.
*
* Sample for CompletionServiceClient:
*
@@ -79,6 +79,33 @@
* }
* }
*
+ * ======================= ModelServiceClient =======================
+ *
+ * Service Description: Service for performing CRUD operations on models. Recommendation models
+ * contain all the metadata necessary to generate a set of models for the `Predict()` API. A model
+ * is queried indirectly via a ServingConfig, which associates a model with a given Placement (e.g.
+ * Frequently Bought Together on Home Page).
+ *
+ * This service allows you to do the following:
+ *
+ * Sample for ModelServiceClient:
+ *
+ * ======================= PredictionServiceClient =======================
*
* Service Description: Service for making recommendation prediction.
@@ -126,8 +153,8 @@
*
* Service Description: Service for search.
*
- * This feature is only available for users who have Retail Search enabled. Please enable Retail
- * Search on Cloud Console before using this feature.
+ * This feature is only available for users who have Retail Search enabled. Enable Retail Search
+ * on Cloud Console before using this feature.
*
* Sample for SearchServiceClient:
*
diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/stub/CatalogServiceStub.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/stub/CatalogServiceStub.java
index dc42b194082b..31438aaf6ad0 100644
--- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/stub/CatalogServiceStub.java
+++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/stub/CatalogServiceStub.java
@@ -23,6 +23,8 @@
import com.google.api.gax.rpc.UnaryCallable;
import com.google.cloud.retail.v2beta.AddCatalogAttributeRequest;
import com.google.cloud.retail.v2beta.AttributesConfig;
+import com.google.cloud.retail.v2beta.BatchRemoveCatalogAttributesRequest;
+import com.google.cloud.retail.v2beta.BatchRemoveCatalogAttributesResponse;
import com.google.cloud.retail.v2beta.Catalog;
import com.google.cloud.retail.v2beta.CompletionConfig;
import com.google.cloud.retail.v2beta.GetAttributesConfigRequest;
@@ -98,6 +100,12 @@ public UnaryCallable This class is for advanced usage.
+ */
+@BetaApi
+@Generated("by gapic-generator-java")
+public class GrpcModelServiceCallableFactory implements GrpcStubCallableFactory {
+
+ @Override
+ public This class is for advanced usage and reflects the underlying API directly.
+ */
+@BetaApi
+@Generated("by gapic-generator-java")
+public class GrpcModelServiceStub extends ModelServiceStub {
+ private static final MethodDescriptor
+ *
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * ModelName name = ModelName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[MODEL]");
+ * Model response = modelServiceClient.pauseModel(name);
+ * }
+ * }
+ *
+ *
+ *
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * ModelServiceSettings modelServiceSettings =
+ * ModelServiceSettings.newBuilder()
+ * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
+ * .build();
+ * ModelServiceClient modelServiceClient = ModelServiceClient.create(modelServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * ModelServiceSettings modelServiceSettings =
+ * ModelServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
+ * ModelServiceClient modelServiceClient = ModelServiceClient.create(modelServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * ModelServiceSettings modelServiceSettings =
+ * ModelServiceSettings.newBuilder()
+ * .setTransportChannelProvider(
+ * ModelServiceSettings.defaultHttpJsonTransportProviderBuilder().build())
+ * .build();
+ * ModelServiceClient modelServiceClient = ModelServiceClient.create(modelServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * CatalogName parent = CatalogName.of("[PROJECT]", "[LOCATION]", "[CATALOG]");
+ * Model model = Model.newBuilder().build();
+ * Model response = modelServiceClient.createModelAsync(parent, model).get();
+ * }
+ * }
+ *
+ * @param parent Required. The parent resource under which to create the model. Format:
+ * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
+ * @param model Required. The payload of the [Model][google.cloud.retail.v2beta.Model] to create.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture{@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * String parent = CatalogName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString();
+ * Model model = Model.newBuilder().build();
+ * Model response = modelServiceClient.createModelAsync(parent, model).get();
+ * }
+ * }
+ *
+ * @param parent Required. The parent resource under which to create the model. Format:
+ * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
+ * @param model Required. The payload of the [Model][google.cloud.retail.v2beta.Model] to create.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture{@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * CreateModelRequest request =
+ * CreateModelRequest.newBuilder()
+ * .setParent(CatalogName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString())
+ * .setModel(Model.newBuilder().build())
+ * .setDryRun(true)
+ * .build();
+ * Model response = modelServiceClient.createModelAsync(request).get();
+ * }
+ * }
+ *
+ * @param request The request object containing all of the parameters for the API call.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture{@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * CreateModelRequest request =
+ * CreateModelRequest.newBuilder()
+ * .setParent(CatalogName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString())
+ * .setModel(Model.newBuilder().build())
+ * .setDryRun(true)
+ * .build();
+ * OperationFuture
+ */
+ public final OperationCallable{@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * CreateModelRequest request =
+ * CreateModelRequest.newBuilder()
+ * .setParent(CatalogName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString())
+ * .setModel(Model.newBuilder().build())
+ * .setDryRun(true)
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * ModelName name = ModelName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[MODEL]");
+ * Model response = modelServiceClient.pauseModel(name);
+ * }
+ * }
+ *
+ * @param name Required. The name of the model to pause. Format:
+ * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Model pauseModel(ModelName name) {
+ PauseModelRequest request =
+ PauseModelRequest.newBuilder().setName(name == null ? null : name.toString()).build();
+ return pauseModel(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Pauses the training of an existing model.
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * String name = ModelName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[MODEL]").toString();
+ * Model response = modelServiceClient.pauseModel(name);
+ * }
+ * }
+ *
+ * @param name Required. The name of the model to pause. Format:
+ * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Model pauseModel(String name) {
+ PauseModelRequest request = PauseModelRequest.newBuilder().setName(name).build();
+ return pauseModel(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Pauses the training of an existing model.
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * PauseModelRequest request =
+ * PauseModelRequest.newBuilder()
+ * .setName(ModelName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[MODEL]").toString())
+ * .build();
+ * Model response = modelServiceClient.pauseModel(request);
+ * }
+ * }
+ *
+ * @param request The request object containing all of the parameters for the API call.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Model pauseModel(PauseModelRequest request) {
+ return pauseModelCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Pauses the training of an existing model.
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * PauseModelRequest request =
+ * PauseModelRequest.newBuilder()
+ * .setName(ModelName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[MODEL]").toString())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * String name = "name3373707";
+ * Model response = modelServiceClient.resumeModel(name);
+ * }
+ * }
+ *
+ * @param name Required. The name of the model to resume. Format:
+ * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Model resumeModel(String name) {
+ ResumeModelRequest request = ResumeModelRequest.newBuilder().setName(name).build();
+ return resumeModel(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Resumes the training of an existing model.
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * ResumeModelRequest request = ResumeModelRequest.newBuilder().setName("name3373707").build();
+ * Model response = modelServiceClient.resumeModel(request);
+ * }
+ * }
+ *
+ * @param request The request object containing all of the parameters for the API call.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Model resumeModel(ResumeModelRequest request) {
+ return resumeModelCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Resumes the training of an existing model.
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * ResumeModelRequest request = ResumeModelRequest.newBuilder().setName("name3373707").build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * ModelName name = ModelName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[MODEL]");
+ * modelServiceClient.deleteModel(name);
+ * }
+ * }
+ *
+ * @param name Required. The resource name of the [Model][google.cloud.retail.v2beta.Model] to
+ * delete. Format:
+ * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final void deleteModel(ModelName name) {
+ DeleteModelRequest request =
+ DeleteModelRequest.newBuilder().setName(name == null ? null : name.toString()).build();
+ deleteModel(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Deletes an existing model.
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * String name = ModelName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[MODEL]").toString();
+ * modelServiceClient.deleteModel(name);
+ * }
+ * }
+ *
+ * @param name Required. The resource name of the [Model][google.cloud.retail.v2beta.Model] to
+ * delete. Format:
+ * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final void deleteModel(String name) {
+ DeleteModelRequest request = DeleteModelRequest.newBuilder().setName(name).build();
+ deleteModel(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Deletes an existing model.
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * DeleteModelRequest request =
+ * DeleteModelRequest.newBuilder()
+ * .setName(ModelName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[MODEL]").toString())
+ * .build();
+ * modelServiceClient.deleteModel(request);
+ * }
+ * }
+ *
+ * @param request The request object containing all of the parameters for the API call.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final void deleteModel(DeleteModelRequest request) {
+ deleteModelCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Deletes an existing model.
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * DeleteModelRequest request =
+ * DeleteModelRequest.newBuilder()
+ * .setName(ModelName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[MODEL]").toString())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * CatalogName parent = CatalogName.of("[PROJECT]", "[LOCATION]", "[CATALOG]");
+ * for (Model element : modelServiceClient.listModels(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The parent for which to list models. Format:
+ * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListModelsPagedResponse listModels(CatalogName parent) {
+ ListModelsRequest request =
+ ListModelsRequest.newBuilder().setParent(parent == null ? null : parent.toString()).build();
+ return listModels(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists all the models linked to this event store.
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * String parent = CatalogName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString();
+ * for (Model element : modelServiceClient.listModels(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The parent for which to list models. Format:
+ * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListModelsPagedResponse listModels(String parent) {
+ ListModelsRequest request = ListModelsRequest.newBuilder().setParent(parent).build();
+ return listModels(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists all the models linked to this event store.
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * ListModelsRequest request =
+ * ListModelsRequest.newBuilder()
+ * .setParent(CatalogName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * for (Model element : modelServiceClient.listModels(request).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param request The request object containing all of the parameters for the API call.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListModelsPagedResponse listModels(ListModelsRequest request) {
+ return listModelsPagedCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists all the models linked to this event store.
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * ListModelsRequest request =
+ * ListModelsRequest.newBuilder()
+ * .setParent(CatalogName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * ListModelsRequest request =
+ * ListModelsRequest.newBuilder()
+ * .setParent(CatalogName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * while (true) {
+ * ListModelsResponse response = modelServiceClient.listModelsCallable().call(request);
+ * for (Model element : response.getModelsList()) {
+ * // doThingsWith(element);
+ * }
+ * String nextPageToken = response.getNextPageToken();
+ * if (!Strings.isNullOrEmpty(nextPageToken)) {
+ * request = request.toBuilder().setPageToken(nextPageToken).build();
+ * } else {
+ * break;
+ * }
+ * }
+ * }
+ * }
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * Model model = Model.newBuilder().build();
+ * FieldMask updateMask = FieldMask.newBuilder().build();
+ * Model response = modelServiceClient.updateModel(model, updateMask);
+ * }
+ * }
+ *
+ * @param model Required. The body of the updated [Model][google.cloud.retail.v2beta.Model].
+ * @param updateMask Optional. Indicates which fields in the provided 'model' to update. If not
+ * set, by default updates all fields.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Model updateModel(Model model, FieldMask updateMask) {
+ UpdateModelRequest request =
+ UpdateModelRequest.newBuilder().setModel(model).setUpdateMask(updateMask).build();
+ return updateModel(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * 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.
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * UpdateModelRequest request =
+ * UpdateModelRequest.newBuilder()
+ * .setModel(Model.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .build();
+ * Model response = modelServiceClient.updateModel(request);
+ * }
+ * }
+ *
+ * @param request The request object containing all of the parameters for the API call.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Model updateModel(UpdateModelRequest request) {
+ return updateModelCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * 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.
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * UpdateModelRequest request =
+ * UpdateModelRequest.newBuilder()
+ * .setModel(Model.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * ModelName name = ModelName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[MODEL]");
+ * TuneModelResponse response = modelServiceClient.tuneModelAsync(name).get();
+ * }
+ * }
+ *
+ * @param name Required. The resource name of the model to tune. Format:
+ * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture{@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * String name = ModelName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[MODEL]").toString();
+ * TuneModelResponse response = modelServiceClient.tuneModelAsync(name).get();
+ * }
+ * }
+ *
+ * @param name Required. The resource name of the model to tune. Format:
+ * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture{@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * TuneModelRequest request =
+ * TuneModelRequest.newBuilder()
+ * .setName(ModelName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[MODEL]").toString())
+ * .build();
+ * TuneModelResponse response = modelServiceClient.tuneModelAsync(request).get();
+ * }
+ * }
+ *
+ * @param request The request object containing all of the parameters for the API call.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture{@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * TuneModelRequest request =
+ * TuneModelRequest.newBuilder()
+ * .setName(ModelName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[MODEL]").toString())
+ * .build();
+ * OperationFuture
+ */
+ public final OperationCallable{@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * TuneModelRequest request =
+ * TuneModelRequest.newBuilder()
+ * .setName(ModelName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[MODEL]").toString())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable
+ *
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * ModelServiceSettings.Builder modelServiceSettingsBuilder = ModelServiceSettings.newBuilder();
+ * modelServiceSettingsBuilder
+ * .pauseModelSettings()
+ * .setRetrySettings(
+ * modelServiceSettingsBuilder
+ * .pauseModelSettings()
+ * .getRetrySettings()
+ * .toBuilder()
+ * .setTotalTimeout(Duration.ofSeconds(30))
+ * .build());
+ * ModelServiceSettings modelServiceSettings = modelServiceSettingsBuilder.build();
+ * }
+ */
+@BetaApi
+@Generated("by gapic-generator-java")
+public class ModelServiceSettings extends ClientSettings
+ *
+ *
+ * {@code
+ * // This snippet has been automatically generated for illustrative purposes only.
+ * // It may require modifications to work in your environment.
+ * try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
+ * ModelName name = ModelName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[MODEL]");
+ * Model response = modelServiceClient.pauseModel(name);
+ * }
+ * }
+ *
*