feat: [dialogflow-cx] added generative AI, safety/security and speech endpointing settings

java-dialogflow-cx/README.md

@@ -23,7 +23,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>libraries-bom</artifactId>
-      <version>26.19.0</version>
+      <version>26.22.0</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>
@@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
 [stability-image]: https://img.shields.io/badge/stability-preview-yellow
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-dialogflow-cx.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-dialogflow-cx/0.32.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-dialogflow-cx/0.34.0
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

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

@@ -1239,6 +1239,7 @@ public final FlowValidationResult getFlowValidationResult(
    *   ImportFlowRequest request =
    *       ImportFlowRequest.newBuilder()
    *           .setParent(AgentName.of("[PROJECT]", "[LOCATION]", "[AGENT]").toString())
+   *           .setFlowImportStrategy(FlowImportStrategy.newBuilder().build())
    *           .build();
    *   ImportFlowResponse response = flowsClient.importFlowAsync(request).get();
    * }
@@ -1279,6 +1280,7 @@ public final OperationFuture<ImportFlowResponse, Struct> importFlowAsync(
    *   ImportFlowRequest request =
    *       ImportFlowRequest.newBuilder()
    *           .setParent(AgentName.of("[PROJECT]", "[LOCATION]", "[AGENT]").toString())
+   *           .setFlowImportStrategy(FlowImportStrategy.newBuilder().build())
    *           .build();
    *   OperationFuture<ImportFlowResponse, Struct> future =
    *       flowsClient.importFlowOperationCallable().futureCall(request);
@@ -1319,6 +1321,7 @@ public final OperationFuture<ImportFlowResponse, Struct> importFlowAsync(
    *   ImportFlowRequest request =
    *       ImportFlowRequest.newBuilder()
    *           .setParent(AgentName.of("[PROJECT]", "[LOCATION]", "[AGENT]").toString())
+   *           .setFlowImportStrategy(FlowImportStrategy.newBuilder().build())
    *           .build();
    *   ApiFuture<Operation> future = flowsClient.importFlowCallable().futureCall(request);
    *   // Do something.

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

@@ -55,7 +55,7 @@
  * try (TransitionRouteGroupsClient transitionRouteGroupsClient =
  *     TransitionRouteGroupsClient.create()) {
  *   TransitionRouteGroupName name =
- *       TransitionRouteGroupName.of(
+ *       TransitionRouteGroupName.ofProjectLocationAgentFlowTransitionRouteGroupName(
  *           "[PROJECT]", "[LOCATION]", "[AGENT]", "[FLOW]", "[TRANSITION_ROUTE_GROUP]");
  *   TransitionRouteGroup response = transitionRouteGroupsClient.getTransitionRouteGroup(name);
  * }
@@ -185,6 +185,42 @@ public TransitionRouteGroupsStub getStub() {
     return stub;
   }
 
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Returns the list of all transition route groups in the specified flow.
+   *
+   * <p>Sample code:
+   *
+   * <pre>{@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 (TransitionRouteGroupsClient transitionRouteGroupsClient =
+   *     TransitionRouteGroupsClient.create()) {
+   *   AgentName parent = AgentName.of("[PROJECT]", "[LOCATION]", "[AGENT]");
+   *   for (TransitionRouteGroup element :
+   *       transitionRouteGroupsClient.listTransitionRouteGroups(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
+   *
+   * @param parent Required. The flow to list all transition route groups for. Format:
+   *     `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
+   *     ID&gt;/flows/&lt;Flow ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;/agents/&lt;Agent ID&gt;.
+   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   */
+  public final ListTransitionRouteGroupsPagedResponse listTransitionRouteGroups(AgentName parent) {
+    ListTransitionRouteGroupsRequest request =
+        ListTransitionRouteGroupsRequest.newBuilder()
+            .setParent(parent == null ? null : parent.toString())
+            .build();
+    return listTransitionRouteGroups(request);
+  }
+
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Returns the list of all transition route groups in the specified flow.
@@ -209,7 +245,8 @@ public TransitionRouteGroupsStub getStub() {
    *
    * @param parent Required. The flow to list all transition route groups for. Format:
    *     `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
-   *     ID&gt;/flows/&lt;Flow ID&gt;`.
+   *     ID&gt;/flows/&lt;Flow ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;/agents/&lt;Agent ID&gt;.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListTransitionRouteGroupsPagedResponse listTransitionRouteGroups(FlowName parent) {
@@ -244,7 +281,8 @@ public final ListTransitionRouteGroupsPagedResponse listTransitionRouteGroups(Fl
    *
    * @param parent Required. The flow to list all transition route groups for. Format:
    *     `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
-   *     ID&gt;/flows/&lt;Flow ID&gt;`.
+   *     ID&gt;/flows/&lt;Flow ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;/agents/&lt;Agent ID&gt;.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListTransitionRouteGroupsPagedResponse listTransitionRouteGroups(String parent) {
@@ -383,7 +421,7 @@ public final ListTransitionRouteGroupsPagedResponse listTransitionRouteGroups(
    * try (TransitionRouteGroupsClient transitionRouteGroupsClient =
    *     TransitionRouteGroupsClient.create()) {
    *   TransitionRouteGroupName name =
-   *       TransitionRouteGroupName.of(
+   *       TransitionRouteGroupName.ofProjectLocationAgentFlowTransitionRouteGroupName(
    *           "[PROJECT]", "[LOCATION]", "[AGENT]", "[FLOW]", "[TRANSITION_ROUTE_GROUP]");
    *   TransitionRouteGroup response = transitionRouteGroupsClient.getTransitionRouteGroup(name);
    * }
@@ -392,7 +430,9 @@ public final ListTransitionRouteGroupsPagedResponse listTransitionRouteGroups(
    * @param name Required. The name of the
    *     [TransitionRouteGroup][google.cloud.dialogflow.cx.v3.TransitionRouteGroup]. Format:
    *     `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
-   *     ID&gt;/flows/&lt;Flow ID&gt;/transitionRouteGroups/&lt;Transition Route Group ID&gt;`.
+   *     ID&gt;/flows/&lt;Flow ID&gt;/transitionRouteGroups/&lt;Transition Route Group ID&gt;` or
+   *     `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
+   *     ID&gt;/transitionRouteGroups/&lt;Transition Route Group ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final TransitionRouteGroup getTransitionRouteGroup(TransitionRouteGroupName name) {
@@ -419,7 +459,7 @@ public final TransitionRouteGroup getTransitionRouteGroup(TransitionRouteGroupNa
    * try (TransitionRouteGroupsClient transitionRouteGroupsClient =
    *     TransitionRouteGroupsClient.create()) {
    *   String name =
-   *       TransitionRouteGroupName.of(
+   *       TransitionRouteGroupName.ofProjectLocationAgentFlowTransitionRouteGroupName(
    *               "[PROJECT]", "[LOCATION]", "[AGENT]", "[FLOW]", "[TRANSITION_ROUTE_GROUP]")
    *           .toString();
    *   TransitionRouteGroup response = transitionRouteGroupsClient.getTransitionRouteGroup(name);
@@ -429,7 +469,9 @@ public final TransitionRouteGroup getTransitionRouteGroup(TransitionRouteGroupNa
    * @param name Required. The name of the
    *     [TransitionRouteGroup][google.cloud.dialogflow.cx.v3.TransitionRouteGroup]. Format:
    *     `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
-   *     ID&gt;/flows/&lt;Flow ID&gt;/transitionRouteGroups/&lt;Transition Route Group ID&gt;`.
+   *     ID&gt;/flows/&lt;Flow ID&gt;/transitionRouteGroups/&lt;Transition Route Group ID&gt;` or
+   *     `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
+   *     ID&gt;/transitionRouteGroups/&lt;Transition Route Group ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final TransitionRouteGroup getTransitionRouteGroup(String name) {
@@ -456,7 +498,7 @@ public final TransitionRouteGroup getTransitionRouteGroup(String name) {
    *   GetTransitionRouteGroupRequest request =
    *       GetTransitionRouteGroupRequest.newBuilder()
    *           .setName(
-   *               TransitionRouteGroupName.of(
+   *               TransitionRouteGroupName.ofProjectLocationAgentFlowTransitionRouteGroupName(
    *                       "[PROJECT]",
    *                       "[LOCATION]",
    *                       "[AGENT]",
@@ -495,7 +537,7 @@ public final TransitionRouteGroup getTransitionRouteGroup(
    *   GetTransitionRouteGroupRequest request =
    *       GetTransitionRouteGroupRequest.newBuilder()
    *           .setName(
-   *               TransitionRouteGroupName.of(
+   *               TransitionRouteGroupName.ofProjectLocationAgentFlowTransitionRouteGroupName(
    *                       "[PROJECT]",
    *                       "[LOCATION]",
    *                       "[AGENT]",
@@ -516,6 +558,49 @@ public final TransitionRouteGroup getTransitionRouteGroup(
     return stub.getTransitionRouteGroupCallable();
   }
 
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Creates an [TransitionRouteGroup][google.cloud.dialogflow.cx.v3.TransitionRouteGroup] in the
+   * specified flow.
+   *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
+   * <p>Sample code:
+   *
+   * <pre>{@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 (TransitionRouteGroupsClient transitionRouteGroupsClient =
+   *     TransitionRouteGroupsClient.create()) {
+   *   AgentName parent = AgentName.of("[PROJECT]", "[LOCATION]", "[AGENT]");
+   *   TransitionRouteGroup transitionRouteGroup = TransitionRouteGroup.newBuilder().build();
+   *   TransitionRouteGroup response =
+   *       transitionRouteGroupsClient.createTransitionRouteGroup(parent, transitionRouteGroup);
+   * }
+   * }</pre>
+   *
+   * @param parent Required. The flow to create an
+   *     [TransitionRouteGroup][google.cloud.dialogflow.cx.v3.TransitionRouteGroup] for. Format:
+   *     `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
+   *     ID&gt;/flows/&lt;Flow ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;/agents/&lt;Agent ID&gt;` for agent-level groups.
+   * @param transitionRouteGroup Required. The transition route group to create.
+   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   */
+  public final TransitionRouteGroup createTransitionRouteGroup(
+      AgentName parent, TransitionRouteGroup transitionRouteGroup) {
+    CreateTransitionRouteGroupRequest request =
+        CreateTransitionRouteGroupRequest.newBuilder()
+            .setParent(parent == null ? null : parent.toString())
+            .setTransitionRouteGroup(transitionRouteGroup)
+            .build();
+    return createTransitionRouteGroup(request);
+  }
+
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Creates an [TransitionRouteGroup][google.cloud.dialogflow.cx.v3.TransitionRouteGroup] in the
@@ -544,7 +629,8 @@ public final TransitionRouteGroup getTransitionRouteGroup(
    * @param parent Required. The flow to create an
    *     [TransitionRouteGroup][google.cloud.dialogflow.cx.v3.TransitionRouteGroup] for. Format:
    *     `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
-   *     ID&gt;/flows/&lt;Flow ID&gt;`.
+   *     ID&gt;/flows/&lt;Flow ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;/agents/&lt;Agent ID&gt;` for agent-level groups.
    * @param transitionRouteGroup Required. The transition route group to create.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -586,7 +672,8 @@ public final TransitionRouteGroup createTransitionRouteGroup(
    * @param parent Required. The flow to create an
    *     [TransitionRouteGroup][google.cloud.dialogflow.cx.v3.TransitionRouteGroup] for. Format:
    *     `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
-   *     ID&gt;/flows/&lt;Flow ID&gt;`.
+   *     ID&gt;/flows/&lt;Flow ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;/agents/&lt;Agent ID&gt;` for agent-level groups.
    * @param transitionRouteGroup Required. The transition route group to create.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -804,7 +891,7 @@ public final TransitionRouteGroup updateTransitionRouteGroup(
    * try (TransitionRouteGroupsClient transitionRouteGroupsClient =
    *     TransitionRouteGroupsClient.create()) {
    *   TransitionRouteGroupName name =
-   *       TransitionRouteGroupName.of(
+   *       TransitionRouteGroupName.ofProjectLocationAgentFlowTransitionRouteGroupName(
    *           "[PROJECT]", "[LOCATION]", "[AGENT]", "[FLOW]", "[TRANSITION_ROUTE_GROUP]");
    *   transitionRouteGroupsClient.deleteTransitionRouteGroup(name);
    * }
@@ -813,7 +900,9 @@ public final TransitionRouteGroup updateTransitionRouteGroup(
    * @param name Required. The name of the
    *     [TransitionRouteGroup][google.cloud.dialogflow.cx.v3.TransitionRouteGroup] to delete.
    *     Format: `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
-   *     ID&gt;/flows/&lt;Flow ID&gt;/transitionRouteGroups/&lt;Transition Route Group ID&gt;`.
+   *     ID&gt;/flows/&lt;Flow ID&gt;/transitionRouteGroups/&lt;Transition Route Group ID&gt;` or
+   *     `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
+   *     ID&gt;/transitionRouteGroups/&lt;Transition Route Group ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final void deleteTransitionRouteGroup(TransitionRouteGroupName name) {
@@ -843,7 +932,7 @@ public final void deleteTransitionRouteGroup(TransitionRouteGroupName name) {
    * try (TransitionRouteGroupsClient transitionRouteGroupsClient =
    *     TransitionRouteGroupsClient.create()) {
    *   String name =
-   *       TransitionRouteGroupName.of(
+   *       TransitionRouteGroupName.ofProjectLocationAgentFlowTransitionRouteGroupName(
    *               "[PROJECT]", "[LOCATION]", "[AGENT]", "[FLOW]", "[TRANSITION_ROUTE_GROUP]")
    *           .toString();
    *   transitionRouteGroupsClient.deleteTransitionRouteGroup(name);
@@ -853,7 +942,9 @@ public final void deleteTransitionRouteGroup(TransitionRouteGroupName name) {
    * @param name Required. The name of the
    *     [TransitionRouteGroup][google.cloud.dialogflow.cx.v3.TransitionRouteGroup] to delete.
    *     Format: `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
-   *     ID&gt;/flows/&lt;Flow ID&gt;/transitionRouteGroups/&lt;Transition Route Group ID&gt;`.
+   *     ID&gt;/flows/&lt;Flow ID&gt;/transitionRouteGroups/&lt;Transition Route Group ID&gt;` or
+   *     `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
+   *     ID&gt;/transitionRouteGroups/&lt;Transition Route Group ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final void deleteTransitionRouteGroup(String name) {
@@ -883,7 +974,7 @@ public final void deleteTransitionRouteGroup(String name) {
    *   DeleteTransitionRouteGroupRequest request =
    *       DeleteTransitionRouteGroupRequest.newBuilder()
    *           .setName(
-   *               TransitionRouteGroupName.of(
+   *               TransitionRouteGroupName.ofProjectLocationAgentFlowTransitionRouteGroupName(
    *                       "[PROJECT]",
    *                       "[LOCATION]",
    *                       "[AGENT]",
@@ -924,7 +1015,7 @@ public final void deleteTransitionRouteGroup(DeleteTransitionRouteGroupRequest r
    *   DeleteTransitionRouteGroupRequest request =
    *       DeleteTransitionRouteGroupRequest.newBuilder()
    *           .setName(
-   *               TransitionRouteGroupName.of(
+   *               TransitionRouteGroupName.ofProjectLocationAgentFlowTransitionRouteGroupName(
    *                       "[PROJECT]",
    *                       "[LOCATION]",
    *                       "[AGENT]",

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

@@ -446,7 +446,7 @@
           "libraryClient": "TransitionRouteGroupsClient",
           "rpcs": {
             "CreateTransitionRouteGroup": {
-              "methods": ["createTransitionRouteGroup", "createTransitionRouteGroup", "createTransitionRouteGroup", "createTransitionRouteGroupCallable"]
+              "methods": ["createTransitionRouteGroup", "createTransitionRouteGroup", "createTransitionRouteGroup", "createTransitionRouteGroup", "createTransitionRouteGroupCallable"]
             },
             "DeleteTransitionRouteGroup": {
               "methods": ["deleteTransitionRouteGroup", "deleteTransitionRouteGroup", "deleteTransitionRouteGroup", "deleteTransitionRouteGroupCallable"]
@@ -461,7 +461,7 @@
               "methods": ["listLocations", "listLocationsPagedCallable", "listLocationsCallable"]
             },
             "ListTransitionRouteGroups": {
-              "methods": ["listTransitionRouteGroups", "listTransitionRouteGroups", "listTransitionRouteGroups", "listTransitionRouteGroupsPagedCallable", "listTransitionRouteGroupsCallable"]
+              "methods": ["listTransitionRouteGroups", "listTransitionRouteGroups", "listTransitionRouteGroups", "listTransitionRouteGroups", "listTransitionRouteGroupsPagedCallable", "listTransitionRouteGroupsCallable"]
             },
             "UpdateTransitionRouteGroup": {
               "methods": ["updateTransitionRouteGroup", "updateTransitionRouteGroup", "updateTransitionRouteGroupCallable"]

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

@@ -297,7 +297,7 @@
  * try (TransitionRouteGroupsClient transitionRouteGroupsClient =
  *     TransitionRouteGroupsClient.create()) {
  *   TransitionRouteGroupName name =
- *       TransitionRouteGroupName.of(
+ *       TransitionRouteGroupName.ofProjectLocationAgentFlowTransitionRouteGroupName(
  *           "[PROJECT]", "[LOCATION]", "[AGENT]", "[FLOW]", "[TRANSITION_ROUTE_GROUP]");
  *   TransitionRouteGroup response = transitionRouteGroupsClient.getTransitionRouteGroup(name);
  * }