Class DocumentOutputConfig.Builder (2.23.0)

public static final class DocumentOutputConfig.Builder extends GeneratedMessageV3.Builder<DocumentOutputConfig.Builder> implements DocumentOutputConfigOrBuilder

A document translation request output config.

Protobuf type google.cloud.translation.v3.DocumentOutputConfig

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

Methods

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public DocumentOutputConfig.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
DocumentOutputConfig.Builder
Overrides

build()

public DocumentOutputConfig build()
Returns
TypeDescription
DocumentOutputConfig

buildPartial()

public DocumentOutputConfig buildPartial()
Returns
TypeDescription
DocumentOutputConfig

clear()

public DocumentOutputConfig.Builder clear()
Returns
TypeDescription
DocumentOutputConfig.Builder
Overrides

clearDestination()

public DocumentOutputConfig.Builder clearDestination()
Returns
TypeDescription
DocumentOutputConfig.Builder

clearField(Descriptors.FieldDescriptor field)

public DocumentOutputConfig.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
NameDescription
fieldFieldDescriptor
Returns
TypeDescription
DocumentOutputConfig.Builder
Overrides

clearGcsDestination()

public DocumentOutputConfig.Builder clearGcsDestination()

Optional. Google Cloud Storage destination for the translation output, e.g., gs://my_bucket/my_directory/.

The destination directory provided does not have to be empty, but the bucket must exist. If a file with the same name as the output file already exists in the destination an error will be returned.

For a DocumentInputConfig.contents provided document, the output file will have the name "output_[trg]_translations.[ext]", where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

For a DocumentInputConfig.gcs_uri provided document, the output file will have a name according to its URI. For example: an input file with URI: gs://a/b/c.[extension] stored in a gcs_destination bucket with name "my_bucket" will have an output URI: gs://my_bucket/a_b_c_[trg]_translations.[ext], where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

If the document was directly provided through the request, then the output document will have the format: gs://my_bucket/translated_document_[trg]_translations.[ext], where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

    If a glossary was provided, then the output URI for the glossary translation will be equal to the default output URI but have glossary_translations instead of translations. For the previous example, its glossary URI would be: gs://my_bucket/a_b_c_[trg]_glossary_translations.[ext].

    Thus the max number of output files will be 2 (Translated document, Glossary translated document).

    Callers should expect no partial outputs. If there is any error during document translation, no output will be stored in the Cloud Storage bucket.

.google.cloud.translation.v3.GcsDestination gcs_destination = 1 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
DocumentOutputConfig.Builder

clearMimeType()

public DocumentOutputConfig.Builder clearMimeType()

Optional. Specifies the translated document's mime_type. If not specified, the translated file's mime type will be the same as the input file's mime type. Currently only support the output mime type to be the same as input mime type.

  • application/pdf
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

string mime_type = 3 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
DocumentOutputConfig.Builder

This builder for chaining.

clearOneof(Descriptors.OneofDescriptor oneof)

public DocumentOutputConfig.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
NameDescription
oneofOneofDescriptor
Returns
TypeDescription
DocumentOutputConfig.Builder
Overrides

clone()

public DocumentOutputConfig.Builder clone()
Returns
TypeDescription
DocumentOutputConfig.Builder
Overrides

getDefaultInstanceForType()

public DocumentOutputConfig getDefaultInstanceForType()
Returns
TypeDescription
DocumentOutputConfig

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
TypeDescription
Descriptor
Overrides

getDestinationCase()

public DocumentOutputConfig.DestinationCase getDestinationCase()
Returns
TypeDescription
DocumentOutputConfig.DestinationCase

getGcsDestination()

public GcsDestination getGcsDestination()

Optional. Google Cloud Storage destination for the translation output, e.g., gs://my_bucket/my_directory/.

The destination directory provided does not have to be empty, but the bucket must exist. If a file with the same name as the output file already exists in the destination an error will be returned.

For a DocumentInputConfig.contents provided document, the output file will have the name "output_[trg]_translations.[ext]", where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

For a DocumentInputConfig.gcs_uri provided document, the output file will have a name according to its URI. For example: an input file with URI: gs://a/b/c.[extension] stored in a gcs_destination bucket with name "my_bucket" will have an output URI: gs://my_bucket/a_b_c_[trg]_translations.[ext], where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

