ImportSuggestionDenyListEntries
Imports all [SuggestionDenyListEntry][google.cloud.discoveryengine.v1beta.SuggestionDenyListEntry] for a DataStore.
Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *importSuggestionDenyListEntriesAsync(ImportSuggestionDenyListEntriesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *importSuggestionDenyListEntriesOperationCallable() + *
importSuggestionDenyListEntriesCallable() + *
PurgeSuggestionDenyListEntries
Permanently deletes all [SuggestionDenyListEntry][google.cloud.discoveryengine.v1beta.SuggestionDenyListEntry] for a DataStore.
Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *purgeSuggestionDenyListEntriesAsync(PurgeSuggestionDenyListEntriesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *purgeSuggestionDenyListEntriesOperationCallable() + *
purgeSuggestionDenyListEntriesCallable() + *
See the individual methods for example code.
@@ -142,6 +176,8 @@
public class CompletionServiceClient implements BackgroundResource {
private final CompletionServiceSettings settings;
private final CompletionServiceStub stub;
+ private final OperationsClient httpJsonOperationsClient;
+ private final com.google.longrunning.OperationsClient operationsClient;
/** Constructs an instance of CompletionServiceClient with default settings. */
public static final CompletionServiceClient create() throws IOException {
@@ -173,11 +209,17 @@ public static final CompletionServiceClient create(CompletionServiceStub stub) {
protected CompletionServiceClient(CompletionServiceSettings settings) throws IOException {
this.settings = settings;
this.stub = ((CompletionServiceStubSettings) settings.getStubSettings()).createStub();
+ this.operationsClient =
+ com.google.longrunning.OperationsClient.create(this.stub.getOperationsStub());
+ this.httpJsonOperationsClient = OperationsClient.create(this.stub.getHttpJsonOperationsStub());
}
protected CompletionServiceClient(CompletionServiceStub 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 CompletionServiceSettings getSettings() {
@@ -188,6 +230,23 @@ public CompletionServiceStub 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.
/**
* Completes the specified user input with keyword suggestions.
@@ -258,6 +317,228 @@ public final UnaryCallable Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * If not set or empty, all supported fields are updated.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
diff --git a/java-discoveryengine/google-cloud-discoveryengine/src/main/java/com/google/cloud/discoveryengine/v1beta/DataStoreServiceClient.java b/java-discoveryengine/google-cloud-discoveryengine/src/main/java/com/google/cloud/discoveryengine/v1beta/DataStoreServiceClient.java
new file mode 100644
index 000000000000..2344ea317097
--- /dev/null
+++ b/java-discoveryengine/google-cloud-discoveryengine/src/main/java/com/google/cloud/discoveryengine/v1beta/DataStoreServiceClient.java
@@ -0,0 +1,1190 @@
+/*
+ * Copyright 2023 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.discoveryengine.v1beta;
+
+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.discoveryengine.v1beta.stub.DataStoreServiceStub;
+import com.google.cloud.discoveryengine.v1beta.stub.DataStoreServiceStubSettings;
+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 managing
+ * [DataStore][google.cloud.discoveryengine.v1beta.DataStore] configuration.
+ *
+ * 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 DataStoreServiceClient object to clean up resources
+ * such as threads. In the example above, try-with-resources is used, which automatically calls
+ * close().
+ *
+ * CreateDataStore Creates a [DataStore][google.cloud.discoveryengine.v1beta.DataStore].
+ * DataStore is for storing [Documents][google.cloud.discoveryengine.v1beta.Document]. To serve these documents for Search, or Recommendation use case, an [Engine][google.cloud.discoveryengine.v1beta.Engine] needs to be created separately. Request object method variants only take one parameter, a request object, which must be constructed before the call. createDataStoreAsync(CreateDataStoreRequest request)
+ * Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. createDataStoreAsync(CollectionName parent, DataStore dataStore, String dataStoreId)
+ * createDataStoreAsync(String parent, DataStore dataStore, String dataStoreId)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. createDataStoreOperationCallable()
+ * createDataStoreCallable()
+ * GetDataStore Gets a [DataStore][google.cloud.discoveryengine.v1beta.DataStore]. Request object method variants only take one parameter, a request object, which must be constructed before the call. getDataStore(GetDataStoreRequest request)
+ * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. getDataStore(DataStoreName name)
+ * getDataStore(String name)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. getDataStoreCallable()
+ * ListDataStores Lists all the [DataStore][google.cloud.discoveryengine.v1beta.DataStore]s associated with the project. Request object method variants only take one parameter, a request object, which must be constructed before the call. listDataStores(ListDataStoresRequest request)
+ * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. listDataStores(CollectionName parent)
+ * listDataStores(String parent)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. listDataStoresPagedCallable()
+ * listDataStoresCallable()
+ * DeleteDataStore Deletes a [DataStore][google.cloud.discoveryengine.v1beta.DataStore]. Request object method variants only take one parameter, a request object, which must be constructed before the call. deleteDataStoreAsync(DeleteDataStoreRequest request)
+ * Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. deleteDataStoreAsync(DataStoreName name)
+ * deleteDataStoreAsync(String name)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. deleteDataStoreOperationCallable()
+ * deleteDataStoreCallable()
+ * UpdateDataStore Updates a [DataStore][google.cloud.discoveryengine.v1beta.DataStore] Request object method variants only take one parameter, a request object, which must be constructed before the call. updateDataStore(UpdateDataStoreRequest request)
+ * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. updateDataStore(DataStore dataStore, FieldMask updateMask)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. updateDataStoreCallable()
+ * 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 DataStoreServiceSettings 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 DataStoreServiceClient implements BackgroundResource {
+ private final DataStoreServiceSettings settings;
+ private final DataStoreServiceStub stub;
+ private final OperationsClient httpJsonOperationsClient;
+ private final com.google.longrunning.OperationsClient operationsClient;
+
+ /** Constructs an instance of DataStoreServiceClient with default settings. */
+ public static final DataStoreServiceClient create() throws IOException {
+ return create(DataStoreServiceSettings.newBuilder().build());
+ }
+
+ /**
+ * Constructs an instance of DataStoreServiceClient, 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 DataStoreServiceClient create(DataStoreServiceSettings settings)
+ throws IOException {
+ return new DataStoreServiceClient(settings);
+ }
+
+ /**
+ * Constructs an instance of DataStoreServiceClient, using the given stub for making calls. This
+ * is for advanced usage - prefer using create(DataStoreServiceSettings).
+ */
+ public static final DataStoreServiceClient create(DataStoreServiceStub stub) {
+ return new DataStoreServiceClient(stub);
+ }
+
+ /**
+ * Constructs an instance of DataStoreServiceClient, 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 DataStoreServiceClient(DataStoreServiceSettings settings) throws IOException {
+ this.settings = settings;
+ this.stub = ((DataStoreServiceStubSettings) settings.getStubSettings()).createStub();
+ this.operationsClient =
+ com.google.longrunning.OperationsClient.create(this.stub.getOperationsStub());
+ this.httpJsonOperationsClient = OperationsClient.create(this.stub.getHttpJsonOperationsStub());
+ }
+
+ protected DataStoreServiceClient(DataStoreServiceStub 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 DataStoreServiceSettings getSettings() {
+ return settings;
+ }
+
+ public DataStoreServiceStub 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 [DataStore][google.cloud.discoveryengine.v1beta.DataStore].
+ *
+ * DataStore is for storing [Documents][google.cloud.discoveryengine.v1beta.Document]. To serve
+ * these documents for Search, or Recommendation use case, an
+ * [Engine][google.cloud.discoveryengine.v1beta.Engine] needs to be created separately.
+ *
+ * Sample code:
+ *
+ * This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with
+ * a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture DataStore is for storing [Documents][google.cloud.discoveryengine.v1beta.Document]. To serve
+ * these documents for Search, or Recommendation use case, an
+ * [Engine][google.cloud.discoveryengine.v1beta.Engine] needs to be created separately.
+ *
+ * Sample code:
+ *
+ * This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with
+ * a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture DataStore is for storing [Documents][google.cloud.discoveryengine.v1beta.Document]. To serve
+ * these documents for Search, or Recommendation use case, an
+ * [Engine][google.cloud.discoveryengine.v1beta.Engine] needs to be created separately.
+ *
+ * Sample code:
+ *
+ * DataStore is for storing [Documents][google.cloud.discoveryengine.v1beta.Document]. To serve
+ * these documents for Search, or Recommendation use case, an
+ * [Engine][google.cloud.discoveryengine.v1beta.Engine] needs to be created separately.
+ *
+ * Sample code:
+ *
+ * DataStore is for storing [Documents][google.cloud.discoveryengine.v1beta.Document]. To serve
+ * these documents for Search, or Recommendation use case, an
+ * [Engine][google.cloud.discoveryengine.v1beta.Engine] needs to be created separately.
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * If the caller does not have permission to access the
+ * [DataStore][google.cloud.discoveryengine.v1beta.DataStore], regardless of whether or not it
+ * exists, a PERMISSION_DENIED error is returned.
+ * If the requested [DataStore][google.cloud.discoveryengine.v1beta.DataStore] does not
+ * exist, a NOT_FOUND error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final DataStore getDataStore(DataStoreName name) {
+ GetDataStoreRequest request =
+ GetDataStoreRequest.newBuilder().setName(name == null ? null : name.toString()).build();
+ return getDataStore(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets a [DataStore][google.cloud.discoveryengine.v1beta.DataStore].
+ *
+ * Sample code:
+ *
+ * If the caller does not have permission to access the
+ * [DataStore][google.cloud.discoveryengine.v1beta.DataStore], regardless of whether or not it
+ * exists, a PERMISSION_DENIED error is returned.
+ * If the requested [DataStore][google.cloud.discoveryengine.v1beta.DataStore] does not
+ * exist, a NOT_FOUND error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final DataStore getDataStore(String name) {
+ GetDataStoreRequest request = GetDataStoreRequest.newBuilder().setName(name).build();
+ return getDataStore(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets a [DataStore][google.cloud.discoveryengine.v1beta.DataStore].
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * If the caller does not have permission to list
+ * [DataStore][google.cloud.discoveryengine.v1beta.DataStore]s under this location, regardless
+ * of whether or not this data store exists, a PERMISSION_DENIED error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListDataStoresPagedResponse listDataStores(CollectionName parent) {
+ ListDataStoresRequest request =
+ ListDataStoresRequest.newBuilder()
+ .setParent(parent == null ? null : parent.toString())
+ .build();
+ return listDataStores(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists all the [DataStore][google.cloud.discoveryengine.v1beta.DataStore]s associated with the
+ * project.
+ *
+ * Sample code:
+ *
+ * If the caller does not have permission to list
+ * [DataStore][google.cloud.discoveryengine.v1beta.DataStore]s under this location, regardless
+ * of whether or not this data store exists, a PERMISSION_DENIED error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListDataStoresPagedResponse listDataStores(String parent) {
+ ListDataStoresRequest request = ListDataStoresRequest.newBuilder().setParent(parent).build();
+ return listDataStores(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists all the [DataStore][google.cloud.discoveryengine.v1beta.DataStore]s associated with the
+ * project.
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * If the caller does not have permission to delete the
+ * [DataStore][google.cloud.discoveryengine.v1beta.DataStore], regardless of whether or not it
+ * exists, a PERMISSION_DENIED error is returned.
+ * If the [DataStore][google.cloud.discoveryengine.v1beta.DataStore] to delete does not
+ * exist, a NOT_FOUND error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture Sample code:
+ *
+ * If the caller does not have permission to delete the
+ * [DataStore][google.cloud.discoveryengine.v1beta.DataStore], regardless of whether or not it
+ * exists, a PERMISSION_DENIED error is returned.
+ * If the [DataStore][google.cloud.discoveryengine.v1beta.DataStore] to delete does not
+ * exist, a NOT_FOUND error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * If the caller does not have permission to update the
+ * [DataStore][google.cloud.discoveryengine.v1beta.DataStore], regardless of whether or not it
+ * exists, a PERMISSION_DENIED error is returned.
+ * If the [DataStore][google.cloud.discoveryengine.v1beta.DataStore] to update does not
+ * exist, a NOT_FOUND error is returned.
+ * @param updateMask Indicates which fields in the provided
+ * [DataStore][google.cloud.discoveryengine.v1beta.DataStore] to update.
+ * If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final DataStore updateDataStore(DataStore dataStore, FieldMask updateMask) {
+ UpdateDataStoreRequest request =
+ UpdateDataStoreRequest.newBuilder()
+ .setDataStore(dataStore)
+ .setUpdateMask(updateMask)
+ .build();
+ return updateDataStore(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Updates a [DataStore][google.cloud.discoveryengine.v1beta.DataStore]
+ *
+ * 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 getDataStore to 30 seconds:
+ *
+ * Note: This method does not support applying settings to streaming methods.
+ */
+ public Builder applyToAllUnaryMethods(
+ ApiFunction 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 EngineServiceClient object to clean up resources such
+ * as threads. In the example above, try-with-resources is used, which automatically calls close().
+ *
+ * CreateEngine Creates a [Engine][google.cloud.discoveryengine.v1beta.Engine]. Request object method variants only take one parameter, a request object, which must be constructed before the call. createEngineAsync(CreateEngineRequest request)
+ * Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. createEngineAsync(CollectionName parent, Engine engine, String engineId)
+ * createEngineAsync(String parent, Engine engine, String engineId)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. createEngineOperationCallable()
+ * createEngineCallable()
+ * DeleteEngine Deletes a [Engine][google.cloud.discoveryengine.v1beta.Engine]. Request object method variants only take one parameter, a request object, which must be constructed before the call. deleteEngineAsync(DeleteEngineRequest request)
+ * Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. deleteEngineAsync(EngineName name)
+ * deleteEngineAsync(String name)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. deleteEngineOperationCallable()
+ * deleteEngineCallable()
+ * UpdateEngine Updates an [Engine][google.cloud.discoveryengine.v1beta.Engine] Request object method variants only take one parameter, a request object, which must be constructed before the call. updateEngine(UpdateEngineRequest request)
+ * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. updateEngine(Engine engine, FieldMask updateMask)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. updateEngineCallable()
+ * GetEngine Gets a [Engine][google.cloud.discoveryengine.v1beta.Engine]. Request object method variants only take one parameter, a request object, which must be constructed before the call. getEngine(GetEngineRequest request)
+ * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. getEngine(EngineName name)
+ * getEngine(String name)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. getEngineCallable()
+ * ListEngines Lists all the [Engine][google.cloud.discoveryengine.v1beta.Engine]s associated with the project. Request object method variants only take one parameter, a request object, which must be constructed before the call. listEngines(ListEnginesRequest request)
+ * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. listEngines(CollectionName parent)
+ * listEngines(String parent)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. listEnginesPagedCallable()
+ * listEnginesCallable()
+ * 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 EngineServiceSettings 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 EngineServiceClient implements BackgroundResource {
+ private final EngineServiceSettings settings;
+ private final EngineServiceStub stub;
+ private final OperationsClient httpJsonOperationsClient;
+ private final com.google.longrunning.OperationsClient operationsClient;
+
+ /** Constructs an instance of EngineServiceClient with default settings. */
+ public static final EngineServiceClient create() throws IOException {
+ return create(EngineServiceSettings.newBuilder().build());
+ }
+
+ /**
+ * Constructs an instance of EngineServiceClient, 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 EngineServiceClient create(EngineServiceSettings settings)
+ throws IOException {
+ return new EngineServiceClient(settings);
+ }
+
+ /**
+ * Constructs an instance of EngineServiceClient, using the given stub for making calls. This is
+ * for advanced usage - prefer using create(EngineServiceSettings).
+ */
+ public static final EngineServiceClient create(EngineServiceStub stub) {
+ return new EngineServiceClient(stub);
+ }
+
+ /**
+ * Constructs an instance of EngineServiceClient, 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 EngineServiceClient(EngineServiceSettings settings) throws IOException {
+ this.settings = settings;
+ this.stub = ((EngineServiceStubSettings) settings.getStubSettings()).createStub();
+ this.operationsClient =
+ com.google.longrunning.OperationsClient.create(this.stub.getOperationsStub());
+ this.httpJsonOperationsClient = OperationsClient.create(this.stub.getHttpJsonOperationsStub());
+ }
+
+ protected EngineServiceClient(EngineServiceStub 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 EngineServiceSettings getSettings() {
+ return settings;
+ }
+
+ public EngineServiceStub 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 [Engine][google.cloud.discoveryengine.v1beta.Engine].
+ *
+ * Sample code:
+ *
+ * This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with
+ * a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture Sample code:
+ *
+ * This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with
+ * a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * If the caller does not have permission to delete the
+ * [Engine][google.cloud.discoveryengine.v1beta.Engine], regardless of whether or not it
+ * exists, a PERMISSION_DENIED error is returned.
+ * If the [Engine][google.cloud.discoveryengine.v1beta.Engine] to delete does not exist, a
+ * NOT_FOUND error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture Sample code:
+ *
+ * If the caller does not have permission to delete the
+ * [Engine][google.cloud.discoveryengine.v1beta.Engine], regardless of whether or not it
+ * exists, a PERMISSION_DENIED error is returned.
+ * If the [Engine][google.cloud.discoveryengine.v1beta.Engine] to delete does not exist, a
+ * NOT_FOUND error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * If the caller does not have permission to update the
+ * [Engine][google.cloud.discoveryengine.v1beta.Engine], regardless of whether or not it
+ * exists, a PERMISSION_DENIED error is returned.
+ * If the [Engine][google.cloud.discoveryengine.v1beta.Engine] to update does not exist, a
+ * NOT_FOUND error is returned.
+ * @param updateMask Indicates which fields in the provided
+ * [Engine][google.cloud.discoveryengine.v1beta.Engine] to update.
+ * If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Engine updateEngine(Engine engine, FieldMask updateMask) {
+ UpdateEngineRequest request =
+ UpdateEngineRequest.newBuilder().setEngine(engine).setUpdateMask(updateMask).build();
+ return updateEngine(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Updates an [Engine][google.cloud.discoveryengine.v1beta.Engine]
+ *
+ * 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 updateEngine to 30 seconds:
+ *
+ * Note: This method does not support applying settings to streaming methods.
+ */
+ public Builder applyToAllUnaryMethods(
+ ApiFunction 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 ServingConfigServiceClient object to clean up
+ * resources such as threads. In the example above, try-with-resources is used, which automatically
+ * calls close().
+ *
+ * UpdateServingConfig Updates a ServingConfig.
+ * Returns a NOT_FOUND error if the ServingConfig does not exist. Request object method variants only take one parameter, a request object, which must be constructed before the call. updateServingConfig(UpdateServingConfigRequest request)
+ * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. updateServingConfig(ServingConfig servingConfig, FieldMask updateMask)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. updateServingConfigCallable()
+ * GetServingConfig Gets a ServingConfig.
+ * Returns a NotFound error if the ServingConfig does not exist. Request object method variants only take one parameter, a request object, which must be constructed before the call. getServingConfig(GetServingConfigRequest request)
+ * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. getServingConfig(ServingConfigName name)
+ * getServingConfig(String name)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. getServingConfigCallable()
+ * ListServingConfigs Lists all ServingConfigs linked to this dataStore. Request object method variants only take one parameter, a request object, which must be constructed before the call. listServingConfigs(ListServingConfigsRequest request)
+ * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. listServingConfigs(DataStoreName parent)
+ * listServingConfigs(String parent)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. listServingConfigsPagedCallable()
+ * listServingConfigsCallable()
+ * 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 ServingConfigServiceSettings
+ * 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 ServingConfigServiceClient implements BackgroundResource {
+ private final ServingConfigServiceSettings settings;
+ private final ServingConfigServiceStub stub;
+
+ /** Constructs an instance of ServingConfigServiceClient with default settings. */
+ public static final ServingConfigServiceClient create() throws IOException {
+ return create(ServingConfigServiceSettings.newBuilder().build());
+ }
+
+ /**
+ * Constructs an instance of ServingConfigServiceClient, 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 ServingConfigServiceClient create(ServingConfigServiceSettings settings)
+ throws IOException {
+ return new ServingConfigServiceClient(settings);
+ }
+
+ /**
+ * Constructs an instance of ServingConfigServiceClient, using the given stub for making calls.
+ * This is for advanced usage - prefer using create(ServingConfigServiceSettings).
+ */
+ public static final ServingConfigServiceClient create(ServingConfigServiceStub stub) {
+ return new ServingConfigServiceClient(stub);
+ }
+
+ /**
+ * Constructs an instance of ServingConfigServiceClient, 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 ServingConfigServiceClient(ServingConfigServiceSettings settings) throws IOException {
+ this.settings = settings;
+ this.stub = ((ServingConfigServiceStubSettings) settings.getStubSettings()).createStub();
+ }
+
+ protected ServingConfigServiceClient(ServingConfigServiceStub stub) {
+ this.settings = null;
+ this.stub = stub;
+ }
+
+ public final ServingConfigServiceSettings getSettings() {
+ return settings;
+ }
+
+ public ServingConfigServiceStub getStub() {
+ return stub;
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Updates a ServingConfig.
+ *
+ * Returns a NOT_FOUND error if the ServingConfig does not exist.
+ *
+ * Sample code:
+ *
+ * If not set, all supported fields are updated.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ServingConfig updateServingConfig(
+ ServingConfig servingConfig, FieldMask updateMask) {
+ UpdateServingConfigRequest request =
+ UpdateServingConfigRequest.newBuilder()
+ .setServingConfig(servingConfig)
+ .setUpdateMask(updateMask)
+ .build();
+ return updateServingConfig(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Updates a ServingConfig.
+ *
+ * Returns a NOT_FOUND error if the ServingConfig does not exist.
+ *
+ * Sample code:
+ *
+ * Returns a NOT_FOUND error if the ServingConfig does not exist.
+ *
+ * Sample code:
+ *
+ * Returns a NotFound error if the ServingConfig does not exist.
+ *
+ * Sample code:
+ *
+ * Returns a NotFound error if the ServingConfig does not exist.
+ *
+ * Sample code:
+ *
+ * Returns a NotFound error if the ServingConfig does not exist.
+ *
+ * Sample code:
+ *
+ * Returns a NotFound error if the ServingConfig does not exist.
+ *
+ * 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 updateServingConfig to 30 seconds:
+ *
+ * Note: This method does not support applying settings to streaming methods.
+ */
+ public Builder applyToAllUnaryMethods(
+ ApiFunction 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 SiteSearchEngineServiceClient object to clean up
+ * resources such as threads. In the example above, try-with-resources is used, which automatically
+ * calls close().
+ *
+ * GetSiteSearchEngine Gets the [SiteSearchEngine][google.cloud.discoveryengine.v1beta.SiteSearchEngine]. Request object method variants only take one parameter, a request object, which must be constructed before the call. getSiteSearchEngine(GetSiteSearchEngineRequest request)
+ * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. getSiteSearchEngine(SiteSearchEngineName name)
+ * getSiteSearchEngine(String name)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. getSiteSearchEngineCallable()
+ * CreateTargetSite Creates a [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite]. Request object method variants only take one parameter, a request object, which must be constructed before the call. createTargetSiteAsync(CreateTargetSiteRequest request)
+ * Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. createTargetSiteAsync(SiteSearchEngineName parent, TargetSite targetSite)
+ * createTargetSiteAsync(String parent, TargetSite targetSite)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. createTargetSiteOperationCallable()
+ * createTargetSiteCallable()
+ * BatchCreateTargetSites Creates [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite] in a batch. Request object method variants only take one parameter, a request object, which must be constructed before the call. batchCreateTargetSitesAsync(BatchCreateTargetSitesRequest request)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. batchCreateTargetSitesOperationCallable()
+ * batchCreateTargetSitesCallable()
+ * GetTargetSite Gets a [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite]. Request object method variants only take one parameter, a request object, which must be constructed before the call. getTargetSite(GetTargetSiteRequest request)
+ * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. getTargetSite(TargetSiteName name)
+ * getTargetSite(String name)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. getTargetSiteCallable()
+ * UpdateTargetSite Updates a [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite]. Request object method variants only take one parameter, a request object, which must be constructed before the call. updateTargetSiteAsync(UpdateTargetSiteRequest request)
+ * Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. updateTargetSiteAsync(TargetSite targetSite)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. updateTargetSiteOperationCallable()
+ * updateTargetSiteCallable()
+ * DeleteTargetSite Deletes a [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite]. Request object method variants only take one parameter, a request object, which must be constructed before the call. deleteTargetSiteAsync(DeleteTargetSiteRequest request)
+ * Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. deleteTargetSiteAsync(TargetSiteName name)
+ * deleteTargetSiteAsync(String name)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. deleteTargetSiteOperationCallable()
+ * deleteTargetSiteCallable()
+ * ListTargetSites Gets a list of [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite]s. Request object method variants only take one parameter, a request object, which must be constructed before the call. listTargetSites(ListTargetSitesRequest request)
+ * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. listTargetSites(SiteSearchEngineName parent)
+ * listTargetSites(String parent)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. listTargetSitesPagedCallable()
+ * listTargetSitesCallable()
+ * EnableAdvancedSiteSearch Upgrade from basic site search to advanced site search. Request object method variants only take one parameter, a request object, which must be constructed before the call. enableAdvancedSiteSearchAsync(EnableAdvancedSiteSearchRequest request)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. enableAdvancedSiteSearchOperationCallable()
+ * enableAdvancedSiteSearchCallable()
+ * DisableAdvancedSiteSearch Downgrade from advanced site search to basic site search. Request object method variants only take one parameter, a request object, which must be constructed before the call. disableAdvancedSiteSearchAsync(DisableAdvancedSiteSearchRequest request)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. disableAdvancedSiteSearchOperationCallable()
+ * disableAdvancedSiteSearchCallable()
+ * RecrawlUris Request on-demand recrawl for a list of URIs. Request object method variants only take one parameter, a request object, which must be constructed before the call. recrawlUrisAsync(RecrawlUrisRequest request)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. recrawlUrisOperationCallable()
+ * recrawlUrisCallable()
+ * BatchVerifyTargetSites Verify target sites' ownership and validity. This API sends all the target sites under site search engine for verification. Request object method variants only take one parameter, a request object, which must be constructed before the call. batchVerifyTargetSitesAsync(BatchVerifyTargetSitesRequest request)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. batchVerifyTargetSitesOperationCallable()
+ * batchVerifyTargetSitesCallable()
+ * FetchDomainVerificationStatus Returns list of target sites with its domain verification status. This method can only be called under data store with BASIC_SITE_SEARCH state at the moment. Request object method variants only take one parameter, a request object, which must be constructed before the call. fetchDomainVerificationStatus(FetchDomainVerificationStatusRequest request)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. fetchDomainVerificationStatusPagedCallable()
+ * fetchDomainVerificationStatusCallable()
+ * 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
+ * SiteSearchEngineServiceSettings 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 SiteSearchEngineServiceClient implements BackgroundResource {
+ private final SiteSearchEngineServiceSettings settings;
+ private final SiteSearchEngineServiceStub stub;
+ private final OperationsClient httpJsonOperationsClient;
+ private final com.google.longrunning.OperationsClient operationsClient;
+
+ /** Constructs an instance of SiteSearchEngineServiceClient with default settings. */
+ public static final SiteSearchEngineServiceClient create() throws IOException {
+ return create(SiteSearchEngineServiceSettings.newBuilder().build());
+ }
+
+ /**
+ * Constructs an instance of SiteSearchEngineServiceClient, 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 SiteSearchEngineServiceClient create(SiteSearchEngineServiceSettings settings)
+ throws IOException {
+ return new SiteSearchEngineServiceClient(settings);
+ }
+
+ /**
+ * Constructs an instance of SiteSearchEngineServiceClient, using the given stub for making calls.
+ * This is for advanced usage - prefer using create(SiteSearchEngineServiceSettings).
+ */
+ public static final SiteSearchEngineServiceClient create(SiteSearchEngineServiceStub stub) {
+ return new SiteSearchEngineServiceClient(stub);
+ }
+
+ /**
+ * Constructs an instance of SiteSearchEngineServiceClient, 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 SiteSearchEngineServiceClient(SiteSearchEngineServiceSettings settings)
+ throws IOException {
+ this.settings = settings;
+ this.stub = ((SiteSearchEngineServiceStubSettings) settings.getStubSettings()).createStub();
+ this.operationsClient =
+ com.google.longrunning.OperationsClient.create(this.stub.getOperationsStub());
+ this.httpJsonOperationsClient = OperationsClient.create(this.stub.getHttpJsonOperationsStub());
+ }
+
+ protected SiteSearchEngineServiceClient(SiteSearchEngineServiceStub 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 SiteSearchEngineServiceSettings getSettings() {
+ return settings;
+ }
+
+ public SiteSearchEngineServiceStub 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.
+ /**
+ * Gets the [SiteSearchEngine][google.cloud.discoveryengine.v1beta.SiteSearchEngine].
+ *
+ * Sample code:
+ *
+ * If the caller does not have permission to access the [SiteSearchEngine], regardless of
+ * whether or not it exists, a PERMISSION_DENIED error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final SiteSearchEngine getSiteSearchEngine(SiteSearchEngineName name) {
+ GetSiteSearchEngineRequest request =
+ GetSiteSearchEngineRequest.newBuilder()
+ .setName(name == null ? null : name.toString())
+ .build();
+ return getSiteSearchEngine(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets the [SiteSearchEngine][google.cloud.discoveryengine.v1beta.SiteSearchEngine].
+ *
+ * Sample code:
+ *
+ * If the caller does not have permission to access the [SiteSearchEngine], regardless of
+ * whether or not it exists, a PERMISSION_DENIED error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final SiteSearchEngine getSiteSearchEngine(String name) {
+ GetSiteSearchEngineRequest request =
+ GetSiteSearchEngineRequest.newBuilder().setName(name).build();
+ return getSiteSearchEngine(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets the [SiteSearchEngine][google.cloud.discoveryengine.v1beta.SiteSearchEngine].
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * If the caller does not have permission to access the
+ * [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite], regardless of whether or not
+ * it exists, a PERMISSION_DENIED error is returned.
+ * If the requested [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite] does not
+ * exist, a NOT_FOUND error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final TargetSite getTargetSite(TargetSiteName name) {
+ GetTargetSiteRequest request =
+ GetTargetSiteRequest.newBuilder().setName(name == null ? null : name.toString()).build();
+ return getTargetSite(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets a [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite].
+ *
+ * Sample code:
+ *
+ * If the caller does not have permission to access the
+ * [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite], regardless of whether or not
+ * it exists, a PERMISSION_DENIED error is returned.
+ * If the requested [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite] does not
+ * exist, a NOT_FOUND error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final TargetSite getTargetSite(String name) {
+ GetTargetSiteRequest request = GetTargetSiteRequest.newBuilder().setName(name).build();
+ return getTargetSite(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets a [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite].
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * If the [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite] to update does not
+ * exist, a NOT_FOUND error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * If the caller does not have permission to access the
+ * [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite], regardless of whether or not
+ * it exists, a PERMISSION_DENIED error is returned.
+ * If the requested [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite] does not
+ * exist, a NOT_FOUND error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture Sample code:
+ *
+ * If the caller does not have permission to access the
+ * [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite], regardless of whether or not
+ * it exists, a PERMISSION_DENIED error is returned.
+ * If the requested [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite] does not
+ * exist, a NOT_FOUND error is returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * If the caller does not have permission to list
+ * [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite]s under this site search
+ * engine, regardless of whether or not this branch exists, a PERMISSION_DENIED error is
+ * returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListTargetSitesPagedResponse listTargetSites(SiteSearchEngineName parent) {
+ ListTargetSitesRequest request =
+ ListTargetSitesRequest.newBuilder()
+ .setParent(parent == null ? null : parent.toString())
+ .build();
+ return listTargetSites(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets a list of [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite]s.
+ *
+ * Sample code:
+ *
+ * If the caller does not have permission to list
+ * [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite]s under this site search
+ * engine, regardless of whether or not this branch exists, a PERMISSION_DENIED error is
+ * returned.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListTargetSitesPagedResponse listTargetSites(String parent) {
+ ListTargetSitesRequest request = ListTargetSitesRequest.newBuilder().setParent(parent).build();
+ return listTargetSites(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets a list of [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite]s.
+ *
+ * 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 getSiteSearchEngine to 30 seconds:
+ *
+ * Note: This method does not support applying settings to streaming methods.
+ */
+ public Builder applyToAllUnaryMethods(
+ ApiFunction ======================= DataStoreServiceClient =======================
+ *
+ * Service Description: Service for managing
+ * [DataStore][google.cloud.discoveryengine.v1beta.DataStore] configuration.
+ *
+ * Sample for DataStoreServiceClient:
+ *
+ * ======================= DocumentServiceClient =======================
*
* Service Description: Service for ingesting
@@ -91,6 +111,26 @@
* }
* }
*
+ * ======================= EngineServiceClient =======================
+ *
+ * Service Description: Service for managing [Engine][google.cloud.discoveryengine.v1beta.Engine]
+ * configuration.
+ *
+ * Sample for EngineServiceClient:
+ *
+ * ======================= RecommendationServiceClient =======================
*
* Service Description: Service for making recommendations.
@@ -172,6 +212,7 @@
* .setPageToken("pageToken873572522")
* .setOffset(-1019779949)
* .setFilter("filter-1274492040")
+ * .setCanonicalFilter("canonicalFilter-722283124")
* .setOrderBy("orderBy-1207110587")
* .setUserInfo(UserInfo.newBuilder().build())
* .addAllFacetSpecs(new ArrayList ======================= ServingConfigServiceClient =======================
+ *
+ * Service Description: Service for modifying ServingConfig.
+ *
+ * Sample for ServingConfigServiceClient:
+ *
+ * ======================= SiteSearchEngineServiceClient =======================
+ *
+ * Service Description: Service for managing site search related resources.
+ *
+ * Sample for SiteSearchEngineServiceClient:
+ *
+ * ======================= UserEventServiceClient =======================
*
* Service Description: Service for ingesting end user actions on a website to Discovery Engine
diff --git a/java-discoveryengine/google-cloud-discoveryengine/src/main/java/com/google/cloud/discoveryengine/v1beta/stub/CompletionServiceStub.java b/java-discoveryengine/google-cloud-discoveryengine/src/main/java/com/google/cloud/discoveryengine/v1beta/stub/CompletionServiceStub.java
index 91f87c73c7c2..85611b34df72 100644
--- a/java-discoveryengine/google-cloud-discoveryengine/src/main/java/com/google/cloud/discoveryengine/v1beta/stub/CompletionServiceStub.java
+++ b/java-discoveryengine/google-cloud-discoveryengine/src/main/java/com/google/cloud/discoveryengine/v1beta/stub/CompletionServiceStub.java
@@ -18,9 +18,18 @@
import com.google.api.core.BetaApi;
import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.rpc.OperationCallable;
import com.google.api.gax.rpc.UnaryCallable;
import com.google.cloud.discoveryengine.v1beta.CompleteQueryRequest;
import com.google.cloud.discoveryengine.v1beta.CompleteQueryResponse;
+import com.google.cloud.discoveryengine.v1beta.ImportSuggestionDenyListEntriesMetadata;
+import com.google.cloud.discoveryengine.v1beta.ImportSuggestionDenyListEntriesRequest;
+import com.google.cloud.discoveryengine.v1beta.ImportSuggestionDenyListEntriesResponse;
+import com.google.cloud.discoveryengine.v1beta.PurgeSuggestionDenyListEntriesMetadata;
+import com.google.cloud.discoveryengine.v1beta.PurgeSuggestionDenyListEntriesRequest;
+import com.google.cloud.discoveryengine.v1beta.PurgeSuggestionDenyListEntriesResponse;
+import com.google.longrunning.Operation;
+import com.google.longrunning.stub.OperationsStub;
import javax.annotation.Generated;
// AUTO-GENERATED DOCUMENTATION AND CLASS.
@@ -33,10 +42,48 @@
@Generated("by gapic-generator-java")
public abstract class CompletionServiceStub implements BackgroundResource {
+ public OperationsStub getOperationsStub() {
+ return null;
+ }
+
+ public com.google.api.gax.httpjson.longrunning.stub.OperationsStub getHttpJsonOperationsStub() {
+ return null;
+ }
+
public UnaryCallable This class is for advanced usage and reflects the underlying API directly.
+ */
+@BetaApi
+@Generated("by gapic-generator-java")
+public abstract class DataStoreServiceStub implements BackgroundResource {
+
+ public OperationsStub getOperationsStub() {
+ return null;
+ }
+
+ public com.google.api.gax.httpjson.longrunning.stub.OperationsStub getHttpJsonOperationsStub() {
+ return null;
+ }
+
+ public OperationCallable 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 getDataStore to 30 seconds:
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (CompletionServiceClient completionServiceClient = CompletionServiceClient.create()) {
+ * ImportSuggestionDenyListEntriesRequest request =
+ * ImportSuggestionDenyListEntriesRequest.newBuilder()
+ * .setParent(
+ * DataStoreName.ofProjectLocationCollectionDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[COLLECTION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * ImportSuggestionDenyListEntriesResponse response =
+ * completionServiceClient.importSuggestionDenyListEntriesAsync(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<
+ ImportSuggestionDenyListEntriesResponse, ImportSuggestionDenyListEntriesMetadata>
+ importSuggestionDenyListEntriesAsync(ImportSuggestionDenyListEntriesRequest request) {
+ return importSuggestionDenyListEntriesOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Imports all
+ * [SuggestionDenyListEntry][google.cloud.discoveryengine.v1beta.SuggestionDenyListEntry] for a
+ * DataStore.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (CompletionServiceClient completionServiceClient = CompletionServiceClient.create()) {
+ * ImportSuggestionDenyListEntriesRequest request =
+ * ImportSuggestionDenyListEntriesRequest.newBuilder()
+ * .setParent(
+ * DataStoreName.ofProjectLocationCollectionDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[COLLECTION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * OperationFuture<
+ * ImportSuggestionDenyListEntriesResponse, ImportSuggestionDenyListEntriesMetadata>
+ * future =
+ * completionServiceClient
+ * .importSuggestionDenyListEntriesOperationCallable()
+ * .futureCall(request);
+ * // Do something.
+ * ImportSuggestionDenyListEntriesResponse response = future.get();
+ * }
+ * }
+ */
+ public final OperationCallable<
+ ImportSuggestionDenyListEntriesRequest,
+ ImportSuggestionDenyListEntriesResponse,
+ ImportSuggestionDenyListEntriesMetadata>
+ importSuggestionDenyListEntriesOperationCallable() {
+ return stub.importSuggestionDenyListEntriesOperationCallable();
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Imports all
+ * [SuggestionDenyListEntry][google.cloud.discoveryengine.v1beta.SuggestionDenyListEntry] for a
+ * DataStore.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (CompletionServiceClient completionServiceClient = CompletionServiceClient.create()) {
+ * ImportSuggestionDenyListEntriesRequest request =
+ * ImportSuggestionDenyListEntriesRequest.newBuilder()
+ * .setParent(
+ * DataStoreName.ofProjectLocationCollectionDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[COLLECTION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (CompletionServiceClient completionServiceClient = CompletionServiceClient.create()) {
+ * PurgeSuggestionDenyListEntriesRequest request =
+ * PurgeSuggestionDenyListEntriesRequest.newBuilder()
+ * .setParent(
+ * DataStoreName.ofProjectLocationCollectionDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[COLLECTION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * PurgeSuggestionDenyListEntriesResponse response =
+ * completionServiceClient.purgeSuggestionDenyListEntriesAsync(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<
+ PurgeSuggestionDenyListEntriesResponse, PurgeSuggestionDenyListEntriesMetadata>
+ purgeSuggestionDenyListEntriesAsync(PurgeSuggestionDenyListEntriesRequest request) {
+ return purgeSuggestionDenyListEntriesOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Permanently deletes all
+ * [SuggestionDenyListEntry][google.cloud.discoveryengine.v1beta.SuggestionDenyListEntry] for a
+ * DataStore.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (CompletionServiceClient completionServiceClient = CompletionServiceClient.create()) {
+ * PurgeSuggestionDenyListEntriesRequest request =
+ * PurgeSuggestionDenyListEntriesRequest.newBuilder()
+ * .setParent(
+ * DataStoreName.ofProjectLocationCollectionDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[COLLECTION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * OperationFuture<
+ * PurgeSuggestionDenyListEntriesResponse, PurgeSuggestionDenyListEntriesMetadata>
+ * future =
+ * completionServiceClient
+ * .purgeSuggestionDenyListEntriesOperationCallable()
+ * .futureCall(request);
+ * // Do something.
+ * PurgeSuggestionDenyListEntriesResponse response = future.get();
+ * }
+ * }
+ */
+ public final OperationCallable<
+ PurgeSuggestionDenyListEntriesRequest,
+ PurgeSuggestionDenyListEntriesResponse,
+ PurgeSuggestionDenyListEntriesMetadata>
+ purgeSuggestionDenyListEntriesOperationCallable() {
+ return stub.purgeSuggestionDenyListEntriesOperationCallable();
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Permanently deletes all
+ * [SuggestionDenyListEntry][google.cloud.discoveryengine.v1beta.SuggestionDenyListEntry] for a
+ * DataStore.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (CompletionServiceClient completionServiceClient = CompletionServiceClient.create()) {
+ * PurgeSuggestionDenyListEntriesRequest request =
+ * PurgeSuggestionDenyListEntriesRequest.newBuilder()
+ * .setParent(
+ * DataStoreName.ofProjectLocationCollectionDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[COLLECTION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable
- *
* {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * DataStoreName name =
+ * DataStoreName.ofProjectLocationDataStoreName("[PROJECT]", "[LOCATION]", "[DATA_STORE]");
+ * DataStore response = dataStoreServiceClient.getDataStore(name);
+ * }
+ * }
+ *
+ *
+ *
+ *
+ *
+ *
+ * Method
+ * Description
+ * Method Variants
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * DataStoreServiceSettings dataStoreServiceSettings =
+ * DataStoreServiceSettings.newBuilder()
+ * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
+ * .build();
+ * DataStoreServiceClient dataStoreServiceClient =
+ * DataStoreServiceClient.create(dataStoreServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * DataStoreServiceSettings dataStoreServiceSettings =
+ * DataStoreServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
+ * DataStoreServiceClient dataStoreServiceClient =
+ * DataStoreServiceClient.create(dataStoreServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * DataStoreServiceSettings dataStoreServiceSettings =
+ * DataStoreServiceSettings.newHttpJsonBuilder().build();
+ * DataStoreServiceClient dataStoreServiceClient =
+ * DataStoreServiceClient.create(dataStoreServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * CollectionName parent = CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]");
+ * DataStore dataStore = DataStore.newBuilder().build();
+ * String dataStoreId = "dataStoreId929489618";
+ * DataStore response =
+ * dataStoreServiceClient.createDataStoreAsync(parent, dataStore, dataStoreId).get();
+ * }
+ * }
+ *
+ * @param parent Required. The parent resource name, such as
+ * `projects/{project}/locations/{location}/collections/{collection}`.
+ * @param dataStore Required. The [DataStore][google.cloud.discoveryengine.v1beta.DataStore] to
+ * create.
+ * @param dataStoreId Required. The ID to use for the
+ * [DataStore][google.cloud.discoveryengine.v1beta.DataStore], which will become the final
+ * component of the [DataStore][google.cloud.discoveryengine.v1beta.DataStore]'s resource
+ * name.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * String parent = CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]").toString();
+ * DataStore dataStore = DataStore.newBuilder().build();
+ * String dataStoreId = "dataStoreId929489618";
+ * DataStore response =
+ * dataStoreServiceClient.createDataStoreAsync(parent, dataStore, dataStoreId).get();
+ * }
+ * }
+ *
+ * @param parent Required. The parent resource name, such as
+ * `projects/{project}/locations/{location}/collections/{collection}`.
+ * @param dataStore Required. The [DataStore][google.cloud.discoveryengine.v1beta.DataStore] to
+ * create.
+ * @param dataStoreId Required. The ID to use for the
+ * [DataStore][google.cloud.discoveryengine.v1beta.DataStore], which will become the final
+ * component of the [DataStore][google.cloud.discoveryengine.v1beta.DataStore]'s resource
+ * name.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * CreateDataStoreRequest request =
+ * CreateDataStoreRequest.newBuilder()
+ * .setParent(CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]").toString())
+ * .setDataStore(DataStore.newBuilder().build())
+ * .setDataStoreId("dataStoreId929489618")
+ * .setCreateAdvancedSiteSearch(true)
+ * .build();
+ * DataStore response = dataStoreServiceClient.createDataStoreAsync(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 and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * CreateDataStoreRequest request =
+ * CreateDataStoreRequest.newBuilder()
+ * .setParent(CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]").toString())
+ * .setDataStore(DataStore.newBuilder().build())
+ * .setDataStoreId("dataStoreId929489618")
+ * .setCreateAdvancedSiteSearch(true)
+ * .build();
+ * OperationFuture
+ */
+ public final OperationCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * CreateDataStoreRequest request =
+ * CreateDataStoreRequest.newBuilder()
+ * .setParent(CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]").toString())
+ * .setDataStore(DataStore.newBuilder().build())
+ * .setDataStoreId("dataStoreId929489618")
+ * .setCreateAdvancedSiteSearch(true)
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * DataStoreName name =
+ * DataStoreName.ofProjectLocationDataStoreName("[PROJECT]", "[LOCATION]", "[DATA_STORE]");
+ * DataStore response = dataStoreServiceClient.getDataStore(name);
+ * }
+ * }
+ *
+ * @param name Required. Full resource name of
+ * [DataStore][google.cloud.discoveryengine.v1beta.DataStore], such as
+ * `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * String name =
+ * DataStoreName.ofProjectLocationDataStoreName("[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString();
+ * DataStore response = dataStoreServiceClient.getDataStore(name);
+ * }
+ * }
+ *
+ * @param name Required. Full resource name of
+ * [DataStore][google.cloud.discoveryengine.v1beta.DataStore], such as
+ * `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * GetDataStoreRequest request =
+ * GetDataStoreRequest.newBuilder()
+ * .setName(
+ * DataStoreName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * DataStore response = dataStoreServiceClient.getDataStore(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 DataStore getDataStore(GetDataStoreRequest request) {
+ return getDataStoreCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets a [DataStore][google.cloud.discoveryengine.v1beta.DataStore].
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * GetDataStoreRequest request =
+ * GetDataStoreRequest.newBuilder()
+ * .setName(
+ * DataStoreName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * CollectionName parent = CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]");
+ * for (DataStore element : dataStoreServiceClient.listDataStores(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The parent branch resource name, such as
+ * `projects/{project}/locations/{location}/collections/{collection_id}`.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * String parent = CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]").toString();
+ * for (DataStore element : dataStoreServiceClient.listDataStores(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The parent branch resource name, such as
+ * `projects/{project}/locations/{location}/collections/{collection_id}`.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * ListDataStoresRequest request =
+ * ListDataStoresRequest.newBuilder()
+ * .setParent(CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .setFilter("filter-1274492040")
+ * .build();
+ * for (DataStore element : dataStoreServiceClient.listDataStores(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 ListDataStoresPagedResponse listDataStores(ListDataStoresRequest request) {
+ return listDataStoresPagedCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists all the [DataStore][google.cloud.discoveryengine.v1beta.DataStore]s associated with the
+ * project.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * ListDataStoresRequest request =
+ * ListDataStoresRequest.newBuilder()
+ * .setParent(CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .setFilter("filter-1274492040")
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * ListDataStoresRequest request =
+ * ListDataStoresRequest.newBuilder()
+ * .setParent(CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .setFilter("filter-1274492040")
+ * .build();
+ * while (true) {
+ * ListDataStoresResponse response =
+ * dataStoreServiceClient.listDataStoresCallable().call(request);
+ * for (DataStore element : response.getDataStoresList()) {
+ * // 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 and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * DataStoreName name =
+ * DataStoreName.ofProjectLocationDataStoreName("[PROJECT]", "[LOCATION]", "[DATA_STORE]");
+ * dataStoreServiceClient.deleteDataStoreAsync(name).get();
+ * }
+ * }
+ *
+ * @param name Required. Full resource name of
+ * [DataStore][google.cloud.discoveryengine.v1beta.DataStore], such as
+ * `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * String name =
+ * DataStoreName.ofProjectLocationDataStoreName("[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString();
+ * dataStoreServiceClient.deleteDataStoreAsync(name).get();
+ * }
+ * }
+ *
+ * @param name Required. Full resource name of
+ * [DataStore][google.cloud.discoveryengine.v1beta.DataStore], such as
+ * `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * DeleteDataStoreRequest request =
+ * DeleteDataStoreRequest.newBuilder()
+ * .setName(
+ * DataStoreName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * dataStoreServiceClient.deleteDataStoreAsync(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 and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * DeleteDataStoreRequest request =
+ * DeleteDataStoreRequest.newBuilder()
+ * .setName(
+ * DataStoreName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * OperationFuture
+ */
+ public final OperationCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * DeleteDataStoreRequest request =
+ * DeleteDataStoreRequest.newBuilder()
+ * .setName(
+ * DataStoreName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * DataStore dataStore = DataStore.newBuilder().build();
+ * FieldMask updateMask = FieldMask.newBuilder().build();
+ * DataStore response = dataStoreServiceClient.updateDataStore(dataStore, updateMask);
+ * }
+ * }
+ *
+ * @param dataStore Required. The [DataStore][google.cloud.discoveryengine.v1beta.DataStore] to
+ * update.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * UpdateDataStoreRequest request =
+ * UpdateDataStoreRequest.newBuilder()
+ * .setDataStore(DataStore.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .build();
+ * DataStore response = dataStoreServiceClient.updateDataStore(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 DataStore updateDataStore(UpdateDataStoreRequest request) {
+ return updateDataStoreCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Updates a [DataStore][google.cloud.discoveryengine.v1beta.DataStore]
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * UpdateDataStoreRequest request =
+ * UpdateDataStoreRequest.newBuilder()
+ * .setDataStore(DataStore.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable
+ *
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * DataStoreServiceSettings.Builder dataStoreServiceSettingsBuilder =
+ * DataStoreServiceSettings.newBuilder();
+ * dataStoreServiceSettingsBuilder
+ * .getDataStoreSettings()
+ * .setRetrySettings(
+ * dataStoreServiceSettingsBuilder
+ * .getDataStoreSettings()
+ * .getRetrySettings()
+ * .toBuilder()
+ * .setTotalTimeout(Duration.ofSeconds(30))
+ * .build());
+ * DataStoreServiceSettings dataStoreServiceSettings = dataStoreServiceSettingsBuilder.build();
+ * }
+ */
+@BetaApi
+@Generated("by gapic-generator-java")
+public class DataStoreServiceSettings extends ClientSettings{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * Engine engine = Engine.newBuilder().build();
+ * FieldMask updateMask = FieldMask.newBuilder().build();
+ * Engine response = engineServiceClient.updateEngine(engine, updateMask);
+ * }
+ * }
+ *
+ *
+ *
+ *
+ *
+ *
+ * Method
+ * Description
+ * Method Variants
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * EngineServiceSettings engineServiceSettings =
+ * EngineServiceSettings.newBuilder()
+ * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
+ * .build();
+ * EngineServiceClient engineServiceClient = EngineServiceClient.create(engineServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * EngineServiceSettings engineServiceSettings =
+ * EngineServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
+ * EngineServiceClient engineServiceClient = EngineServiceClient.create(engineServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * EngineServiceSettings engineServiceSettings =
+ * EngineServiceSettings.newHttpJsonBuilder().build();
+ * EngineServiceClient engineServiceClient = EngineServiceClient.create(engineServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * CollectionName parent = CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]");
+ * Engine engine = Engine.newBuilder().build();
+ * String engineId = "engineId1820490493";
+ * Engine response = engineServiceClient.createEngineAsync(parent, engine, engineId).get();
+ * }
+ * }
+ *
+ * @param parent Required. The parent resource name, such as
+ * `projects/{project}/locations/{location}/collections/{collection}`.
+ * @param engine Required. The [Engine][google.cloud.discoveryengine.v1beta.Engine] to create.
+ * @param engineId Required. The ID to use for the
+ * [Engine][google.cloud.discoveryengine.v1beta.Engine], which will become the final component
+ * of the [Engine][google.cloud.discoveryengine.v1beta.Engine]'s resource name.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * String parent = CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]").toString();
+ * Engine engine = Engine.newBuilder().build();
+ * String engineId = "engineId1820490493";
+ * Engine response = engineServiceClient.createEngineAsync(parent, engine, engineId).get();
+ * }
+ * }
+ *
+ * @param parent Required. The parent resource name, such as
+ * `projects/{project}/locations/{location}/collections/{collection}`.
+ * @param engine Required. The [Engine][google.cloud.discoveryengine.v1beta.Engine] to create.
+ * @param engineId Required. The ID to use for the
+ * [Engine][google.cloud.discoveryengine.v1beta.Engine], which will become the final component
+ * of the [Engine][google.cloud.discoveryengine.v1beta.Engine]'s resource name.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * CreateEngineRequest request =
+ * CreateEngineRequest.newBuilder()
+ * .setParent(CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]").toString())
+ * .setEngine(Engine.newBuilder().build())
+ * .setEngineId("engineId1820490493")
+ * .build();
+ * Engine response = engineServiceClient.createEngineAsync(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 and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * CreateEngineRequest request =
+ * CreateEngineRequest.newBuilder()
+ * .setParent(CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]").toString())
+ * .setEngine(Engine.newBuilder().build())
+ * .setEngineId("engineId1820490493")
+ * .build();
+ * OperationFuture
+ */
+ public final OperationCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * CreateEngineRequest request =
+ * CreateEngineRequest.newBuilder()
+ * .setParent(CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]").toString())
+ * .setEngine(Engine.newBuilder().build())
+ * .setEngineId("engineId1820490493")
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * EngineName name = EngineName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]", "[ENGINE]");
+ * engineServiceClient.deleteEngineAsync(name).get();
+ * }
+ * }
+ *
+ * @param name Required. Full resource name of
+ * [Engine][google.cloud.discoveryengine.v1beta.Engine], such as
+ * `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * String name = EngineName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]", "[ENGINE]").toString();
+ * engineServiceClient.deleteEngineAsync(name).get();
+ * }
+ * }
+ *
+ * @param name Required. Full resource name of
+ * [Engine][google.cloud.discoveryengine.v1beta.Engine], such as
+ * `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * DeleteEngineRequest request =
+ * DeleteEngineRequest.newBuilder()
+ * .setName(
+ * EngineName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]", "[ENGINE]").toString())
+ * .build();
+ * engineServiceClient.deleteEngineAsync(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 and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * DeleteEngineRequest request =
+ * DeleteEngineRequest.newBuilder()
+ * .setName(
+ * EngineName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]", "[ENGINE]").toString())
+ * .build();
+ * OperationFuture
+ */
+ public final OperationCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * DeleteEngineRequest request =
+ * DeleteEngineRequest.newBuilder()
+ * .setName(
+ * EngineName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]", "[ENGINE]").toString())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * Engine engine = Engine.newBuilder().build();
+ * FieldMask updateMask = FieldMask.newBuilder().build();
+ * Engine response = engineServiceClient.updateEngine(engine, updateMask);
+ * }
+ * }
+ *
+ * @param engine Required. The [Engine][google.cloud.discoveryengine.v1beta.Engine] to update.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * UpdateEngineRequest request =
+ * UpdateEngineRequest.newBuilder()
+ * .setEngine(Engine.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .build();
+ * Engine response = engineServiceClient.updateEngine(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 Engine updateEngine(UpdateEngineRequest request) {
+ return updateEngineCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Updates an [Engine][google.cloud.discoveryengine.v1beta.Engine]
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * UpdateEngineRequest request =
+ * UpdateEngineRequest.newBuilder()
+ * .setEngine(Engine.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * EngineName name = EngineName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]", "[ENGINE]");
+ * Engine response = engineServiceClient.getEngine(name);
+ * }
+ * }
+ *
+ * @param name Required. Full resource name of
+ * [Engine][google.cloud.discoveryengine.v1beta.Engine], such as
+ * `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Engine getEngine(EngineName name) {
+ GetEngineRequest request =
+ GetEngineRequest.newBuilder().setName(name == null ? null : name.toString()).build();
+ return getEngine(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets a [Engine][google.cloud.discoveryengine.v1beta.Engine].
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * String name = EngineName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]", "[ENGINE]").toString();
+ * Engine response = engineServiceClient.getEngine(name);
+ * }
+ * }
+ *
+ * @param name Required. Full resource name of
+ * [Engine][google.cloud.discoveryengine.v1beta.Engine], such as
+ * `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final Engine getEngine(String name) {
+ GetEngineRequest request = GetEngineRequest.newBuilder().setName(name).build();
+ return getEngine(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets a [Engine][google.cloud.discoveryengine.v1beta.Engine].
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * GetEngineRequest request =
+ * GetEngineRequest.newBuilder()
+ * .setName(
+ * EngineName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]", "[ENGINE]").toString())
+ * .build();
+ * Engine response = engineServiceClient.getEngine(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 Engine getEngine(GetEngineRequest request) {
+ return getEngineCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets a [Engine][google.cloud.discoveryengine.v1beta.Engine].
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * GetEngineRequest request =
+ * GetEngineRequest.newBuilder()
+ * .setName(
+ * EngineName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]", "[ENGINE]").toString())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * CollectionName parent = CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]");
+ * for (Engine element : engineServiceClient.listEngines(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The parent resource name, such as
+ * `projects/{project}/locations/{location}/collections/{collection_id}`.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListEnginesPagedResponse listEngines(CollectionName parent) {
+ ListEnginesRequest request =
+ ListEnginesRequest.newBuilder()
+ .setParent(parent == null ? null : parent.toString())
+ .build();
+ return listEngines(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists all the [Engine][google.cloud.discoveryengine.v1beta.Engine]s associated with the
+ * project.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * String parent = CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]").toString();
+ * for (Engine element : engineServiceClient.listEngines(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The parent resource name, such as
+ * `projects/{project}/locations/{location}/collections/{collection_id}`.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListEnginesPagedResponse listEngines(String parent) {
+ ListEnginesRequest request = ListEnginesRequest.newBuilder().setParent(parent).build();
+ return listEngines(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists all the [Engine][google.cloud.discoveryengine.v1beta.Engine]s associated with the
+ * project.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * ListEnginesRequest request =
+ * ListEnginesRequest.newBuilder()
+ * .setParent(CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .setFilter("filter-1274492040")
+ * .build();
+ * for (Engine element : engineServiceClient.listEngines(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 ListEnginesPagedResponse listEngines(ListEnginesRequest request) {
+ return listEnginesPagedCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists all the [Engine][google.cloud.discoveryengine.v1beta.Engine]s associated with the
+ * project.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * ListEnginesRequest request =
+ * ListEnginesRequest.newBuilder()
+ * .setParent(CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .setFilter("filter-1274492040")
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * ListEnginesRequest request =
+ * ListEnginesRequest.newBuilder()
+ * .setParent(CollectionName.of("[PROJECT]", "[LOCATION]", "[COLLECTION]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .setFilter("filter-1274492040")
+ * .build();
+ * while (true) {
+ * ListEnginesResponse response = engineServiceClient.listEnginesCallable().call(request);
+ * for (Engine element : response.getEnginesList()) {
+ * // 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 and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * EngineServiceSettings.Builder engineServiceSettingsBuilder = EngineServiceSettings.newBuilder();
+ * engineServiceSettingsBuilder
+ * .updateEngineSettings()
+ * .setRetrySettings(
+ * engineServiceSettingsBuilder
+ * .updateEngineSettings()
+ * .getRetrySettings()
+ * .toBuilder()
+ * .setTotalTimeout(Duration.ofSeconds(30))
+ * .build());
+ * EngineServiceSettings engineServiceSettings = engineServiceSettingsBuilder.build();
+ * }
+ */
+@BetaApi
+@Generated("by gapic-generator-java")
+public class EngineServiceSettings extends ClientSettings{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (ServingConfigServiceClient servingConfigServiceClient =
+ * ServingConfigServiceClient.create()) {
+ * ServingConfig servingConfig = ServingConfig.newBuilder().build();
+ * FieldMask updateMask = FieldMask.newBuilder().build();
+ * ServingConfig response =
+ * servingConfigServiceClient.updateServingConfig(servingConfig, updateMask);
+ * }
+ * }
+ *
+ *
+ *
+ *
+ *
+ *
+ * Method
+ * Description
+ * Method Variants
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * ServingConfigServiceSettings servingConfigServiceSettings =
+ * ServingConfigServiceSettings.newBuilder()
+ * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
+ * .build();
+ * ServingConfigServiceClient servingConfigServiceClient =
+ * ServingConfigServiceClient.create(servingConfigServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * ServingConfigServiceSettings servingConfigServiceSettings =
+ * ServingConfigServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
+ * ServingConfigServiceClient servingConfigServiceClient =
+ * ServingConfigServiceClient.create(servingConfigServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * ServingConfigServiceSettings servingConfigServiceSettings =
+ * ServingConfigServiceSettings.newHttpJsonBuilder().build();
+ * ServingConfigServiceClient servingConfigServiceClient =
+ * ServingConfigServiceClient.create(servingConfigServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (ServingConfigServiceClient servingConfigServiceClient =
+ * ServingConfigServiceClient.create()) {
+ * ServingConfig servingConfig = ServingConfig.newBuilder().build();
+ * FieldMask updateMask = FieldMask.newBuilder().build();
+ * ServingConfig response =
+ * servingConfigServiceClient.updateServingConfig(servingConfig, updateMask);
+ * }
+ * }
+ *
+ * @param servingConfig Required. The ServingConfig to update.
+ * @param updateMask Indicates which fields in the provided
+ * [ServingConfig][google.cloud.discoveryengine.v1beta.ServingConfig] to update. The following
+ * are NOT supported:
+ *
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (ServingConfigServiceClient servingConfigServiceClient =
+ * ServingConfigServiceClient.create()) {
+ * UpdateServingConfigRequest request =
+ * UpdateServingConfigRequest.newBuilder()
+ * .setServingConfig(ServingConfig.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .build();
+ * ServingConfig response = servingConfigServiceClient.updateServingConfig(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 ServingConfig updateServingConfig(UpdateServingConfigRequest request) {
+ return updateServingConfigCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Updates a ServingConfig.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (ServingConfigServiceClient servingConfigServiceClient =
+ * ServingConfigServiceClient.create()) {
+ * UpdateServingConfigRequest request =
+ * UpdateServingConfigRequest.newBuilder()
+ * .setServingConfig(ServingConfig.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (ServingConfigServiceClient servingConfigServiceClient =
+ * ServingConfigServiceClient.create()) {
+ * ServingConfigName name =
+ * ServingConfigName.ofProjectLocationDataStoreServingConfigName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[SERVING_CONFIG]");
+ * ServingConfig response = servingConfigServiceClient.getServingConfig(name);
+ * }
+ * }
+ *
+ * @param name Required. The resource name of the ServingConfig to get. Format:
+ * `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}/servingConfigs/{serving_config_id}`
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ServingConfig getServingConfig(ServingConfigName name) {
+ GetServingConfigRequest request =
+ GetServingConfigRequest.newBuilder().setName(name == null ? null : name.toString()).build();
+ return getServingConfig(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets a ServingConfig.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (ServingConfigServiceClient servingConfigServiceClient =
+ * ServingConfigServiceClient.create()) {
+ * String name =
+ * ServingConfigName.ofProjectLocationDataStoreServingConfigName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[SERVING_CONFIG]")
+ * .toString();
+ * ServingConfig response = servingConfigServiceClient.getServingConfig(name);
+ * }
+ * }
+ *
+ * @param name Required. The resource name of the ServingConfig to get. Format:
+ * `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}/servingConfigs/{serving_config_id}`
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ServingConfig getServingConfig(String name) {
+ GetServingConfigRequest request = GetServingConfigRequest.newBuilder().setName(name).build();
+ return getServingConfig(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets a ServingConfig.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (ServingConfigServiceClient servingConfigServiceClient =
+ * ServingConfigServiceClient.create()) {
+ * GetServingConfigRequest request =
+ * GetServingConfigRequest.newBuilder()
+ * .setName(
+ * ServingConfigName.ofProjectLocationDataStoreServingConfigName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[SERVING_CONFIG]")
+ * .toString())
+ * .build();
+ * ServingConfig response = servingConfigServiceClient.getServingConfig(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 ServingConfig getServingConfig(GetServingConfigRequest request) {
+ return getServingConfigCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets a ServingConfig.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (ServingConfigServiceClient servingConfigServiceClient =
+ * ServingConfigServiceClient.create()) {
+ * GetServingConfigRequest request =
+ * GetServingConfigRequest.newBuilder()
+ * .setName(
+ * ServingConfigName.ofProjectLocationDataStoreServingConfigName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[SERVING_CONFIG]")
+ * .toString())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (ServingConfigServiceClient servingConfigServiceClient =
+ * ServingConfigServiceClient.create()) {
+ * DataStoreName parent =
+ * DataStoreName.ofProjectLocationDataStoreName("[PROJECT]", "[LOCATION]", "[DATA_STORE]");
+ * for (ServingConfig element :
+ * servingConfigServiceClient.listServingConfigs(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The dataStore resource name. Format:
+ * `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}`
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListServingConfigsPagedResponse listServingConfigs(DataStoreName parent) {
+ ListServingConfigsRequest request =
+ ListServingConfigsRequest.newBuilder()
+ .setParent(parent == null ? null : parent.toString())
+ .build();
+ return listServingConfigs(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists all ServingConfigs linked to this dataStore.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (ServingConfigServiceClient servingConfigServiceClient =
+ * ServingConfigServiceClient.create()) {
+ * String parent =
+ * DataStoreName.ofProjectLocationDataStoreName("[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString();
+ * for (ServingConfig element :
+ * servingConfigServiceClient.listServingConfigs(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The dataStore resource name. Format:
+ * `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}`
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListServingConfigsPagedResponse listServingConfigs(String parent) {
+ ListServingConfigsRequest request =
+ ListServingConfigsRequest.newBuilder().setParent(parent).build();
+ return listServingConfigs(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists all ServingConfigs linked to this dataStore.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (ServingConfigServiceClient servingConfigServiceClient =
+ * ServingConfigServiceClient.create()) {
+ * ListServingConfigsRequest request =
+ * ListServingConfigsRequest.newBuilder()
+ * .setParent(
+ * DataStoreName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * for (ServingConfig element :
+ * servingConfigServiceClient.listServingConfigs(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 ListServingConfigsPagedResponse listServingConfigs(
+ ListServingConfigsRequest request) {
+ return listServingConfigsPagedCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists all ServingConfigs linked to this dataStore.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (ServingConfigServiceClient servingConfigServiceClient =
+ * ServingConfigServiceClient.create()) {
+ * ListServingConfigsRequest request =
+ * ListServingConfigsRequest.newBuilder()
+ * .setParent(
+ * DataStoreName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (ServingConfigServiceClient servingConfigServiceClient =
+ * ServingConfigServiceClient.create()) {
+ * ListServingConfigsRequest request =
+ * ListServingConfigsRequest.newBuilder()
+ * .setParent(
+ * DataStoreName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * while (true) {
+ * ListServingConfigsResponse response =
+ * servingConfigServiceClient.listServingConfigsCallable().call(request);
+ * for (ServingConfig element : response.getServingConfigsList()) {
+ * // 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 and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * ServingConfigServiceSettings.Builder servingConfigServiceSettingsBuilder =
+ * ServingConfigServiceSettings.newBuilder();
+ * servingConfigServiceSettingsBuilder
+ * .updateServingConfigSettings()
+ * .setRetrySettings(
+ * servingConfigServiceSettingsBuilder
+ * .updateServingConfigSettings()
+ * .getRetrySettings()
+ * .toBuilder()
+ * .setTotalTimeout(Duration.ofSeconds(30))
+ * .build());
+ * ServingConfigServiceSettings servingConfigServiceSettings =
+ * servingConfigServiceSettingsBuilder.build();
+ * }
+ */
+@BetaApi
+@Generated("by gapic-generator-java")
+public class ServingConfigServiceSettings extends ClientSettings{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * SiteSearchEngineName name =
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]");
+ * SiteSearchEngine response = siteSearchEngineServiceClient.getSiteSearchEngine(name);
+ * }
+ * }
+ *
+ *
+ *
+ *
+ *
+ *
+ * Method
+ * Description
+ * Method Variants
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * SiteSearchEngineServiceSettings siteSearchEngineServiceSettings =
+ * SiteSearchEngineServiceSettings.newBuilder()
+ * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
+ * .build();
+ * SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create(siteSearchEngineServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * SiteSearchEngineServiceSettings siteSearchEngineServiceSettings =
+ * SiteSearchEngineServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
+ * SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create(siteSearchEngineServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * SiteSearchEngineServiceSettings siteSearchEngineServiceSettings =
+ * SiteSearchEngineServiceSettings.newHttpJsonBuilder().build();
+ * SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create(siteSearchEngineServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * SiteSearchEngineName name =
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]");
+ * SiteSearchEngine response = siteSearchEngineServiceClient.getSiteSearchEngine(name);
+ * }
+ * }
+ *
+ * @param name Required. Resource name of
+ * [SiteSearchEngine][google.cloud.discoveryengine.v1beta.SiteSearchEngine], such as
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/siteSearchEngine`.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * String name =
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString();
+ * SiteSearchEngine response = siteSearchEngineServiceClient.getSiteSearchEngine(name);
+ * }
+ * }
+ *
+ * @param name Required. Resource name of
+ * [SiteSearchEngine][google.cloud.discoveryengine.v1beta.SiteSearchEngine], such as
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/siteSearchEngine`.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * GetSiteSearchEngineRequest request =
+ * GetSiteSearchEngineRequest.newBuilder()
+ * .setName(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * SiteSearchEngine response = siteSearchEngineServiceClient.getSiteSearchEngine(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 SiteSearchEngine getSiteSearchEngine(GetSiteSearchEngineRequest request) {
+ return getSiteSearchEngineCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets the [SiteSearchEngine][google.cloud.discoveryengine.v1beta.SiteSearchEngine].
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * GetSiteSearchEngineRequest request =
+ * GetSiteSearchEngineRequest.newBuilder()
+ * .setName(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * SiteSearchEngineName parent =
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]");
+ * TargetSite targetSite = TargetSite.newBuilder().build();
+ * TargetSite response =
+ * siteSearchEngineServiceClient.createTargetSiteAsync(parent, targetSite).get();
+ * }
+ * }
+ *
+ * @param parent Required. Parent resource name of
+ * [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite], such as
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/siteSearchEngine`.
+ * @param targetSite Required. The [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite] to
+ * create.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * String parent =
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString();
+ * TargetSite targetSite = TargetSite.newBuilder().build();
+ * TargetSite response =
+ * siteSearchEngineServiceClient.createTargetSiteAsync(parent, targetSite).get();
+ * }
+ * }
+ *
+ * @param parent Required. Parent resource name of
+ * [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite], such as
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/siteSearchEngine`.
+ * @param targetSite Required. The [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite] to
+ * create.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * CreateTargetSiteRequest request =
+ * CreateTargetSiteRequest.newBuilder()
+ * .setParent(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .setTargetSite(TargetSite.newBuilder().build())
+ * .build();
+ * TargetSite response = siteSearchEngineServiceClient.createTargetSiteAsync(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 and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * CreateTargetSiteRequest request =
+ * CreateTargetSiteRequest.newBuilder()
+ * .setParent(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .setTargetSite(TargetSite.newBuilder().build())
+ * .build();
+ * OperationFuture
+ */
+ public final OperationCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * CreateTargetSiteRequest request =
+ * CreateTargetSiteRequest.newBuilder()
+ * .setParent(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .setTargetSite(TargetSite.newBuilder().build())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * BatchCreateTargetSitesRequest request =
+ * BatchCreateTargetSitesRequest.newBuilder()
+ * .setParent(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .addAllRequests(new ArrayList
+ *
+ * @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 and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * BatchCreateTargetSitesRequest request =
+ * BatchCreateTargetSitesRequest.newBuilder()
+ * .setParent(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .addAllRequests(new ArrayList
+ */
+ public final OperationCallable<
+ BatchCreateTargetSitesRequest,
+ BatchCreateTargetSitesResponse,
+ BatchCreateTargetSiteMetadata>
+ batchCreateTargetSitesOperationCallable() {
+ return stub.batchCreateTargetSitesOperationCallable();
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Creates [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite] in a batch.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * BatchCreateTargetSitesRequest request =
+ * BatchCreateTargetSitesRequest.newBuilder()
+ * .setParent(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .addAllRequests(new ArrayList
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * TargetSiteName name =
+ * TargetSiteName.ofProjectLocationDataStoreTargetSiteName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[TARGET_SITE]");
+ * TargetSite response = siteSearchEngineServiceClient.getTargetSite(name);
+ * }
+ * }
+ *
+ * @param name Required. Full resource name of
+ * [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite], such as
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/siteSearchEngine/targetSites/{target_site}`.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * String name =
+ * TargetSiteName.ofProjectLocationDataStoreTargetSiteName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[TARGET_SITE]")
+ * .toString();
+ * TargetSite response = siteSearchEngineServiceClient.getTargetSite(name);
+ * }
+ * }
+ *
+ * @param name Required. Full resource name of
+ * [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite], such as
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/siteSearchEngine/targetSites/{target_site}`.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * GetTargetSiteRequest request =
+ * GetTargetSiteRequest.newBuilder()
+ * .setName(
+ * TargetSiteName.ofProjectLocationDataStoreTargetSiteName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[TARGET_SITE]")
+ * .toString())
+ * .build();
+ * TargetSite response = siteSearchEngineServiceClient.getTargetSite(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 TargetSite getTargetSite(GetTargetSiteRequest request) {
+ return getTargetSiteCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets a [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite].
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * GetTargetSiteRequest request =
+ * GetTargetSiteRequest.newBuilder()
+ * .setName(
+ * TargetSiteName.ofProjectLocationDataStoreTargetSiteName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[TARGET_SITE]")
+ * .toString())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * TargetSite targetSite = TargetSite.newBuilder().build();
+ * TargetSite response = siteSearchEngineServiceClient.updateTargetSiteAsync(targetSite).get();
+ * }
+ * }
+ *
+ * @param targetSite Required. The target site to update. If the caller does not have permission
+ * to update the [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite], regardless of
+ * whether or not it exists, a PERMISSION_DENIED error is returned.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * UpdateTargetSiteRequest request =
+ * UpdateTargetSiteRequest.newBuilder()
+ * .setTargetSite(TargetSite.newBuilder().build())
+ * .build();
+ * TargetSite response = siteSearchEngineServiceClient.updateTargetSiteAsync(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 and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * UpdateTargetSiteRequest request =
+ * UpdateTargetSiteRequest.newBuilder()
+ * .setTargetSite(TargetSite.newBuilder().build())
+ * .build();
+ * OperationFuture
+ */
+ public final OperationCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * UpdateTargetSiteRequest request =
+ * UpdateTargetSiteRequest.newBuilder()
+ * .setTargetSite(TargetSite.newBuilder().build())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * TargetSiteName name =
+ * TargetSiteName.ofProjectLocationDataStoreTargetSiteName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[TARGET_SITE]");
+ * siteSearchEngineServiceClient.deleteTargetSiteAsync(name).get();
+ * }
+ * }
+ *
+ * @param name Required. Full resource name of
+ * [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite], such as
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/siteSearchEngine/targetSites/{target_site}`.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * String name =
+ * TargetSiteName.ofProjectLocationDataStoreTargetSiteName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[TARGET_SITE]")
+ * .toString();
+ * siteSearchEngineServiceClient.deleteTargetSiteAsync(name).get();
+ * }
+ * }
+ *
+ * @param name Required. Full resource name of
+ * [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite], such as
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/siteSearchEngine/targetSites/{target_site}`.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * DeleteTargetSiteRequest request =
+ * DeleteTargetSiteRequest.newBuilder()
+ * .setName(
+ * TargetSiteName.ofProjectLocationDataStoreTargetSiteName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[TARGET_SITE]")
+ * .toString())
+ * .build();
+ * siteSearchEngineServiceClient.deleteTargetSiteAsync(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 and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * DeleteTargetSiteRequest request =
+ * DeleteTargetSiteRequest.newBuilder()
+ * .setName(
+ * TargetSiteName.ofProjectLocationDataStoreTargetSiteName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[TARGET_SITE]")
+ * .toString())
+ * .build();
+ * OperationFuture
+ */
+ public final OperationCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * DeleteTargetSiteRequest request =
+ * DeleteTargetSiteRequest.newBuilder()
+ * .setName(
+ * TargetSiteName.ofProjectLocationDataStoreTargetSiteName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[TARGET_SITE]")
+ * .toString())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * SiteSearchEngineName parent =
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]");
+ * for (TargetSite element :
+ * siteSearchEngineServiceClient.listTargetSites(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The parent site search engine resource name, such as
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/siteSearchEngine`.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * String parent =
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString();
+ * for (TargetSite element :
+ * siteSearchEngineServiceClient.listTargetSites(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The parent site search engine resource name, such as
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/siteSearchEngine`.
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * ListTargetSitesRequest request =
+ * ListTargetSitesRequest.newBuilder()
+ * .setParent(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * for (TargetSite element :
+ * siteSearchEngineServiceClient.listTargetSites(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 ListTargetSitesPagedResponse listTargetSites(ListTargetSitesRequest request) {
+ return listTargetSitesPagedCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Gets a list of [TargetSite][google.cloud.discoveryengine.v1beta.TargetSite]s.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * ListTargetSitesRequest request =
+ * ListTargetSitesRequest.newBuilder()
+ * .setParent(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * ListTargetSitesRequest request =
+ * ListTargetSitesRequest.newBuilder()
+ * .setParent(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * while (true) {
+ * ListTargetSitesResponse response =
+ * siteSearchEngineServiceClient.listTargetSitesCallable().call(request);
+ * for (TargetSite element : response.getTargetSitesList()) {
+ * // 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 and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * EnableAdvancedSiteSearchRequest request =
+ * EnableAdvancedSiteSearchRequest.newBuilder()
+ * .setSiteSearchEngine(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * EnableAdvancedSiteSearchResponse response =
+ * siteSearchEngineServiceClient.enableAdvancedSiteSearchAsync(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 and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * EnableAdvancedSiteSearchRequest request =
+ * EnableAdvancedSiteSearchRequest.newBuilder()
+ * .setSiteSearchEngine(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * OperationFuture
+ */
+ public final OperationCallable<
+ EnableAdvancedSiteSearchRequest,
+ EnableAdvancedSiteSearchResponse,
+ EnableAdvancedSiteSearchMetadata>
+ enableAdvancedSiteSearchOperationCallable() {
+ return stub.enableAdvancedSiteSearchOperationCallable();
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Upgrade from basic site search to advanced site search.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * EnableAdvancedSiteSearchRequest request =
+ * EnableAdvancedSiteSearchRequest.newBuilder()
+ * .setSiteSearchEngine(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * DisableAdvancedSiteSearchRequest request =
+ * DisableAdvancedSiteSearchRequest.newBuilder()
+ * .setSiteSearchEngine(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * DisableAdvancedSiteSearchResponse response =
+ * siteSearchEngineServiceClient.disableAdvancedSiteSearchAsync(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 and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * DisableAdvancedSiteSearchRequest request =
+ * DisableAdvancedSiteSearchRequest.newBuilder()
+ * .setSiteSearchEngine(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * OperationFuture
+ */
+ public final OperationCallable<
+ DisableAdvancedSiteSearchRequest,
+ DisableAdvancedSiteSearchResponse,
+ DisableAdvancedSiteSearchMetadata>
+ disableAdvancedSiteSearchOperationCallable() {
+ return stub.disableAdvancedSiteSearchOperationCallable();
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Downgrade from advanced site search to basic site search.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * DisableAdvancedSiteSearchRequest request =
+ * DisableAdvancedSiteSearchRequest.newBuilder()
+ * .setSiteSearchEngine(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * RecrawlUrisRequest request =
+ * RecrawlUrisRequest.newBuilder()
+ * .setSiteSearchEngine(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .addAllUris(new ArrayList
+ *
+ * @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 and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * RecrawlUrisRequest request =
+ * RecrawlUrisRequest.newBuilder()
+ * .setSiteSearchEngine(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .addAllUris(new ArrayList
+ */
+ public final OperationCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * RecrawlUrisRequest request =
+ * RecrawlUrisRequest.newBuilder()
+ * .setSiteSearchEngine(
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
+ * .toString())
+ * .addAllUris(new ArrayList
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * BatchVerifyTargetSitesRequest request =
+ * BatchVerifyTargetSitesRequest.newBuilder()
+ * .setParent(
+ * SiteSearchEngineName.ofProjectLocationCollectionDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[COLLECTION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * BatchVerifyTargetSitesResponse response =
+ * siteSearchEngineServiceClient.batchVerifyTargetSitesAsync(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 and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * BatchVerifyTargetSitesRequest request =
+ * BatchVerifyTargetSitesRequest.newBuilder()
+ * .setParent(
+ * SiteSearchEngineName.ofProjectLocationCollectionDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[COLLECTION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * OperationFuture
+ */
+ public final OperationCallable<
+ BatchVerifyTargetSitesRequest,
+ BatchVerifyTargetSitesResponse,
+ BatchVerifyTargetSitesMetadata>
+ batchVerifyTargetSitesOperationCallable() {
+ return stub.batchVerifyTargetSitesOperationCallable();
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Verify target sites' ownership and validity. This API sends all the target sites under site
+ * search engine for verification.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * BatchVerifyTargetSitesRequest request =
+ * BatchVerifyTargetSitesRequest.newBuilder()
+ * .setParent(
+ * SiteSearchEngineName.ofProjectLocationCollectionDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[COLLECTION]", "[DATA_STORE]")
+ * .toString())
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * FetchDomainVerificationStatusRequest request =
+ * FetchDomainVerificationStatusRequest.newBuilder()
+ * .setSiteSearchEngine(
+ * SiteSearchEngineName.ofProjectLocationCollectionDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[COLLECTION]", "[DATA_STORE]")
+ * .toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * for (TargetSite element :
+ * siteSearchEngineServiceClient.fetchDomainVerificationStatus(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 FetchDomainVerificationStatusPagedResponse fetchDomainVerificationStatus(
+ FetchDomainVerificationStatusRequest request) {
+ return fetchDomainVerificationStatusPagedCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Returns list of target sites with its domain verification status. This method can only be
+ * called under data store with BASIC_SITE_SEARCH state at the moment.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * FetchDomainVerificationStatusRequest request =
+ * FetchDomainVerificationStatusRequest.newBuilder()
+ * .setSiteSearchEngine(
+ * SiteSearchEngineName.ofProjectLocationCollectionDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[COLLECTION]", "[DATA_STORE]")
+ * .toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable<
+ FetchDomainVerificationStatusRequest, FetchDomainVerificationStatusPagedResponse>
+ fetchDomainVerificationStatusPagedCallable() {
+ return stub.fetchDomainVerificationStatusPagedCallable();
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Returns list of target sites with its domain verification status. This method can only be
+ * called under data store with BASIC_SITE_SEARCH state at the moment.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * FetchDomainVerificationStatusRequest request =
+ * FetchDomainVerificationStatusRequest.newBuilder()
+ * .setSiteSearchEngine(
+ * SiteSearchEngineName.ofProjectLocationCollectionDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[COLLECTION]", "[DATA_STORE]")
+ * .toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * while (true) {
+ * FetchDomainVerificationStatusResponse response =
+ * siteSearchEngineServiceClient.fetchDomainVerificationStatusCallable().call(request);
+ * for (TargetSite element : response.getTargetSitesList()) {
+ * // doThingsWith(element);
+ * }
+ * String nextPageToken = response.getNextPageToken();
+ * if (!Strings.isNullOrEmpty(nextPageToken)) {
+ * request = request.toBuilder().setPageToken(nextPageToken).build();
+ * } else {
+ * break;
+ * }
+ * }
+ * }
+ * }
+ */
+ public final UnaryCallable<
+ FetchDomainVerificationStatusRequest, FetchDomainVerificationStatusResponse>
+ fetchDomainVerificationStatusCallable() {
+ return stub.fetchDomainVerificationStatusCallable();
+ }
+
+ @Override
+ public final void close() {
+ stub.close();
+ }
+
+ @Override
+ public void shutdown() {
+ stub.shutdown();
+ }
+
+ @Override
+ public boolean isShutdown() {
+ return stub.isShutdown();
+ }
+
+ @Override
+ public boolean isTerminated() {
+ return stub.isTerminated();
+ }
+
+ @Override
+ public void shutdownNow() {
+ stub.shutdownNow();
+ }
+
+ @Override
+ public boolean awaitTermination(long duration, TimeUnit unit) throws InterruptedException {
+ return stub.awaitTermination(duration, unit);
+ }
+
+ public static class ListTargetSitesPagedResponse
+ extends AbstractPagedListResponse<
+ ListTargetSitesRequest,
+ ListTargetSitesResponse,
+ TargetSite,
+ ListTargetSitesPage,
+ ListTargetSitesFixedSizeCollection> {
+
+ public static ApiFuture
+ *
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * SiteSearchEngineServiceSettings.Builder siteSearchEngineServiceSettingsBuilder =
+ * SiteSearchEngineServiceSettings.newBuilder();
+ * siteSearchEngineServiceSettingsBuilder
+ * .getSiteSearchEngineSettings()
+ * .setRetrySettings(
+ * siteSearchEngineServiceSettingsBuilder
+ * .getSiteSearchEngineSettings()
+ * .getRetrySettings()
+ * .toBuilder()
+ * .setTotalTimeout(Duration.ofSeconds(30))
+ * .build());
+ * SiteSearchEngineServiceSettings siteSearchEngineServiceSettings =
+ * siteSearchEngineServiceSettingsBuilder.build();
+ * }
+ */
+@BetaApi
+@Generated("by gapic-generator-java")
+public class SiteSearchEngineServiceSettings
+ extends ClientSettings{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
+ * DataStoreName name =
+ * DataStoreName.ofProjectLocationDataStoreName("[PROJECT]", "[LOCATION]", "[DATA_STORE]");
+ * DataStore response = dataStoreServiceClient.getDataStore(name);
+ * }
+ * }
+ *
* {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
+ * Engine engine = Engine.newBuilder().build();
+ * FieldMask updateMask = FieldMask.newBuilder().build();
+ * Engine response = engineServiceClient.updateEngine(engine, updateMask);
+ * }
+ * }
+ *
* {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (ServingConfigServiceClient servingConfigServiceClient =
+ * ServingConfigServiceClient.create()) {
+ * ServingConfig servingConfig = ServingConfig.newBuilder().build();
+ * FieldMask updateMask = FieldMask.newBuilder().build();
+ * ServingConfig response =
+ * servingConfigServiceClient.updateServingConfig(servingConfig, updateMask);
+ * }
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
+ * SiteSearchEngineServiceClient.create()) {
+ * SiteSearchEngineName name =
+ * SiteSearchEngineName.ofProjectLocationDataStoreName(
+ * "[PROJECT]", "[LOCATION]", "[DATA_STORE]");
+ * SiteSearchEngine response = siteSearchEngineServiceClient.getSiteSearchEngine(name);
+ * }
+ * }
+ *
*
+ *
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * DataStoreServiceStubSettings.Builder dataStoreServiceSettingsBuilder =
+ * DataStoreServiceStubSettings.newBuilder();
+ * dataStoreServiceSettingsBuilder
+ * .getDataStoreSettings()
+ * .setRetrySettings(
+ * dataStoreServiceSettingsBuilder
+ * .getDataStoreSettings()
+ * .getRetrySettings()
+ * .toBuilder()
+ * .setTotalTimeout(Duration.ofSeconds(30))
+ * .build());
+ * DataStoreServiceStubSettings dataStoreServiceSettings = dataStoreServiceSettingsBuilder.build();
+ * }
+ */
+@BetaApi
+@Generated("by gapic-generator-java")
+public class DataStoreServiceStubSettings extends StubSettings