feat: Added shadow removal and rotation correction options to Document Translation and Batch Document Translation API

Google APIs · copybara-github · commit a3aded7c2872 · 2023-08-07T11:33:07.000-07:00
PiperOrigin-RevId: 554540042
diff --git a/google/cloud/translate/v3beta1/translation_service.proto b/google/cloud/translate/v3beta1/translation_service.proto
@@ -106,7 +106,7 @@ service TranslationService {
     };
   }
 
-  // Translates a large volume of documents in asynchronous batch mode.
+  // 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.
@@ -532,7 +532,7 @@ message OutputConfig {
     // Since index.csv will be keeping updated during the process, please make
     // sure there is no custom retention policy applied on the output bucket
     // that may avoid file updating.
-    // (https://cloud.google.com/storage/docs/bucket-lock?hl=en#retention-policy)
+    // (https://cloud.google.com/storage/docs/bucket-lock#retention-policy)
     //
     // The format of translations_file (for target language code 'trg') is:
     // `gs://translation_test/a_b_c_'trg'_translations.[extension]`
@@ -740,6 +740,28 @@ message TranslateDocumentRequest {
   // See https://cloud.google.com/translate/docs/advanced/labels for more
   // information.
   map<string, string> labels = 8 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. This flag is to support user customized attribution.
+  // If not provided, the default is `Machine Translated by Google`.
+  // Customized attribution should follow rules in
+  // https://cloud.google.com/translate/attribution#attribution_and_logos
+  string customized_attribution = 10 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. is_translate_native_pdf_only field for external customers.
+  // If true, the page limit of online native pdf translation is 300 and only
+  // native pdf pages will be translated.
+  bool is_translate_native_pdf_only = 11
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If true, use the text removal server to remove the shadow text on
+  // background image for native pdf translation.
+  // Shadow removal feature can only be enabled when
+  // is_translate_native_pdf_only: false && pdf_native_only: false
+  bool enable_shadow_removal_native_pdf = 12
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If true, enable auto rotation correction in DVS.
+  bool enable_rotation_correction = 13 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // A translated document message.
@@ -946,9 +968,8 @@ message GlossaryInputConfig {
     // For equivalent term sets glossaries:
     //
     // - CSV (`.csv`): Multi-column CSV file defining equivalent glossary terms
-    //   in multiple languages. The format is defined for Google Translation
-    //   Toolkit and documented in [Use a
-    //   glossary](https://support.google.com/translatortoolkit/answer/6306379?hl=en).
+    //   in multiple languages. See documentation for more information -
+    //   [glossaries](https://cloud.google.com/translate/docs/advanced/glossary).
     GcsSource gcs_source = 1;
   }
 }
@@ -1256,6 +1277,22 @@ message BatchTranslateDocumentRequest {
   // original file.
   map<string, string> format_conversions = 8
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. This flag is to support user customized attribution.
+  // If not provided, the default is `Machine Translated by Google`.
+  // Customized attribution should follow rules in
+  // https://cloud.google.com/translate/attribution#attribution_and_logos
+  string customized_attribution = 10 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If true, use the text removal server to remove the shadow text on
+  // background image for native pdf translation.
+  // Shadow removal feature can only be enabled when
+  // is_translate_native_pdf_only: false && pdf_native_only: false
+  bool enable_shadow_removal_native_pdf = 11
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If true, enable auto rotation correction in DVS.
+  bool enable_rotation_correction = 12 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Input configuration for BatchTranslateDocument request.
