Method: projects.locations.batchTranslateDocument

Traduz um grande volume de documentos no modo de lote assíncrono. Essa função fornece saída em tempo real à medida que as entradas são processadas. Se o caller cancelar uma solicitação, os resultados parciais (para um arquivo de entrada, é tudo ou nada) ainda poderão estar disponíveis no local de saída especificado.

Essa chamada retorna imediatamente, e você pode usar google.longrunning.Operation.name para pesquisar o status dela.

Solicitação HTTP

POST https://{TRANSLATION_GDC_ENDPOINT}/v3/{parent}:batchTranslateDocument

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. Local para fazer uma chamada.

Formato: projects/{project-id}.

O local global não é compatível com a tradução em lote.

Só é possível usar glossários na mesma região (com o mesmo location-id). Caso contrário, um erro INVALID_ARGUMENT (400) será retornado.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "sourceLanguageCode": string,
  "targetLanguageCodes": [
    string
  ],
  "inputConfigs": [
    {
      object (BatchDocumentInputConfig)
    }
  ],
  "outputConfig": {
    object (BatchDocumentOutputConfig)
  },
  "glossaries": {
    string: {
      object (TranslateTextGlossaryConfig)
    },
    ...
  },
  "formatConversions": {
    string: string,
    ...
  },
  "customizedAttribution": string,
  "enableShadowRemovalNativePdf": boolean,
  "enableRotationCorrection": boolean
}
Campos
sourceLanguageCode

string

Obrigatório. O código de idioma ISO-639 do documento de entrada, se conhecido. Por exemplo, "en-US" ou "sr-Latn". Os códigos de idioma aceitos estão listados em Idiomas aceitos.
targetLanguageCodes[]

string

Obrigatório. O código de idioma ISO-639 a ser usado para tradução do documento de entrada. Especifique até 10 códigos de idioma aqui.
inputConfigs[]

object (BatchDocumentInputConfig)

Obrigatório. Configurações de entrada. O número total de arquivos correspondentes precisa ser menor ou igual a 100. O tamanho total do conteúdo a ser traduzido precisa ter no máximo 100 milhões de pontos de código Unicode. Os arquivos precisam usar a codificação UTF-8.
outputConfig

object (BatchDocumentOutputConfig)

Obrigatório. Configuração de saída. Se duas configurações de entrada corresponderem ao mesmo arquivo (ou seja, mesmo caminho de entrada), não vamos gerar saída para entradas duplicadas.
glossaries

map (key: string, value: object (TranslateTextGlossaryConfig))

Opcional. Glossários a serem aplicados. Ele é identificado pelo código do idioma de destino.
formatConversions

map (key: string, value: string)

Opcional. O mapa de conversão de formato de arquivo aplicado a todos os arquivos de entrada. A chave do mapa é o mimeType original. O valor do mapa é o mimeType de destino dos documentos traduzidos.

A conversão de formato de arquivo compatível inclui: - application/pdf para application/vnd.openxmlformats-officedocument.wordprocessingml.document

Se nada for especificado, os arquivos de saída estarão no mesmo formato do arquivo original.
customizedAttribution

string

Opcional. Essa flag é para oferecer suporte à atribuição personalizada pelo usuário. Caso nenhum valor seja fornecido, o padrão será Machine Translated by Google. A atribuição personalizada precisa seguir as regras em https://cloud.google.com/translate/attribution#attribution_and_logos
enableShadowRemovalNativePdf

boolean

Opcional. Se for verdadeiro, use o servidor de remoção de texto para remover o texto de sombra na imagem de plano de fundo para a tradução nativa de PDF. O recurso de remoção de sombras só pode ser ativado quando isTranslateNativePdfOnly: false && pdfNativeOnly: false
enableRotationCorrection

boolean

Opcional. Se for verdadeiro, ative a correção automática de rotação no DVS.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

BatchDocumentInputConfig

Configuração de entrada para a solicitação "locations.batchTranslateDocument".

Representação JSON 
{

  // Union field source can be only one of the following:
  "s3_source": {
    object (s3Source)
  }
  // End of list of possible types for union field source.
}
Campos
Campo de união source. Especifique a entrada. source pode ser apenas de um dos tipos a seguir:
s3_source

object (s3Source)

Local do bucket do S3 para a entrada de origem. Pode ser um arquivo único ou um caractere curinga.

O tipo MIME do arquivo é determinado com base na extensão. Os tipos MIME aceitos incluem:

  • pdf: application/pdf
  • docx: application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • pptx: application/vnd.openxmlformats-officedocument.presentationml.presentation
  • xlsx: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

O tamanho máximo de arquivo compatível com .docx, .pptx e .xlsx é de 100 MB. O tamanho máximo de arquivo compatível com .pdf é de 1 GB, e o limite máximo de páginas é de 1.000. O tamanho máximo de arquivo para todos os documentos de entrada é de 1 GB.

BatchDocumentOutputConfig

Configuração de saída para a solicitação locations.batchTranslateDocument.

Representação JSON 
{

  // Union field destination can be only one of the following:
  "s3_destination": {
    object (s3Destination)
  }
  // End of list of possible types for union field destination.
}
Campos
Campo de união destination. O destino da saída. O diretório de destino fornecido precisa existir e estar vazio. destination pode ser apenas de um dos tipos a seguir:
s3_destination

object (s3Destination)

Bucket do S3 de destino para o conteúdo de saída. Para cada documento de entrada, geramos no máximo 2 * n arquivos de saída. (n é o número de códigos de idioma de destino em BatchTranslateDocumentRequest).

targetLanguageCode é fornecido na solicitação.