If the document was directly provided through the request, then the output document will have the format: gs://my_bucket/translated_document_[trg]_translations.[ext], where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

    If a glossary was provided, then the output URI for the glossary translation will be equal to the default output URI but have glossary_translations instead of translations. For the previous example, its glossary URI would be: gs://my_bucket/a_b_c_[trg]_glossary_translations.[ext].

    Thus the max number of output files will be 2 (Translated document, Glossary translated document).

    Callers should expect no partial outputs. If there is any error during document translation, no output will be stored in the Cloud Storage bucket.

.google.cloud.translation.v3.GcsDestination gcs_destination = 1 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
GcsDestination

The gcsDestination.

getGcsDestinationBuilder()

public GcsDestination.Builder getGcsDestinationBuilder()

Optional. Google Cloud Storage destination for the translation output, e.g., gs://my_bucket/my_directory/.

The destination directory provided does not have to be empty, but the bucket must exist. If a file with the same name as the output file already exists in the destination an error will be returned.

For a DocumentInputConfig.contents provided document, the output file will have the name "output_[trg]_translations.[ext]", where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

For a DocumentInputConfig.gcs_uri provided document, the output file will have a name according to its URI. For example: an input file with URI: gs://a/b/c.[extension] stored in a gcs_destination bucket with name "my_bucket" will have an output URI: gs://my_bucket/a_b_c_[trg]_translations.[ext], where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

If the document was directly provided through the request, then the output document will have the format: gs://my_bucket/translated_document_[trg]_translations.[ext], where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

    If a glossary was provided, then the output URI for the glossary translation will be equal to the default output URI but have glossary_translations instead of translations. For the previous example, its glossary URI would be: gs://my_bucket/a_b_c_[trg]_glossary_translations.[ext].

    Thus the max number of output files will be 2 (Translated document, Glossary translated document).

    Callers should expect no partial outputs. If there is any error during document translation, no output will be stored in the Cloud Storage bucket.

.google.cloud.translation.v3.GcsDestination gcs_destination = 1 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
GcsDestination.Builder

getGcsDestinationOrBuilder()

public GcsDestinationOrBuilder getGcsDestinationOrBuilder()

Optional. Google Cloud Storage destination for the translation output, e.g., gs://my_bucket/my_directory/.

The destination directory provided does not have to be empty, but the bucket must exist. If a file with the same name as the output file already exists in the destination an error will be returned.

For a DocumentInputConfig.contents provided document, the output file will have the name "output_[trg]_translations.[ext]", where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

For a DocumentInputConfig.gcs_uri provided document, the output file will have a name according to its URI. For example: an input file with URI: gs://a/b/c.[extension] stored in a gcs_destination bucket with name "my_bucket" will have an output URI: gs://my_bucket/a_b_c_[trg]_translations.[ext], where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

If the document was directly provided through the request, then the output document will have the format: gs://my_bucket/translated_document_[trg]_translations.[ext], where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

    If a glossary was provided, then the output URI for the glossary translation will be equal to the default output URI but have glossary_translations instead of translations. For the previous example, its glossary URI would be: gs://my_bucket/a_b_c_[trg]_glossary_translations.[ext].

    Thus the max number of output files will be 2 (Translated document, Glossary translated document).

    Callers should expect no partial outputs. If there is any error during document translation, no output will be stored in the Cloud Storage bucket.

.google.cloud.translation.v3.GcsDestination gcs_destination = 1 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
GcsDestinationOrBuilder

getMimeType()

public String getMimeType()

Optional. Specifies the translated document's mime_type. If not specified, the translated file's mime type will be the same as the input file's mime type. Currently only support the output mime type to be the same as input mime type.

  • application/pdf
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

string mime_type = 3 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
String

The mimeType.

getMimeTypeBytes()

public ByteString getMimeTypeBytes()

Optional. Specifies the translated document's mime_type. If not specified, the translated file's mime type will be the same as the input file's mime type. Currently only support the output mime type to be the same as input mime type.

  • application/pdf
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

string mime_type = 3 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
ByteString

The bytes for mimeType.

hasGcsDestination()

public boolean hasGcsDestination()

