chore: update gapic-generator-java to 0.0.20 (#437)

This PR was generated using Autosynth. 🌈 Synth log will be available here: https://source.cloud.google.com/results/invocations/62fbd93a-0469-4c6e-9547-84dbcc2a707d/targets - [ ] To automatically regenerate this PR, check this box. PiperOrigin-RevId: 357800868 Source-Link: googleapis/googleapis@e8bc447 PiperOrigin-RevId: 356341083 Source-Link: googleapis/googleapis@8d8c008 PiperOrigin-RevId: 352605952 Source-Link: googleapis/googleapis@118fbae PiperOrigin-RevId: 350949863 Source-Link: googleapis/googleapis@91e206b PiperOrigin-RevId: 350067652 Source-Link: googleapis/googleapis@ad3bb00 PiperOrigin-RevId: 348696929 Source-Link: googleapis/googleapis@8a6f4d9 PiperOrigin-RevId: 348673154 Source-Link: googleapis/googleapis@0795e3f docs: update comments on parameters and validation result. chore: update gapic-generator-java to 0.0.16 chore: update gapic-generator-java to 0.0.18 docs: clarified voice selection params names docs: generate sample code in the Java microgenerator
googleapis · Feb 19, 2021 · ccbd3e6 · ccbd3e6
1 parent 208ebdf
commit ccbd3e6
Show file tree

Hide file tree

Showing 131 changed files with 7,154 additions and 711 deletions.
diff --git a/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/AgentsClient.java b/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/AgentsClient.java
diff --git a/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/ContextsClient.java b/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/ContextsClient.java
diff --git a/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/EntityTypesClient.java b/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/EntityTypesClient.java
diff --git a/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/EnvironmentsClient.java b/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/EnvironmentsClient.java
@@ -41,6 +41,20 @@
  * <p>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:
  *
+ * <pre>{@code
+ * try (EnvironmentsClient environmentsClient = EnvironmentsClient.create()) {
+ *   ListEnvironmentsRequest request =
+ *       ListEnvironmentsRequest.newBuilder()
+ *           .setParent(EnvironmentName.of("[PROJECT]", "[ENVIRONMENT]").toString())
+ *           .setPageSize(883849137)
+ *           .setPageToken("pageToken873572522")
+ *           .build();
+ *   for (Environment element : environmentsClient.listEnvironments(request).iterateAll()) {
+ *     // doThingsWith(element);
+ *   }
+ * }
+ * }</pre>
+ *
  * <p>Note: close() needs to be called on the EnvironmentsClient object to clean up resources such
  * as threads. In the example above, try-with-resources is used, which automatically calls close().
  *
@@ -87,8 +101,7 @@
  *
  * <p>Please refer to the GitHub repository's samples for more quickstart code snippets.
  */
-@BetaApi
-@Generated("by gapic-generator")
+@Generated("by gapic-generator-java")
 public class EnvironmentsClient implements BackgroundResource {
   private final EnvironmentsSettings settings;
   private final EnvironmentsStub stub;
@@ -144,6 +157,22 @@ public EnvironmentsStub getStub() {
   /**
    * Returns the list of all non-draft environments of the specified agent.
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (EnvironmentsClient environmentsClient = EnvironmentsClient.create()) {
+   *   ListEnvironmentsRequest request =
+   *       ListEnvironmentsRequest.newBuilder()
+   *           .setParent(EnvironmentName.of("[PROJECT]", "[ENVIRONMENT]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .build();
+   *   for (Environment element : environmentsClient.listEnvironments(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
+   *
    * @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
    */
@@ -156,6 +185,23 @@ public final ListEnvironmentsPagedResponse listEnvironments(ListEnvironmentsRequ
    * Returns the list of all non-draft environments of the specified agent.
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (EnvironmentsClient environmentsClient = EnvironmentsClient.create()) {
+   *   ListEnvironmentsRequest request =
+   *       ListEnvironmentsRequest.newBuilder()
+   *           .setParent(EnvironmentName.of("[PROJECT]", "[ENVIRONMENT]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .build();
+   *   ApiFuture<Environment> future =
+   *       environmentsClient.listEnvironmentsPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (Environment element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
    */
   public final UnaryCallable<ListEnvironmentsRequest, ListEnvironmentsPagedResponse>
       listEnvironmentsPagedCallable() {
@@ -167,6 +213,24 @@ public final ListEnvironmentsPagedResponse listEnvironments(ListEnvironmentsRequ
    * Returns the list of all non-draft environments of the specified agent.
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (EnvironmentsClient environmentsClient = EnvironmentsClient.create()) {
+   *   while (true) {
+   *     ListEnvironmentsResponse response =
+   *         environmentsClient.listEnvironmentsCallable().call(request);
+   *     for (Environment element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }</pre>
    */
   public final UnaryCallable<ListEnvironmentsRequest, ListEnvironmentsResponse>
       listEnvironmentsCallable() {