🦉 Updates from OwlBot

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

Author: gcf-owl-bot[bot]

google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/AgentsClient.java

@@ -0,0 +1,294 @@
+/*
+ * Copyright 2021 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.dialogflow.cx.v3;
+
+import static com.google.cloud.dialogflow.cx.v3.AgentsClient.ListAgentsPagedResponse;
+
+import com.google.api.core.ApiFunction;
+import com.google.api.core.BetaApi;
+import com.google.api.gax.core.GoogleCredentialsProvider;
+import com.google.api.gax.core.InstantiatingExecutorProvider;
+import com.google.api.gax.grpc.InstantiatingGrpcChannelProvider;
+import com.google.api.gax.rpc.ApiClientHeaderProvider;
+import com.google.api.gax.rpc.ClientContext;
+import com.google.api.gax.rpc.ClientSettings;
+import com.google.api.gax.rpc.OperationCallSettings;
+import com.google.api.gax.rpc.PagedCallSettings;
+import com.google.api.gax.rpc.TransportChannelProvider;
+import com.google.api.gax.rpc.UnaryCallSettings;
+import com.google.cloud.dialogflow.cx.v3.stub.AgentsStubSettings;
+import com.google.longrunning.Operation;
+import com.google.protobuf.Empty;
+import com.google.protobuf.Struct;
+import java.io.IOException;
+import java.util.List;
+import javax.annotation.Generated;
+
+// AUTO-GENERATED DOCUMENTATION AND CLASS.
+/**
+ * Settings class to configure an instance of {@link AgentsClient}.
+ *
+ * <p>The default instance has everything set to sensible defaults:
+ *
+ * <ul>
+ * <li>The default service address (dialogflow.googleapis.com) and default port (443) are used.
+ * <li>Credentials are acquired automatically through Application Default Credentials.
+ * <li>Retries are configured for idempotent methods but not for non-idempotent methods.
+ * </ul>
+ *
+ * <p>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.
+ *
+ * <p>For example, to set the total timeout of getAgent to 30 seconds:
+ *
+ * <pre>{@code
+ * AgentsSettings.Builder agentsSettingsBuilder = AgentsSettings.newBuilder();
+ * agentsSettingsBuilder
+ * .getAgentSettings()
+ * .setRetrySettings(
+ * agentsSettingsBuilder
+ * .getAgentSettings()
+ * .getRetrySettings()
+ * .toBuilder()
+ * .setTotalTimeout(Duration.ofSeconds(30))
+ * .build());
+ * AgentsSettings agentsSettings = agentsSettingsBuilder.build();
+ * }</pre>
+ */
+@Generated("by gapic-generator-java")
+public class AgentsSettings extends ClientSettings<AgentsSettings> {
+
+ /** Returns the object with the settings used for calls to listAgents. */
+ public PagedCallSettings<ListAgentsRequest, ListAgentsResponse, ListAgentsPagedResponse>
+ listAgentsSettings() {
+ return ((AgentsStubSettings) getStubSettings()).listAgentsSettings();
+ }
+
+ /** Returns the object with the settings used for calls to getAgent. */
+ public UnaryCallSettings<GetAgentRequest, Agent> getAgentSettings() {
+ return ((AgentsStubSettings) getStubSettings()).getAgentSettings();
+ }
+
+ /** Returns the object with the settings used for calls to createAgent. */
+ public UnaryCallSettings<CreateAgentRequest, Agent> createAgentSettings() {
+ return ((AgentsStubSettings) getStubSettings()).createAgentSettings();
+ }
+
+ /** Returns the object with the settings used for calls to updateAgent. */
+ public UnaryCallSettings<UpdateAgentRequest, Agent> updateAgentSettings() {
+ return ((AgentsStubSettings) getStubSettings()).updateAgentSettings();
+ }
+
+ /** Returns the object with the settings used for calls to deleteAgent. */
+ public UnaryCallSettings<DeleteAgentRequest, Empty> deleteAgentSettings() {
+ return ((AgentsStubSettings) getStubSettings()).deleteAgentSettings();
+ }
+
+ /** Returns the object with the settings used for calls to exportAgent. */
+ public UnaryCallSettings<ExportAgentRequest, Operation> exportAgentSettings() {
+ return ((AgentsStubSettings) getStubSettings()).exportAgentSettings();
+ }
+
+ /** Returns the object with the settings used for calls to exportAgent. */
+ public OperationCallSettings<ExportAgentRequest, ExportAgentResponse, Struct>
+ exportAgentOperationSettings() {
+ return ((AgentsStubSettings) getStubSettings()).exportAgentOperationSettings();
+ }
+
+ /** Returns the object with the settings used for calls to restoreAgent. */
+ public UnaryCallSettings<RestoreAgentRequest, Operation> restoreAgentSettings() {
+ return ((AgentsStubSettings) getStubSettings()).restoreAgentSettings();
+ }
+
+ /** Returns the object with the settings used for calls to restoreAgent. */
+ public OperationCallSettings<RestoreAgentRequest, Empty, Struct> restoreAgentOperationSettings() {
+ return ((AgentsStubSettings) getStubSettings()).restoreAgentOperationSettings();
+ }
+
+ /** Returns the object with the settings used for calls to validateAgent. */
+ public UnaryCallSettings<ValidateAgentRequest, AgentValidationResult> validateAgentSettings() {
+ return ((AgentsStubSettings) getStubSettings()).validateAgentSettings();
+ }
+
+ /** Returns the object with the settings used for calls to getAgentValidationResult. */
+ public UnaryCallSettings<GetAgentValidationResultRequest, AgentValidationResult>
+ getAgentValidationResultSettings() {
+ return ((AgentsStubSettings) getStubSettings()).getAgentValidationResultSettings();
+ }
+
+ public static final AgentsSettings create(AgentsStubSettings stub) throws IOException {
+ return new AgentsSettings.Builder(stub.toBuilder()).build();
+ }
+
+ /** Returns a builder for the default ExecutorProvider for this service. */
+ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() {
+ return AgentsStubSettings.defaultExecutorProviderBuilder();
+ }
+
+ /** Returns the default service endpoint. */
+ public static String getDefaultEndpoint() {
+ return AgentsStubSettings.getDefaultEndpoint();
+ }
+
+ /** Returns the default service scopes. */
+ public static List<String> getDefaultServiceScopes() {
+ return AgentsStubSettings.getDefaultServiceScopes();
+ }
+
+ /** Returns a builder for the default credentials for this service. */
+ public static GoogleCredentialsProvider.Builder defaultCredentialsProviderBuilder() {
+ return AgentsStubSettings.defaultCredentialsProviderBuilder();
+ }
+
+ /** Returns a builder for the default ChannelProvider for this service. */
+ public static InstantiatingGrpcChannelProvider.Builder defaultGrpcTransportProviderBuilder() {
+ return AgentsStubSettings.defaultGrpcTransportProviderBuilder();
+ }
+
+ public static TransportChannelProvider defaultTransportChannelProvider() {
+ return AgentsStubSettings.defaultTransportChannelProvider();
+ }
+
+ @BetaApi("The surface for customizing headers is not stable yet and may change in the future.")
+ public static ApiClientHeaderProvider.Builder defaultApiClientHeaderProviderBuilder() {
+ return AgentsStubSettings.defaultApiClientHeaderProviderBuilder();
+ }
+
+ /** Returns a new builder for this class. */
+ public static Builder newBuilder() {
+ return Builder.createDefault();
+ }
+
+ /** Returns a new builder for this class. */
+ public static Builder newBuilder(ClientContext clientContext) {
+ return new Builder(clientContext);
+ }
+
+ /** Returns a builder containing all the values of this settings class. */
+ public Builder toBuilder() {
+ return new Builder(this);
+ }
+
+ protected AgentsSettings(Builder settingsBuilder) throws IOException {
+ super(settingsBuilder);
+ }
+
+ /** Builder for AgentsSettings. */
+ public static class Builder extends ClientSettings.Builder<AgentsSettings, Builder> {
+
+ protected Builder() throws IOException {
+ this(((ClientContext) null));
+ }
+
+ protected Builder(ClientContext clientContext) {
+ super(AgentsStubSettings.newBuilder(clientContext));
+ }
+
+ protected Builder(AgentsSettings settings) {
+ super(settings.getStubSettings().toBuilder());
+ }
+
+ protected Builder(AgentsStubSettings.Builder stubSettings) {
+ super(stubSettings);
+ }
+
+ private static Builder createDefault() {
+ return new Builder(AgentsStubSettings.newBuilder());
+ }
+
+ public AgentsStubSettings.Builder getStubSettingsBuilder() {
+ return ((AgentsStubSettings.Builder) getStubSettings());
+ }
+
+ /**
+ * Applies the given settings updater function to all of the unary API methods in this service.
+ *
+ * <p>Note: This method does not support applying settings to streaming methods.
+ */
+ public Builder applyToAllUnaryMethods(
+ ApiFunction<UnaryCallSettings.Builder<?, ?>, Void> settingsUpdater) {
+ super.applyToAllUnaryMethods(
+ getStubSettingsBuilder().unaryMethodSettingsBuilders(), settingsUpdater);
+ return this;
+ }
+
+ /** Returns the builder for the settings used for calls to listAgents. */
+ public PagedCallSettings.Builder<ListAgentsRequest, ListAgentsResponse, ListAgentsPagedResponse>
+ listAgentsSettings() {
+ return getStubSettingsBuilder().listAgentsSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to getAgent. */
+ public UnaryCallSettings.Builder<GetAgentRequest, Agent> getAgentSettings() {
+ return getStubSettingsBuilder().getAgentSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to createAgent. */
+ public UnaryCallSettings.Builder<CreateAgentRequest, Agent> createAgentSettings() {
+ return getStubSettingsBuilder().createAgentSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to updateAgent. */
+ public UnaryCallSettings.Builder<UpdateAgentRequest, Agent> updateAgentSettings() {
+ return getStubSettingsBuilder().updateAgentSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to deleteAgent. */
+ public UnaryCallSettings.Builder<DeleteAgentRequest, Empty> deleteAgentSettings() {
+ return getStubSettingsBuilder().deleteAgentSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to exportAgent. */
+ public UnaryCallSettings.Builder<ExportAgentRequest, Operation> exportAgentSettings() {
+ return getStubSettingsBuilder().exportAgentSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to exportAgent. */
+ public OperationCallSettings.Builder<ExportAgentRequest, ExportAgentResponse, Struct>
+ exportAgentOperationSettings() {
+ return getStubSettingsBuilder().exportAgentOperationSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to restoreAgent. */
+ public UnaryCallSettings.Builder<RestoreAgentRequest, Operation> restoreAgentSettings() {
+ return getStubSettingsBuilder().restoreAgentSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to restoreAgent. */
+ public OperationCallSettings.Builder<RestoreAgentRequest, Empty, Struct>
+ restoreAgentOperationSettings() {
+ return getStubSettingsBuilder().restoreAgentOperationSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to validateAgent. */
+ public UnaryCallSettings.Builder<ValidateAgentRequest, AgentValidationResult>
+ validateAgentSettings() {
+ return getStubSettingsBuilder().validateAgentSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to getAgentValidationResult. */
+ public UnaryCallSettings.Builder<GetAgentValidationResultRequest, AgentValidationResult>
+ getAgentValidationResultSettings() {
+ return getStubSettingsBuilder().getAgentValidationResultSettings();
+ }
+
+ @Override
+ public AgentsSettings build() throws IOException {
+ return new AgentsSettings(this);
+ }
+ }
+}