Optional. Google Cloud Storage destination for the translation output, e.g., gs://my_bucket/my_directory/.

The destination directory provided does not have to be empty, but the bucket must exist. If a file with the same name as the output file already exists in the destination an error will be returned.

For a DocumentInputConfig.contents provided document, the output file will have the name "output_[trg]_translations.[ext]", where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

For a DocumentInputConfig.gcs_uri provided document, the output file will have a name according to its URI. For example: an input file with URI: gs://a/b/c.[extension] stored in a gcs_destination bucket with name "my_bucket" will have an output URI: gs://my_bucket/a_b_c_[trg]_translations.[ext], where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

If the document was directly provided through the request, then the output document will have the format: gs://my_bucket/translated_document_[trg]_translations.[ext], where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

    If a glossary was provided, then the output URI for the glossary translation will be equal to the default output URI but have glossary_translations instead of translations. For the previous example, its glossary URI would be: gs://my_bucket/a_b_c_[trg]_glossary_translations.[ext].

    Thus the max number of output files will be 2 (Translated document, Glossary translated document).

    Callers should expect no partial outputs. If there is any error during document translation, no output will be stored in the Cloud Storage bucket.

.google.cloud.translation.v3.GcsDestination gcs_destination = 1 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
boolean

Whether the gcsDestination field is set.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

mergeFrom(DocumentOutputConfig other)

public DocumentOutputConfig.Builder mergeFrom(DocumentOutputConfig other)
Parameter
NameDescription
otherDocumentOutputConfig
Returns
TypeDescription
DocumentOutputConfig.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public DocumentOutputConfig.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
DocumentOutputConfig.Builder
Overrides
Exceptions
TypeDescription
IOException

mergeFrom(Message other)

public DocumentOutputConfig.Builder mergeFrom(Message other)
Parameter
NameDescription
otherMessage
Returns
TypeDescription
DocumentOutputConfig.Builder
Overrides

mergeGcsDestination(GcsDestination value)

public DocumentOutputConfig.Builder mergeGcsDestination(GcsDestination value)

Optional. Google Cloud Storage destination for the translation output, e.g., gs://my_bucket/my_directory/.

The destination directory provided does not have to be empty, but the bucket must exist. If a file with the same name as the output file already exists in the destination an error will be returned.

For a DocumentInputConfig.contents provided document, the output file will have the name "output_[trg]_translations.[ext]", where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

For a DocumentInputConfig.gcs_uri provided document, the output file will have a name according to its URI. For example: an input file with URI: gs://a/b/c.[extension] stored in a gcs_destination bucket with name "my_bucket" will have an output URI: gs://my_bucket/a_b_c_[trg]_translations.[ext], where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

If the document was directly provided through the request, then the output document will have the format: gs://my_bucket/translated_document_[trg]_translations.[ext], where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

    If a glossary was provided, then the output URI for the glossary translation will be equal to the default output URI but have glossary_translations instead of translations. For the previous example, its glossary URI would be: gs://my_bucket/a_b_c_[trg]_glossary_translations.[ext].

    Thus the max number of output files will be 2 (Translated document, Glossary translated document).

    Callers should expect no partial outputs. If there is any error during document translation, no output will be stored in the Cloud Storage bucket.

.google.cloud.translation.v3.GcsDestination gcs_destination = 1 [(.google.api.field_behavior) = OPTIONAL];

Parameter
NameDescription
valueGcsDestination
Returns
TypeDescription
DocumentOutputConfig.Builder

mergeUnknownFields(UnknownFieldSet unknownFields)

public final DocumentOutputConfig.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
DocumentOutputConfig.Builder
Overrides

setField(Descriptors.FieldDescriptor field, Object value)

public DocumentOutputConfig.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
DocumentOutputConfig.Builder
Overrides

setGcsDestination(GcsDestination value)

public DocumentOutputConfig.Builder setGcsDestination(GcsDestination value)

Optional. Google Cloud Storage destination for the translation output, e.g., gs://my_bucket/my_directory/.

The destination directory provided does not have to be empty, but the bucket must exist. If a file with the same name as the output file already exists in the destination an error will be returned.

For a DocumentInputConfig.contents provided document, the output file will have the name "output_[trg]_translations.[ext]", where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

