chore: migrate to microgenerator (#294)

This PR was generated using Autosynth. 🌈

Synth log will be available here:
https://source.cloud.google.com/results/invocations/ff784592-64c9-46c3-9496-790383c9f6ca/targets

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

PiperOrigin-RevId: 346372957
Source-Link: googleapis/googleapis@857f70d
PiperOrigin-RevId: 346126713
Source-Link: googleapis/googleapis@b8b2f8c
PiperOrigin-RevId: 345493384
Source-Link: googleapis/googleapis@8677c18

Author: yoshi-automation

google-cloud-document-ai/src/main/java/com/google/cloud/documentai/v1beta1/DocumentUnderstandingServiceClient.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.documentai.v1beta1;
 
 import com.google.api.core.BetaApi;
@@ -29,7 +30,7 @@
 import java.util.concurrent.TimeUnit;
 import javax.annotation.Generated;
 
-// AUTO-GENERATED DOCUMENTATION AND SERVICE
+// AUTO-GENERATED DOCUMENTATION AND CLASS.
 /**
  * Service Description: Service to parse structured information from unstructured or semi-structured
  * documents using state-of-the-art Google AI such as natural language, computer vision, and
@@ -38,16 +39,7 @@
  * <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 (DocumentUnderstandingServiceClient documentUnderstandingServiceClient = DocumentUnderstandingServiceClient.create()) {
- *   List&lt;ProcessDocumentRequest&gt; requests = new ArrayList&lt;&gt;();
- *   BatchProcessDocumentsResponse response = documentUnderstandingServiceClient.batchProcessDocumentsAsync(requests).get();
- * }
- * </code>
- * </pre>
- *
- * <p>Note: close() needs to be called on the documentUnderstandingServiceClient object to clean up
+ * <p>Note: close() needs to be called on the DocumentUnderstandingServiceClient object to clean up
  * resources such as threads. In the example above, try-with-resources is used, which automatically
  * calls close().
  *
@@ -76,30 +68,28 @@
  *
  * <p>To customize credentials:
  *
- * <pre>
- * <code>
+ * <pre>{@code
  * DocumentUnderstandingServiceSettings documentUnderstandingServiceSettings =
  *     DocumentUnderstandingServiceSettings.newBuilder()
  *         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
  *         .build();
  * DocumentUnderstandingServiceClient documentUnderstandingServiceClient =
  *     DocumentUnderstandingServiceClient.create(documentUnderstandingServiceSettings);
- * </code>
- * </pre>
+ * }</pre>
  *
- * To customize the endpoint:
+ * <p>To customize the endpoint:
  *
- * <pre>
- * <code>
+ * <pre>{@code
  * DocumentUnderstandingServiceSettings documentUnderstandingServiceSettings =
  *     DocumentUnderstandingServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
  * DocumentUnderstandingServiceClient documentUnderstandingServiceClient =
  *     DocumentUnderstandingServiceClient.create(documentUnderstandingServiceSettings);
- * </code>
- * </pre>
+ * }</pre>
+ *
+ * <p>Please refer to the GitHub repository's samples for more quickstart code snippets.
  */
-@Generated("by gapic-generator")
 @BetaApi
+@Generated("by gapic-generator")
 public class DocumentUnderstandingServiceClient implements BackgroundResource {
   private final DocumentUnderstandingServiceSettings settings;
   private final DocumentUnderstandingServiceStub stub;
@@ -122,7 +112,7 @@ public static final DocumentUnderstandingServiceClient create(
 
   /**
    * Constructs an instance of DocumentUnderstandingServiceClient, using the given stub for making
-   * calls. This is for advanced usage - prefer to use DocumentUnderstandingServiceSettings}.
+   * calls. This is for advanced usage - prefer using create(DocumentUnderstandingServiceSettings).
    */
   @BetaApi("A restructuring of stub classes is planned, so this may break in the future")
   public static final DocumentUnderstandingServiceClient create(
@@ -163,105 +153,53 @@ public DocumentUnderstandingServiceStub getStub() {
    * Returns the OperationsClient that can be used to query the status of a long-running operation
    * returned by another API method call.
    */
-  @BetaApi(
-      "The surface for long-running operations is not stable yet and may change in the future.")
   public final OperationsClient getOperationsClient() {
     return operationsClient;
   }
 
-  // AUTO-GENERATED DOCUMENTATION AND METHOD
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * LRO endpoint to batch process many documents.
    *
-   * <p>Sample code:
-   *
-   * <pre><code>
-   * try (DocumentUnderstandingServiceClient documentUnderstandingServiceClient = DocumentUnderstandingServiceClient.create()) {
-   *   List&lt;ProcessDocumentRequest&gt; requests = new ArrayList&lt;&gt;();
-   *   BatchProcessDocumentsResponse response = documentUnderstandingServiceClient.batchProcessDocumentsAsync(requests).get();
-   * }
-   * </code></pre>
-   *
    * @param requests Required. Individual requests for each document.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
-  @BetaApi(
-      "The surface for long-running operations is not stable yet and may change in the future.")
   public final OperationFuture<BatchProcessDocumentsResponse, OperationMetadata>
       batchProcessDocumentsAsync(List<ProcessDocumentRequest> requests) {
     BatchProcessDocumentsRequest request =
         BatchProcessDocumentsRequest.newBuilder().addAllRequests(requests).build();
     return batchProcessDocumentsAsync(request);
   }
 
-  // AUTO-GENERATED DOCUMENTATION AND METHOD
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * LRO endpoint to batch process many documents.
    *
-   * <p>Sample code:
-   *
-   * <pre><code>
-   * try (DocumentUnderstandingServiceClient documentUnderstandingServiceClient = DocumentUnderstandingServiceClient.create()) {
-   *   List&lt;ProcessDocumentRequest&gt; requests = new ArrayList&lt;&gt;();
-   *   BatchProcessDocumentsRequest request = BatchProcessDocumentsRequest.newBuilder()
-   *     .addAllRequests(requests)
-   *     .build();
-   *   BatchProcessDocumentsResponse response = documentUnderstandingServiceClient.batchProcessDocumentsAsync(request).get();
-   * }
-   * </code></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
    */
-  @BetaApi(
-      "The surface for long-running operations is not stable yet and may change in the future.")
   public final OperationFuture<BatchProcessDocumentsResponse, OperationMetadata>
       batchProcessDocumentsAsync(BatchProcessDocumentsRequest request) {
     return batchProcessDocumentsOperationCallable().futureCall(request);
   }
 
-  // AUTO-GENERATED DOCUMENTATION AND METHOD
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * LRO endpoint to batch process many documents.
    *
    * <p>Sample code:
-   *
-   * <pre><code>
-   * try (DocumentUnderstandingServiceClient documentUnderstandingServiceClient = DocumentUnderstandingServiceClient.create()) {
-   *   List&lt;ProcessDocumentRequest&gt; requests = new ArrayList&lt;&gt;();
-   *   BatchProcessDocumentsRequest request = BatchProcessDocumentsRequest.newBuilder()
-   *     .addAllRequests(requests)
-   *     .build();
-   *   OperationFuture&lt;BatchProcessDocumentsResponse, OperationMetadata&gt; future = documentUnderstandingServiceClient.batchProcessDocumentsOperationCallable().futureCall(request);
-   *   // Do something
-   *   BatchProcessDocumentsResponse response = future.get();
-   * }
-   * </code></pre>
    */
-  @BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
   public final OperationCallable<
           BatchProcessDocumentsRequest, BatchProcessDocumentsResponse, OperationMetadata>
       batchProcessDocumentsOperationCallable() {
     return stub.batchProcessDocumentsOperationCallable();
   }
 
-  // AUTO-GENERATED DOCUMENTATION AND METHOD
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * LRO endpoint to batch process many documents.
    *
    * <p>Sample code:
-   *
-   * <pre><code>
-   * try (DocumentUnderstandingServiceClient documentUnderstandingServiceClient = DocumentUnderstandingServiceClient.create()) {
-   *   List&lt;ProcessDocumentRequest&gt; requests = new ArrayList&lt;&gt;();
-   *   BatchProcessDocumentsRequest request = BatchProcessDocumentsRequest.newBuilder()
-   *     .addAllRequests(requests)
-   *     .build();
-   *   ApiFuture&lt;Operation&gt; future = documentUnderstandingServiceClient.batchProcessDocumentsCallable().futureCall(request);
-   *   // Do something
-   *   Operation response = future.get();
-   * }
-   * </code></pre>
    */
   public final UnaryCallable<BatchProcessDocumentsRequest, Operation>
       batchProcessDocumentsCallable() {

google-cloud-document-ai/src/main/java/com/google/cloud/documentai/v1beta1/DocumentUnderstandingServiceSettings.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.documentai.v1beta1;
 
 import com.google.api.core.ApiFunction;
@@ -32,7 +33,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 DocumentUnderstandingServiceClient}.
  *
@@ -47,26 +48,28 @@
  * <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 batchProcessDocumentsAsync to 30 seconds:
+ * <p>For example, to set the total timeout of batchProcessDocuments to 30 seconds:
  *
- * <pre>
- * <code>
+ * <pre>{@code
  * DocumentUnderstandingServiceSettings.Builder documentUnderstandingServiceSettingsBuilder =
  *     DocumentUnderstandingServiceSettings.newBuilder();
  * documentUnderstandingServiceSettingsBuilder
  *     .batchProcessDocumentsSettings()
  *     .setRetrySettings(
- *         documentUnderstandingServiceSettingsBuilder.batchProcessDocumentsSettings().getRetrySettings().toBuilder()
+ *         documentUnderstandingServiceSettingsBuilder
+ *             .batchProcessDocumentsSettings()
+ *             .getRetrySettings()
+ *             .toBuilder()
  *             .setTotalTimeout(Duration.ofSeconds(30))
  *             .build());
- * DocumentUnderstandingServiceSettings documentUnderstandingServiceSettings = documentUnderstandingServiceSettingsBuilder.build();
- * </code>
- * </pre>
+ * DocumentUnderstandingServiceSettings documentUnderstandingServiceSettings =
+ *     documentUnderstandingServiceSettingsBuilder.build();
+ * }</pre>
  */
-@Generated("by gapic-generator")
-@BetaApi
+@Generated("by gapic-generator-java")
 public class DocumentUnderstandingServiceSettings
     extends ClientSettings<DocumentUnderstandingServiceSettings> {
+
   /** Returns the object with the settings used for calls to batchProcessDocuments. */
   public UnaryCallSettings<BatchProcessDocumentsRequest, Operation>
       batchProcessDocumentsSettings() {
@@ -75,8 +78,6 @@ public class DocumentUnderstandingServiceSettings
   }
 
   /** Returns the object with the settings used for calls to batchProcessDocuments. */
-  @BetaApi(
-      "The surface for long-running operations is not stable yet and may change in the future.")
   public OperationCallSettings<
           BatchProcessDocumentsRequest, BatchProcessDocumentsResponse, OperationMetadata>
       batchProcessDocumentsOperationSettings() {
@@ -145,18 +146,15 @@ protected DocumentUnderstandingServiceSettings(Builder settingsBuilder) throws I
   /** Builder for DocumentUnderstandingServiceSettings. */
   public static class Builder
       extends ClientSettings.Builder<DocumentUnderstandingServiceSettings, Builder> {
+
     protected Builder() throws IOException {
-      this((ClientContext) null);
+      this(((ClientContext) null));
     }
 
     protected Builder(ClientContext clientContext) {
       super(DocumentUnderstandingServiceStubSettings.newBuilder(clientContext));
     }
 
-    private static Builder createDefault() {
-      return new Builder(DocumentUnderstandingServiceStubSettings.newBuilder());
-    }
-
     protected Builder(DocumentUnderstandingServiceSettings settings) {
       super(settings.getStubSettings().toBuilder());
     }
@@ -165,11 +163,15 @@ protected Builder(DocumentUnderstandingServiceStubSettings.Builder stubSettings)
       super(stubSettings);
     }
 
+    private static Builder createDefault() {
+      return new Builder(DocumentUnderstandingServiceStubSettings.newBuilder());
+    }
+
     public DocumentUnderstandingServiceStubSettings.Builder getStubSettingsBuilder() {
       return ((DocumentUnderstandingServiceStubSettings.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.
      *
@@ -189,8 +191,6 @@ public Builder applyToAllUnaryMethods(
     }
 
     /** Returns the builder for the settings used for calls to batchProcessDocuments. */
-    @BetaApi(
-        "The surface for long-running operations is not stable yet and may change in the future.")
     public OperationCallSettings.Builder<
             BatchProcessDocumentsRequest, BatchProcessDocumentsResponse, OperationMetadata>
         batchProcessDocumentsOperationSettings() {

google-cloud-document-ai/src/main/java/com/google/cloud/documentai/v1beta1/package-info.java

@@ -5,7 +5,7 @@
  * 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,
@@ -15,29 +15,17 @@
  */
 
 /**
- * A client to Cloud Document AI API.
+ * The interfaces provided are listed below, along with usage samples.
  *
- * <p>The interfaces provided are listed below, along with usage samples.
- *
- * <p>================================== DocumentUnderstandingServiceClient
- * ==================================
+ * <p>======================= DocumentUnderstandingServiceClient =======================
  *
  * <p>Service Description: Service to parse structured information from unstructured or
  * semi-structured documents using state-of-the-art Google AI such as natural language, computer
  * vision, and translation.
  *
  * <p>Sample for DocumentUnderstandingServiceClient:
- *
- * <pre>
- * <code>
- * try (DocumentUnderstandingServiceClient documentUnderstandingServiceClient = DocumentUnderstandingServiceClient.create()) {
- *   List&lt;ProcessDocumentRequest&gt; requests = new ArrayList&lt;&gt;();
- *   BatchProcessDocumentsResponse response = documentUnderstandingServiceClient.batchProcessDocumentsAsync(requests);
- * }
- * </code>
- * </pre>
  */
-@Generated("by gapic-generator")
+@Generated("by gapic-generator-java")
 package com.google.cloud.documentai.v1beta1;
 
 import javax.annotation.Generated;