Skip to content
This repository has been archived by the owner on Oct 14, 2023. It is now read-only.

fix: add model signature for batch document translation #832

Merged
merged 2 commits into from Oct 19, 2021
Merged

fix: add model signature for batch document translation #832

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
dfbbc77
fix: add model signature for batch document translation
gcf-owl-bot[bot] Oct 19, 2021
7895e1b
🦉 Updates from OwlBot
gcf-owl-bot[bot] Oct 19, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
View file
Open in desktop
Expand Up @@ -57,13 +57,13 @@ implementation 'com.google.cloud:google-cloud-translate'
If you are using Gradle without BOM, add this to your dependencies

```Groovy
implementation 'com.google.cloud:google-cloud-translate:2.1.6'
implementation 'com.google.cloud:google-cloud-translate:2.1.7'
```

If you are using SBT, add this to your dependencies

```Scala
libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.1.6"
libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.1.7"
```

## Authentication
Expand Down
124 changes: 124 additions & 0 deletions ...cloud-translate/src/main/java/com/google/cloud/translate/v3/TranslationServiceClient.java
View file
Open in desktop
Expand Up @@ -913,6 +913,130 @@ 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()) {
* LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
* String sourceLanguageCode = "sourceLanguageCode1645917472";
* List<String> targetLanguageCodes = new ArrayList<>();
* List<BatchDocumentInputConfig> inputConfigs = new ArrayList<>();
* BatchDocumentOutputConfig outputConfig = BatchDocumentOutputConfig.newBuilder().build();
* BatchTranslateDocumentResponse response =
* translationServiceClient
* .batchTranslateDocumentAsync(
* parent, sourceLanguageCode, targetLanguageCodes, inputConfigs, outputConfig)
* .get();
* }
* }</pre>
*
* @param parent Required. Location to make a regional call.
* <p>Format: `projects/{project-number-or-id}/locations/{location-id}`.
* <p>The `global` location is not supported for batch translation.
* <p>Only AutoML Translation models or glossaries within the same region (have the same
* location-id) can be used, otherwise an INVALID_ARGUMENT (400) error is returned.
* @param sourceLanguageCode Required. The BCP-47 language code of the input document if known,
* for example, "en-US" or "sr-Latn". Supported language codes are listed in Language Support
* (https://cloud.google.com/translate/docs/languages).
* @param targetLanguageCodes Required. The BCP-47 language code to use for translation of the
* input document. Specify up to 10 language codes here.
* @param inputConfigs Required. Input configurations. The total number of files matched should be
* &lt;= 100. The total content size to translate should be &lt;= 100M Unicode codepoints. The
* files must use UTF-8 encoding.
* @param outputConfig Required. Output configuration. If 2 input configs match to the same file
* (that is, same input path), we don't generate output for duplicate inputs.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture<BatchTranslateDocumentResponse, BatchTranslateDocumentMetadata>
batchTranslateDocumentAsync(
LocationName parent,
String sourceLanguageCode,
List<String> targetLanguageCodes,
List<BatchDocumentInputConfig> inputConfigs,
BatchDocumentOutputConfig outputConfig) {
BatchTranslateDocumentRequest request =
BatchTranslateDocumentRequest.newBuilder()
.setParent(parent == null ? null : parent.toString())
.setSourceLanguageCode(sourceLanguageCode)
.addAllTargetLanguageCodes(targetLanguageCodes)
.addAllInputConfigs(inputConfigs)
.setOutputConfig(outputConfig)
.build();
return batchTranslateDocumentAsync(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()) {
* String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
* String sourceLanguageCode = "sourceLanguageCode1645917472";
* List<String> targetLanguageCodes = new ArrayList<>();
* List<BatchDocumentInputConfig> inputConfigs = new ArrayList<>();
* BatchDocumentOutputConfig outputConfig = BatchDocumentOutputConfig.newBuilder().build();
* BatchTranslateDocumentResponse response =
* translationServiceClient
* .batchTranslateDocumentAsync(
* parent, sourceLanguageCode, targetLanguageCodes, inputConfigs, outputConfig)
* .get();
* }
* }</pre>
*
* @param parent Required. Location to make a regional call.
* <p>Format: `projects/{project-number-or-id}/locations/{location-id}`.
* <p>The `global` location is not supported for batch translation.
* <p>Only AutoML Translation models or glossaries within the same region (have the same
* location-id) can be used, otherwise an INVALID_ARGUMENT (400) error is returned.
* @param sourceLanguageCode Required. The BCP-47 language code of the input document if known,
* for example, "en-US" or "sr-Latn". Supported language codes are listed in Language Support
* (https://cloud.google.com/translate/docs/languages).
* @param targetLanguageCodes Required. The BCP-47 language code to use for translation of the
* input document. Specify up to 10 language codes here.
* @param inputConfigs Required. Input configurations. The total number of files matched should be
* &lt;= 100. The total content size to translate should be &lt;= 100M Unicode codepoints. The
* files must use UTF-8 encoding.
* @param outputConfig Required. Output configuration. If 2 input configs match to the same file
* (that is, same input path), we don't generate output for duplicate inputs.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture<BatchTranslateDocumentResponse, BatchTranslateDocumentMetadata>
batchTranslateDocumentAsync(
String parent,
String sourceLanguageCode,
List<String> targetLanguageCodes,
List<BatchDocumentInputConfig> inputConfigs,
BatchDocumentOutputConfig outputConfig) {
BatchTranslateDocumentRequest request =
BatchTranslateDocumentRequest.newBuilder()
.setParent(parent)
.setSourceLanguageCode(sourceLanguageCode)
.addAllTargetLanguageCodes(targetLanguageCodes)
.addAllInputConfigs(inputConfigs)
.setOutputConfig(outputConfig)
.build();
return batchTranslateDocumentAsync(request);
}

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Translates a large volume of document in asynchronous batch mode. This function provides
Expand Down
2 changes: 1 addition & 1 deletion google-cloud-translate/src/main/java/com/google/cloud/translate/v3/gapic_metadata.json
View file
Open in desktop
Expand Up @@ -11,7 +11,7 @@
"libraryClient": "TranslationServiceClient",
"rpcs": {
"BatchTranslateDocument": {
"methods": ["batchTranslateDocumentAsync", "batchTranslateDocumentOperationCallable", "batchTranslateDocumentCallable"]
"methods": ["batchTranslateDocumentAsync", "batchTranslateDocumentAsync", "batchTranslateDocumentAsync", "batchTranslateDocumentOperationCallable", "batchTranslateDocumentCallable"]
},
"BatchTranslateText": {
"methods": ["batchTranslateTextAsync", "batchTranslateTextOperationCallable", "batchTranslateTextCallable"]
Expand Down
124 changes: 124 additions & 0 deletions ...-translate/src/main/java/com/google/cloud/translate/v3beta1/TranslationServiceClient.java
View file
Open in desktop
Expand Up @@ -692,6 +692,130 @@ public final UnaryCallable<BatchTranslateTextRequest, Operation> batchTranslateT
return stub.batchTranslateTextCallable();
}

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Translates a large volume of documents 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()) {
* LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
* String sourceLanguageCode = "sourceLanguageCode1645917472";
* List<String> targetLanguageCodes = new ArrayList<>();
* List<BatchDocumentInputConfig> inputConfigs = new ArrayList<>();
* BatchDocumentOutputConfig outputConfig = BatchDocumentOutputConfig.newBuilder().build();
* BatchTranslateDocumentResponse response =
* translationServiceClient
* .batchTranslateDocumentAsync(
* parent, sourceLanguageCode, targetLanguageCodes, inputConfigs, outputConfig)
* .get();
* }
* }</pre>
*
* @param parent Required. Location to make a regional call.
* <p>Format: `projects/{project-number-or-id}/locations/{location-id}`.
* <p>The `global` location is not supported for batch translation.
* <p>Only AutoML Translation models or glossaries within the same region (have the same
* location-id) can be used, otherwise an INVALID_ARGUMENT (400) error is returned.
* @param sourceLanguageCode Required. The BCP-47 language code of the input document if known,
* for example, "en-US" or "sr-Latn". Supported language codes are listed in Language Support
* (https://cloud.google.com/translate/docs/languages).
* @param targetLanguageCodes Required. The BCP-47 language code to use for translation of the
* input document. Specify up to 10 language codes here.
* @param inputConfigs Required. Input configurations. The total number of files matched should be
* &lt;= 100. The total content size to translate should be &lt;= 100M Unicode codepoints. The
* files must use UTF-8 encoding.
* @param outputConfig Required. Output configuration. If 2 input configs match to the same file
* (that is, same input path), we don't generate output for duplicate inputs.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture<BatchTranslateDocumentResponse, BatchTranslateDocumentMetadata>
batchTranslateDocumentAsync(
LocationName parent,
String sourceLanguageCode,
List<String> targetLanguageCodes,
List<BatchDocumentInputConfig> inputConfigs,
BatchDocumentOutputConfig outputConfig) {
BatchTranslateDocumentRequest request =
BatchTranslateDocumentRequest.newBuilder()
.setParent(parent == null ? null : parent.toString())
.setSourceLanguageCode(sourceLanguageCode)
.addAllTargetLanguageCodes(targetLanguageCodes)
.addAllInputConfigs(inputConfigs)
.setOutputConfig(outputConfig)
.build();
return batchTranslateDocumentAsync(request);
}

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Translates a large volume of documents 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()) {
* String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
* String sourceLanguageCode = "sourceLanguageCode1645917472";
* List<String> targetLanguageCodes = new ArrayList<>();
* List<BatchDocumentInputConfig> inputConfigs = new ArrayList<>();
* BatchDocumentOutputConfig outputConfig = BatchDocumentOutputConfig.newBuilder().build();
* BatchTranslateDocumentResponse response =
* translationServiceClient
* .batchTranslateDocumentAsync(
* parent, sourceLanguageCode, targetLanguageCodes, inputConfigs, outputConfig)
* .get();
* }
* }</pre>
*
* @param parent Required. Location to make a regional call.
* <p>Format: `projects/{project-number-or-id}/locations/{location-id}`.
* <p>The `global` location is not supported for batch translation.
* <p>Only AutoML Translation models or glossaries within the same region (have the same
* location-id) can be used, otherwise an INVALID_ARGUMENT (400) error is returned.
* @param sourceLanguageCode Required. The BCP-47 language code of the input document if known,
* for example, "en-US" or "sr-Latn". Supported language codes are listed in Language Support
* (https://cloud.google.com/translate/docs/languages).
* @param targetLanguageCodes Required. The BCP-47 language code to use for translation of the
* input document. Specify up to 10 language codes here.
* @param inputConfigs Required. Input configurations. The total number of files matched should be
* &lt;= 100. The total content size to translate should be &lt;= 100M Unicode codepoints. The
* files must use UTF-8 encoding.
* @param outputConfig Required. Output configuration. If 2 input configs match to the same file
* (that is, same input path), we don't generate output for duplicate inputs.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture<BatchTranslateDocumentResponse, BatchTranslateDocumentMetadata>
batchTranslateDocumentAsync(
String parent,
String sourceLanguageCode,
List<String> targetLanguageCodes,
List<BatchDocumentInputConfig> inputConfigs,
BatchDocumentOutputConfig outputConfig) {
BatchTranslateDocumentRequest request =
BatchTranslateDocumentRequest.newBuilder()
.setParent(parent)
.setSourceLanguageCode(sourceLanguageCode)
.addAllTargetLanguageCodes(targetLanguageCodes)
.addAllInputConfigs(inputConfigs)
.setOutputConfig(outputConfig)
.build();
return batchTranslateDocumentAsync(request);
}

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Translates a large volume of documents in asynchronous batch mode. This function provides
Expand Down
2 changes: 1 addition & 1 deletion google-cloud-translate/src/main/java/com/google/cloud/translate/v3beta1/gapic_metadata.json
View file
Open in desktop
Expand Up @@ -11,7 +11,7 @@
"libraryClient": "TranslationServiceClient",
"rpcs": {
"BatchTranslateDocument": {
"methods": ["batchTranslateDocumentAsync", "batchTranslateDocumentOperationCallable", "batchTranslateDocumentCallable"]
"methods": ["batchTranslateDocumentAsync", "batchTranslateDocumentAsync", "batchTranslateDocumentAsync", "batchTranslateDocumentOperationCallable", "batchTranslateDocumentCallable"]
},
"BatchTranslateText": {
"methods": ["batchTranslateTextAsync", "batchTranslateTextOperationCallable", "batchTranslateTextCallable"]
Expand Down