feat: add support for regionalization for documents, allow custom to …

…specify webhook headers through query parameters (#406)

This PR was generated using Autosynth. 🌈

Synth log will be available here:
https://source.cloud.google.com/results/invocations/ed5727a7-9a2f-44c4-9d91-cfde63ab5fe1/targets

- [ ] To automatically regenerate this PR, check this box.

PiperOrigin-RevId: 346910607
Source-Link: googleapis/googleapis@c38c770
PiperOrigin-RevId: 346372957
Source-Link: googleapis/googleapis@857f70d
PiperOrigin-RevId: 346126713
Source-Link: googleapis/googleapis@b8b2f8c
PiperOrigin-RevId: 345742559
Source-Link: googleapis/googleapis@519e9dc
PiperOrigin-RevId: 345544333
Source-Link: googleapis/googleapis@a6cbc5f
PiperOrigin-RevId: 345476969
Source-Link: googleapis/googleapis@7be2c82
PiperOrigin-RevId: 345067549
Source-Link: googleapis/googleapis@8cfc6c8
PiperOrigin-RevId: 345058811
Source-Link: googleapis/googleapis@665e9b0
PiperOrigin-RevId: 344134135
Source-Link: googleapis/googleapis@b11a87f

feat: added support for regionalization for document API
docs: suggested to always use version for production traffic when calling DetectIntent.marked match_mode in Agent message as deprecated
feat: allowed custom to specify webhook headers through query parameters
docs: suggested to always use version for production traffic when calling DetectIntent, mark match_mode in Agent message as deprecated
docs: restructured AudioConfig API

google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/AgentsSettings.java

@@ -5,14 +5,15 @@
  * 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
+ *      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.v2;
 
 import static com.google.cloud.dialogflow.v2.AgentsClient.SearchAgentsPagedResponse;
@@ -37,7 +38,7 @@
 import java.util.List;
 import javax.annotation.Generated;
 
-// AUTO-GENERATED DOCUMENTATION AND CLASS
+// AUTO-GENERATED DOCUMENTATION AND CLASS.
 /**
  * Settings class to configure an instance of {@link AgentsClient}.
  *
@@ -54,23 +55,23 @@
  *
  * <p>For example, to set the total timeout of getAgent to 30 seconds:
  *
- * <pre>
- * <code>
- * AgentsSettings.Builder agentsSettingsBuilder =
- *     AgentsSettings.newBuilder();
+ * <pre>{@code
+ * AgentsSettings.Builder agentsSettingsBuilder = AgentsSettings.newBuilder();
  * agentsSettingsBuilder
  *     .getAgentSettings()
  *     .setRetrySettings(
- *         agentsSettingsBuilder.getAgentSettings().getRetrySettings().toBuilder()
+ *         agentsSettingsBuilder
+ *             .getAgentSettings()
+ *             .getRetrySettings()
+ *             .toBuilder()
  *             .setTotalTimeout(Duration.ofSeconds(30))
  *             .build());
  * AgentsSettings agentsSettings = agentsSettingsBuilder.build();
- * </code>
- * </pre>
+ * }</pre>
  */
-@Generated("by gapic-generator")
-@BetaApi
+@Generated("by gapic-generator-java")
 public class AgentsSettings extends ClientSettings<AgentsSettings> {
+
   /** Returns the object with the settings used for calls to getAgent. */
   public UnaryCallSettings<GetAgentRequest, Agent> getAgentSettings() {
     return ((AgentsStubSettings) getStubSettings()).getAgentSettings();
@@ -98,8 +99,6 @@ public UnaryCallSettings<TrainAgentRequest, Operation> trainAgentSettings() {
   }
 
   /** Returns the object with the settings used for calls to trainAgent. */
-  @BetaApi(
-      "The surface for long-running operations is not stable yet and may change in the future.")
   public OperationCallSettings<TrainAgentRequest, Empty, Struct> trainAgentOperationSettings() {
     return ((AgentsStubSettings) getStubSettings()).trainAgentOperationSettings();
   }
@@ -110,8 +109,6 @@ public UnaryCallSettings<ExportAgentRequest, Operation> exportAgentSettings() {
   }
 
   /** Returns the object with the settings used for calls to exportAgent. */
-  @BetaApi(
-      "The surface for long-running operations is not stable yet and may change in the future.")
   public OperationCallSettings<ExportAgentRequest, ExportAgentResponse, Struct>
       exportAgentOperationSettings() {
     return ((AgentsStubSettings) getStubSettings()).exportAgentOperationSettings();
@@ -123,8 +120,6 @@ public UnaryCallSettings<ImportAgentRequest, Operation> importAgentSettings() {
   }
 
   /** Returns the object with the settings used for calls to importAgent. */
-  @BetaApi(
-      "The surface for long-running operations is not stable yet and may change in the future.")
   public OperationCallSettings<ImportAgentRequest, Empty, Struct> importAgentOperationSettings() {
     return ((AgentsStubSettings) getStubSettings()).importAgentOperationSettings();
   }
@@ -135,8 +130,6 @@ public UnaryCallSettings<RestoreAgentRequest, Operation> restoreAgentSettings()
   }
 
   /** Returns the object with the settings used for calls to restoreAgent. */
-  @BetaApi(
-      "The surface for long-running operations is not stable yet and may change in the future.")
   public OperationCallSettings<RestoreAgentRequest, Empty, Struct> restoreAgentOperationSettings() {
     return ((AgentsStubSettings) getStubSettings()).restoreAgentOperationSettings();
   }
@@ -206,18 +199,15 @@ protected AgentsSettings(Builder settingsBuilder) throws IOException {
 
   /** Builder for AgentsSettings. */
   public static class Builder extends ClientSettings.Builder<AgentsSettings, Builder> {
+
     protected Builder() throws IOException {
-      this((ClientContext) null);
+      this(((ClientContext) null));
     }
 
     protected Builder(ClientContext clientContext) {
       super(AgentsStubSettings.newBuilder(clientContext));
     }
 
-    private static Builder createDefault() {
-      return new Builder(AgentsStubSettings.newBuilder());
-    }
-
     protected Builder(AgentsSettings settings) {
       super(settings.getStubSettings().toBuilder());
     }
@@ -226,11 +216,15 @@ protected Builder(AgentsStubSettings.Builder stubSettings) {
       super(stubSettings);
     }
 
+    private static Builder createDefault() {
+      return new Builder(AgentsStubSettings.newBuilder());
+    }
+
     public AgentsStubSettings.Builder getStubSettingsBuilder() {
       return ((AgentsStubSettings.Builder) getStubSettings());
     }
 
-    // NEXT_MAJOR_VER: remove 'throws Exception'
+    // NEXT_MAJOR_VER: remove 'throws Exception'.
     /**
      * Applies the given settings updater function to all of the unary API methods in this service.
      *
@@ -271,8 +265,6 @@ public UnaryCallSettings.Builder<TrainAgentRequest, Operation> trainAgentSetting
     }
 
     /** Returns the builder for the settings used for calls to trainAgent. */
-    @BetaApi(
-        "The surface for long-running operations is not stable yet and may change in the future.")
     public OperationCallSettings.Builder<TrainAgentRequest, Empty, Struct>
         trainAgentOperationSettings() {
       return getStubSettingsBuilder().trainAgentOperationSettings();
@@ -284,8 +276,6 @@ public UnaryCallSettings.Builder<ExportAgentRequest, Operation> exportAgentSetti
     }
 
     /** Returns the builder for the settings used for calls to exportAgent. */
-    @BetaApi(
-        "The surface for long-running operations is not stable yet and may change in the future.")
     public OperationCallSettings.Builder<ExportAgentRequest, ExportAgentResponse, Struct>
         exportAgentOperationSettings() {
       return getStubSettingsBuilder().exportAgentOperationSettings();
@@ -297,8 +287,6 @@ public UnaryCallSettings.Builder<ImportAgentRequest, Operation> importAgentSetti
     }
 
     /** Returns the builder for the settings used for calls to importAgent. */
-    @BetaApi(
-        "The surface for long-running operations is not stable yet and may change in the future.")
     public OperationCallSettings.Builder<ImportAgentRequest, Empty, Struct>
         importAgentOperationSettings() {
       return getStubSettingsBuilder().importAgentOperationSettings();
@@ -310,8 +298,6 @@ public UnaryCallSettings.Builder<RestoreAgentRequest, Operation> restoreAgentSet
     }
 
     /** Returns the builder for the settings used for calls to restoreAgent. */
-    @BetaApi(
-        "The surface for long-running operations is not stable yet and may change in the future.")
     public OperationCallSettings.Builder<RestoreAgentRequest, Empty, Struct>
         restoreAgentOperationSettings() {
       return getStubSettingsBuilder().restoreAgentOperationSettings();