For a DocumentInputConfig.gcs_uri provided document, the output file will have a name according to its URI. For example: an input file with URI: gs://a/b/c.[extension] stored in a gcs_destination bucket with name "my_bucket" will have an output URI: gs://my_bucket/a_b_c_[trg]_translations.[ext], where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

If the document was directly provided through the request, then the output document will have the format: gs://my_bucket/translated_document_[trg]_translations.[ext], where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

    If a glossary was provided, then the output URI for the glossary translation will be equal to the default output URI but have glossary_translations instead of translations. For the previous example, its glossary URI would be: gs://my_bucket/a_b_c_[trg]_glossary_translations.[ext].

    Thus the max number of output files will be 2 (Translated document, Glossary translated document).

    Callers should expect no partial outputs. If there is any error during document translation, no output will be stored in the Cloud Storage bucket.

.google.cloud.translation.v3.GcsDestination gcs_destination = 1 [(.google.api.field_behavior) = OPTIONAL];

Parameter
NameDescription
valueGcsDestination
Returns
TypeDescription
DocumentOutputConfig.Builder

setGcsDestination(GcsDestination.Builder builderForValue)

public DocumentOutputConfig.Builder setGcsDestination(GcsDestination.Builder builderForValue)

Optional. Google Cloud Storage destination for the translation output, e.g., gs://my_bucket/my_directory/.

The destination directory provided does not have to be empty, but the bucket must exist. If a file with the same name as the output file already exists in the destination an error will be returned.

For a DocumentInputConfig.contents provided document, the output file will have the name "output_[trg]_translations.[ext]", where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

For a DocumentInputConfig.gcs_uri provided document, the output file will have a name according to its URI. For example: an input file with URI: gs://a/b/c.[extension] stored in a gcs_destination bucket with name "my_bucket" will have an output URI: gs://my_bucket/a_b_c_[trg]_translations.[ext], where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

If the document was directly provided through the request, then the output document will have the format: gs://my_bucket/translated_document_[trg]_translations.[ext], where

  • [trg] corresponds to the translated file's language code,
  • [ext] corresponds to the translated file's extension according to its mime type.

    If a glossary was provided, then the output URI for the glossary translation will be equal to the default output URI but have glossary_translations instead of translations. For the previous example, its glossary URI would be: gs://my_bucket/a_b_c_[trg]_glossary_translations.[ext].

    Thus the max number of output files will be 2 (Translated document, Glossary translated document).

    Callers should expect no partial outputs. If there is any error during document translation, no output will be stored in the Cloud Storage bucket.

.google.cloud.translation.v3.GcsDestination gcs_destination = 1 [(.google.api.field_behavior) = OPTIONAL];

Parameter
NameDescription
builderForValueGcsDestination.Builder
Returns
TypeDescription
DocumentOutputConfig.Builder

setMimeType(String value)

public DocumentOutputConfig.Builder setMimeType(String value)

Optional. Specifies the translated document's mime_type. If not specified, the translated file's mime type will be the same as the input file's mime type. Currently only support the output mime type to be the same as input mime type.

  • application/pdf
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

string mime_type = 3 [(.google.api.field_behavior) = OPTIONAL];

Parameter
NameDescription
valueString

The mimeType to set.

Returns
TypeDescription
DocumentOutputConfig.Builder

This builder for chaining.

setMimeTypeBytes(ByteString value)

public DocumentOutputConfig.Builder setMimeTypeBytes(ByteString value)

Optional. Specifies the translated document's mime_type. If not specified, the translated file's mime type will be the same as the input file's mime type. Currently only support the output mime type to be the same as input mime type.

  • application/pdf
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

string mime_type = 3 [(.google.api.field_behavior) = OPTIONAL];

Parameter
NameDescription
valueByteString

The bytes for mimeType to set.

Returns
TypeDescription
DocumentOutputConfig.Builder

This builder for chaining.

setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)

public DocumentOutputConfig.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
NameDescription
fieldFieldDescriptor
indexint
valueObject
Returns
TypeDescription
DocumentOutputConfig.Builder
Overrides

setUnknownFields(UnknownFieldSet unknownFields)

public final DocumentOutputConfig.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
DocumentOutputConfig.Builder
Overrides