feat: Adds support for RefineText

feat: Adds option for contextual translation with glossaries
feat: Adds option for pdf_native only document translation

PiperOrigin-RevId: 828181593

Author: Google APIs

google/cloud/translate/v3beta1/translation_service.proto

@@ -173,6 +173,14 @@ service TranslationService {
       metadata_type: "DeleteGlossaryMetadata"
     };
   }
+
+  // Refines the input translated text to improve the quality.
+  rpc RefineText(RefineTextRequest) returns (RefineTextResponse) {
+    option (google.api.http) = {
+      post: "/v3beta1/{parent=projects/*/locations/*}:refineText"
+      body: "*"
+    };
+  }
 }
 
 // Configures which glossary should be used for a specific target language,
@@ -185,6 +193,11 @@ message TranslateTextGlossaryConfig {
   // Optional. Indicates match is case-insensitive.
   // Default value is false if missing.
   bool ignore_case = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If set to true, the glossary will be used for contextual
+  // translation.
+  bool contextual_translation_enabled = 4
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The request message for synchronous translation.
@@ -684,7 +697,12 @@ message TranslateDocumentRequest {
   //
   // Models and glossaries must be within the same region (have the same
   // location-id), otherwise an INVALID_ARGUMENT (400) error is returned.
-  string parent = 1 [(google.api.field_behavior) = REQUIRED];
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // Optional. The BCP-47 language code of the input document if known, for
   // example, "en-US" or "sr-Latn". Supported language codes are listed in
@@ -1302,6 +1320,9 @@ message BatchTranslateDocumentRequest {
 
   // Optional. If true, enable auto rotation correction in DVS.
   bool enable_rotation_correction = 12 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If true, only native pdf pages will be translated.
+  bool pdf_native_only = 13 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Input configuration for BatchTranslateDocument request.
@@ -1493,3 +1514,48 @@ message BatchTranslateDocumentMetadata {
   // Time when the operation was submitted.
   google.protobuf.Timestamp submit_time = 10;
 }
+
+// A single refinement entry for RefineTextRequest.
+message RefinementEntry {
+  // Required. The source text to be refined.
+  string source_text = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The original translation of the source text.
+  string original_translation = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for RefineText.
+message RefineTextRequest {
+  // Required. Project or location to make a call. Must refer to a caller's
+  // project.
+  //
+  // Format: `projects/{project-number-or-id}/locations/{location-id}`.
+  //
+  // For global calls, use `projects/{project-number-or-id}/locations/global` or
+  // `projects/{project-number-or-id}`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Required. The source texts and original translations in the source and
+  // target languages.
+  repeated RefinementEntry refinement_entries = 2
+      [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The BCP-47 language code of the source text in the request, for
+  // example, "en-US".
+  string source_language_code = 4 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The BCP-47 language code for translation output, for example,
+  // "zh-CN".
+  string target_language_code = 5 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response message for RefineText.
+message RefineTextResponse {
+  // The refined translations obtained from the original translations.
+  repeated string refined_translations = 1;
+}