feat: added v3 proto for online/batch document translation and updated v3beta1 proto for format conversion (#767)

- [ ] Regenerate this pull request now.

PiperOrigin-RevId: 393656336

Source-Link: googleapis/googleapis@17d3fb2

Source-Link: https://github.com/googleapis/googleapis-gen/commit/00ca50bdde80906d6f62314ef4f7630b8cdb6e15

Author: gcf-owl-bot[bot]

google-cloud-translate/src/main/java/com/google/cloud/translate/v3/TranslationServiceClient.java

@@ -194,7 +194,8 @@ public final OperationsClient getOperationsClient() {
    * @param targetLanguageCode Required. The BCP-47 language code to use for translation of the
    *     input text, set to one of the language codes listed in Language Support.
    * @param contents Required. The content of the input in string format. We recommend the total
-   *     content be less than 30k codepoints. Use BatchTranslateText for larger text.
+   *     content be less than 30k codepoints. The max length of this field is 1024. Use
+   *     BatchTranslateText for larger text.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final TranslateTextResponse translateText(
@@ -235,7 +236,8 @@ public final TranslateTextResponse translateText(
    * @param targetLanguageCode Required. The BCP-47 language code to use for translation of the
    *     input text, set to one of the language codes listed in Language Support.
    * @param contents Required. The content of the input in string format. We recommend the total
-   *     content be less than 30k codepoints. Use BatchTranslateText for larger text.
+   *     content be less than 30k codepoints. The max length of this field is 1024. Use
+   *     BatchTranslateText for larger text.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final TranslateTextResponse translateText(
@@ -283,10 +285,9 @@ public final TranslateTextResponse translateText(
    *     `projects/{project-number-or-id}/locations/{location-id}/models/{model-id}`
    *     <p>- General (built-in) models:
    *     `projects/{project-number-or-id}/locations/{location-id}/models/general/nmt`,
-   *     `projects/{project-number-or-id}/locations/{location-id}/models/general/base`
    *     <p>For global (non-regionalized) requests, use `location-id` `global`. For example,
    *     `projects/{project-number-or-id}/locations/global/models/general/nmt`.
-   *     <p>If missing, the system decides which google base model to use.
+   *     <p>If not provided, the default Google model (NMT) will be used.
    * @param mimeType Optional. The format of the source text, for example, "text/html",
    *     "text/plain". If left blank, the MIME type defaults to "text/html".
    * @param sourceLanguageCode Optional. The BCP-47 language code of the input text if known, for
@@ -296,7 +297,8 @@ public final TranslateTextResponse translateText(
    * @param targetLanguageCode Required. The BCP-47 language code to use for translation of the
    *     input text, set to one of the language codes listed in Language Support.
    * @param contents Required. The content of the input in string format. We recommend the total
-   *     content be less than 30k codepoints. Use BatchTranslateText for larger text.
+   *     content be less than 30k codepoints. The max length of this field is 1024. Use
+   *     BatchTranslateText for larger text.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final TranslateTextResponse translateText(
@@ -352,10 +354,9 @@ public final TranslateTextResponse translateText(
    *     `projects/{project-number-or-id}/locations/{location-id}/models/{model-id}`
    *     <p>- General (built-in) models:
    *     `projects/{project-number-or-id}/locations/{location-id}/models/general/nmt`,
-   *     `projects/{project-number-or-id}/locations/{location-id}/models/general/base`
    *     <p>For global (non-regionalized) requests, use `location-id` `global`. For example,
    *     `projects/{project-number-or-id}/locations/global/models/general/nmt`.
-   *     <p>If missing, the system decides which google base model to use.
+   *     <p>If not provided, the default Google model (NMT) will be used.
    * @param mimeType Optional. The format of the source text, for example, "text/html",
    *     "text/plain". If left blank, the MIME type defaults to "text/html".
    * @param sourceLanguageCode Optional. The BCP-47 language code of the input text if known, for
@@ -365,7 +366,8 @@ public final TranslateTextResponse translateText(
    * @param targetLanguageCode Required. The BCP-47 language code to use for translation of the
    *     input text, set to one of the language codes listed in Language Support.
    * @param contents Required. The content of the input in string format. We recommend the total
-   *     content be less than 30k codepoints. Use BatchTranslateText for larger text.
+   *     content be less than 30k codepoints. The max length of this field is 1024. Use
+   *     BatchTranslateText for larger text.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final TranslateTextResponse translateText(
@@ -624,9 +626,8 @@ public final DetectLanguageResponse detectLanguage(DetectLanguageRequest request
    *     `projects/{project-number-or-id}/locations/{location-id}/models/{model-id}`
    *     <p>- General (built-in) models:
    *     `projects/{project-number-or-id}/locations/{location-id}/models/general/nmt`,
-   *     `projects/{project-number-or-id}/locations/{location-id}/models/general/base`
    *     <p>Returns languages supported by the specified model. If missing, we get supported
-   *     languages of Google general base (PBMT) model.
+   *     languages of Google general NMT model.
    * @param displayLanguageCode Optional. The language to use to return localized, human readable
    *     names of supported languages. If missing, then display names are not returned in a
    *     response.
@@ -673,9 +674,8 @@ public final SupportedLanguages getSupportedLanguages(
    *     `projects/{project-number-or-id}/locations/{location-id}/models/{model-id}`
    *     <p>- General (built-in) models:
    *     `projects/{project-number-or-id}/locations/{location-id}/models/general/nmt`,
-   *     `projects/{project-number-or-id}/locations/{location-id}/models/general/base`
    *     <p>Returns languages supported by the specified model. If missing, we get supported
-   *     languages of Google general base (PBMT) model.
+   *     languages of Google general NMT model.
    * @param displayLanguageCode Optional. The language to use to return localized, human readable
    *     names of supported languages. If missing, then display names are not returned in a
    *     response.
@@ -743,6 +743,67 @@ public final SupportedLanguages getSupportedLanguages(GetSupportedLanguagesReque
     return stub.getSupportedLanguagesCallable();
   }
 
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Translates documents in synchronous mode.
+   *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (TranslationServiceClient translationServiceClient = TranslationServiceClient.create()) {
+   *   TranslateDocumentRequest request =
+   *       TranslateDocumentRequest.newBuilder()
+   *           .setParent("parent-995424086")
+   *           .setSourceLanguageCode("sourceLanguageCode1645917472")
+   *           .setTargetLanguageCode("targetLanguageCode-106414698")
+   *           .setDocumentInputConfig(DocumentInputConfig.newBuilder().build())
+   *           .setDocumentOutputConfig(DocumentOutputConfig.newBuilder().build())
+   *           .setModel("model104069929")
+   *           .setGlossaryConfig(TranslateTextGlossaryConfig.newBuilder().build())
+   *           .putAllLabels(new HashMap<String, String>())
+   *           .build();
+   *   TranslateDocumentResponse response = translationServiceClient.translateDocument(request);
+   * }
+   * }</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
+   */
+  public final TranslateDocumentResponse translateDocument(TranslateDocumentRequest request) {
+    return translateDocumentCallable().call(request);
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Translates documents in synchronous mode.
+   *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (TranslationServiceClient translationServiceClient = TranslationServiceClient.create()) {
+   *   TranslateDocumentRequest request =
+   *       TranslateDocumentRequest.newBuilder()
+   *           .setParent("parent-995424086")
+   *           .setSourceLanguageCode("sourceLanguageCode1645917472")
+   *           .setTargetLanguageCode("targetLanguageCode-106414698")
+   *           .setDocumentInputConfig(DocumentInputConfig.newBuilder().build())
+   *           .setDocumentOutputConfig(DocumentOutputConfig.newBuilder().build())
+   *           .setModel("model104069929")
+   *           .setGlossaryConfig(TranslateTextGlossaryConfig.newBuilder().build())
+   *           .putAllLabels(new HashMap<String, String>())
+   *           .build();
+   *   ApiFuture<TranslateDocumentResponse> future =
+   *       translationServiceClient.translateDocumentCallable().futureCall(request);
+   *   // Do something.
+   *   TranslateDocumentResponse response = future.get();
+   * }
+   * }</pre>
+   */
+  public final UnaryCallable<TranslateDocumentRequest, TranslateDocumentResponse>
+      translateDocumentCallable() {
+    return stub.translateDocumentCallable();
+  }
+
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Translates a large volume of text in asynchronous batch mode. This function provides real-time
@@ -852,6 +913,121 @@ public final UnaryCallable<BatchTranslateTextRequest, Operation> batchTranslateT
     return stub.batchTranslateTextCallable();
   }
 
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Translates a large volume of document in asynchronous batch mode. This function provides
+   * real-time output as the inputs are being processed. If caller cancels a request, the partial
+   * results (for an input file, it's all or nothing) may still be available on the specified output
+   * location.
+   *
+   * <p>This call returns immediately and you can use google.longrunning.Operation.name to poll the
+   * status of the call.
+   *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (TranslationServiceClient translationServiceClient = TranslationServiceClient.create()) {
+   *   BatchTranslateDocumentRequest request =
+   *       BatchTranslateDocumentRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setSourceLanguageCode("sourceLanguageCode1645917472")
+   *           .addAllTargetLanguageCodes(new ArrayList<String>())
+   *           .addAllInputConfigs(new ArrayList<BatchDocumentInputConfig>())
+   *           .setOutputConfig(BatchDocumentOutputConfig.newBuilder().build())
+   *           .putAllModels(new HashMap<String, String>())
+   *           .putAllGlossaries(new HashMap<String, TranslateTextGlossaryConfig>())
+   *           .putAllFormatConversions(new HashMap<String, String>())
+   *           .build();
+   *   BatchTranslateDocumentResponse response =
+   *       translationServiceClient.batchTranslateDocumentAsync(request).get();
+   * }
+   * }</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
+   */
+  public final OperationFuture<BatchTranslateDocumentResponse, BatchTranslateDocumentMetadata>
+      batchTranslateDocumentAsync(BatchTranslateDocumentRequest request) {
+    return batchTranslateDocumentOperationCallable().futureCall(request);
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Translates a large volume of document in asynchronous batch mode. This function provides
+   * real-time output as the inputs are being processed. If caller cancels a request, the partial
+   * results (for an input file, it's all or nothing) may still be available on the specified output
+   * location.
+   *
+   * <p>This call returns immediately and you can use google.longrunning.Operation.name to poll the
+   * status of the call.
+   *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (TranslationServiceClient translationServiceClient = TranslationServiceClient.create()) {
+   *   BatchTranslateDocumentRequest request =
+   *       BatchTranslateDocumentRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setSourceLanguageCode("sourceLanguageCode1645917472")
+   *           .addAllTargetLanguageCodes(new ArrayList<String>())
+   *           .addAllInputConfigs(new ArrayList<BatchDocumentInputConfig>())
+   *           .setOutputConfig(BatchDocumentOutputConfig.newBuilder().build())
+   *           .putAllModels(new HashMap<String, String>())
+   *           .putAllGlossaries(new HashMap<String, TranslateTextGlossaryConfig>())
+   *           .putAllFormatConversions(new HashMap<String, String>())
+   *           .build();
+   *   OperationFuture<BatchTranslateDocumentResponse, BatchTranslateDocumentMetadata> future =
+   *       translationServiceClient.batchTranslateDocumentOperationCallable().futureCall(request);
+   *   // Do something.
+   *   BatchTranslateDocumentResponse response = future.get();
+   * }
+   * }</pre>
+   */
+  public final OperationCallable<
+          BatchTranslateDocumentRequest,
+          BatchTranslateDocumentResponse,
+          BatchTranslateDocumentMetadata>
+      batchTranslateDocumentOperationCallable() {
+    return stub.batchTranslateDocumentOperationCallable();
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Translates a large volume of document in asynchronous batch mode. This function provides
+   * real-time output as the inputs are being processed. If caller cancels a request, the partial
+   * results (for an input file, it's all or nothing) may still be available on the specified output
+   * location.
+   *
+   * <p>This call returns immediately and you can use google.longrunning.Operation.name to poll the
+   * status of the call.
+   *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (TranslationServiceClient translationServiceClient = TranslationServiceClient.create()) {
+   *   BatchTranslateDocumentRequest request =
+   *       BatchTranslateDocumentRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setSourceLanguageCode("sourceLanguageCode1645917472")
+   *           .addAllTargetLanguageCodes(new ArrayList<String>())
+   *           .addAllInputConfigs(new ArrayList<BatchDocumentInputConfig>())
+   *           .setOutputConfig(BatchDocumentOutputConfig.newBuilder().build())
+   *           .putAllModels(new HashMap<String, String>())
+   *           .putAllGlossaries(new HashMap<String, TranslateTextGlossaryConfig>())
+   *           .putAllFormatConversions(new HashMap<String, String>())
+   *           .build();
+   *   ApiFuture<Operation> future =
+   *       translationServiceClient.batchTranslateDocumentCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }</pre>
+   */
+  public final UnaryCallable<BatchTranslateDocumentRequest, Operation>
+      batchTranslateDocumentCallable() {
+    return stub.batchTranslateDocumentCallable();
+  }
+
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Creates a glossary and returns the long-running operation. Returns NOT_FOUND, if the project

google-cloud-translate/src/main/java/com/google/cloud/translate/v3/TranslationServiceSettings.java

@@ -88,6 +88,12 @@ public UnaryCallSettings<DetectLanguageRequest, DetectLanguageResponse> detectLa
     return ((TranslationServiceStubSettings) getStubSettings()).getSupportedLanguagesSettings();
   }
 
+  /** Returns the object with the settings used for calls to translateDocument. */
+  public UnaryCallSettings<TranslateDocumentRequest, TranslateDocumentResponse>
+      translateDocumentSettings() {
+    return ((TranslationServiceStubSettings) getStubSettings()).translateDocumentSettings();
+  }
+
   /** Returns the object with the settings used for calls to batchTranslateText. */
   public UnaryCallSettings<BatchTranslateTextRequest, Operation> batchTranslateTextSettings() {
     return ((TranslationServiceStubSettings) getStubSettings()).batchTranslateTextSettings();
@@ -101,6 +107,22 @@ public UnaryCallSettings<BatchTranslateTextRequest, Operation> batchTranslateTex
         .batchTranslateTextOperationSettings();
   }
 
+  /** Returns the object with the settings used for calls to batchTranslateDocument. */
+  public UnaryCallSettings<BatchTranslateDocumentRequest, Operation>
+      batchTranslateDocumentSettings() {
+    return ((TranslationServiceStubSettings) getStubSettings()).batchTranslateDocumentSettings();
+  }
+
+  /** Returns the object with the settings used for calls to batchTranslateDocument. */
+  public OperationCallSettings<
+          BatchTranslateDocumentRequest,
+          BatchTranslateDocumentResponse,
+          BatchTranslateDocumentMetadata>
+      batchTranslateDocumentOperationSettings() {
+    return ((TranslationServiceStubSettings) getStubSettings())
+        .batchTranslateDocumentOperationSettings();
+  }
+
   /** Returns the object with the settings used for calls to createGlossary. */
   public UnaryCallSettings<CreateGlossaryRequest, Operation> createGlossarySettings() {
     return ((TranslationServiceStubSettings) getStubSettings()).createGlossarySettings();
@@ -251,6 +273,12 @@ public Builder applyToAllUnaryMethods(
       return getStubSettingsBuilder().getSupportedLanguagesSettings();
     }
 
+    /** Returns the builder for the settings used for calls to translateDocument. */
+    public UnaryCallSettings.Builder<TranslateDocumentRequest, TranslateDocumentResponse>
+        translateDocumentSettings() {
+      return getStubSettingsBuilder().translateDocumentSettings();
+    }
+
     /** Returns the builder for the settings used for calls to batchTranslateText. */
     public UnaryCallSettings.Builder<BatchTranslateTextRequest, Operation>
         batchTranslateTextSettings() {
@@ -264,6 +292,21 @@ public Builder applyToAllUnaryMethods(
       return getStubSettingsBuilder().batchTranslateTextOperationSettings();
     }
 
+    /** Returns the builder for the settings used for calls to batchTranslateDocument. */
+    public UnaryCallSettings.Builder<BatchTranslateDocumentRequest, Operation>
+        batchTranslateDocumentSettings() {
+      return getStubSettingsBuilder().batchTranslateDocumentSettings();
+    }
+
+    /** Returns the builder for the settings used for calls to batchTranslateDocument. */
+    public OperationCallSettings.Builder<
+            BatchTranslateDocumentRequest,
+            BatchTranslateDocumentResponse,
+            BatchTranslateDocumentMetadata>
+        batchTranslateDocumentOperationSettings() {
+      return getStubSettingsBuilder().batchTranslateDocumentOperationSettings();
+    }
+
     /** Returns the builder for the settings used for calls to createGlossary. */
     public UnaryCallSettings.Builder<CreateGlossaryRequest, Operation> createGlossarySettings() {
       return getStubSettingsBuilder().createGlossarySettings();

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

@@ -10,6 +10,9 @@
         "grpc": {
           "libraryClient": "TranslationServiceClient",
           "rpcs": {
+            "BatchTranslateDocument": {
+              "methods": ["batchTranslateDocumentAsync", "batchTranslateDocumentOperationCallable", "batchTranslateDocumentCallable"]
+            },
             "BatchTranslateText": {
               "methods": ["batchTranslateTextAsync", "batchTranslateTextOperationCallable", "batchTranslateTextCallable"]
             },
@@ -31,6 +34,9 @@
             "ListGlossaries": {
               "methods": ["listGlossaries", "listGlossaries", "listGlossaries", "listGlossariesPagedCallable", "listGlossariesCallable"]
             },
+            "TranslateDocument": {
+              "methods": ["translateDocument", "translateDocumentCallable"]
+            },
             "TranslateText": {
               "methods": ["translateText", "translateText", "translateText", "translateText", "translateText", "translateTextCallable"]
             }

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

@@ -15,7 +15,9 @@
  */
 
 /**
- * The interfaces provided are listed below, along with usage samples.
+ * A client to Cloud Translation API
+ *
+ * <p>The interfaces provided are listed below, along with usage samples.
  *
  * <p>======================= TranslationServiceClient =======================
  *