Method: projects.locations.batchTranslateDocument

비동기 일괄 모드에서 대량의 문서를 번역합니다. 이 함수는 입력이 처리되는 동안 실시간 출력을 제공합니다. 호출자가 요청을 취소하면 부분 결과 (입력 파일의 경우 전체 또는 없음)가 지정된 출력 위치에서 계속 제공될 수 있습니다.

이 호출은 즉시 반환되며 google.longrunning.Operation.name을 사용하여 호출 상태를 폴링할 수 있습니다.

HTTP 요청

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 전화를 걸 위치입니다.

형식은 projects/{project-id}입니다.

global 위치는 일괄 번역에 지원되지 않습니다.

동일한 리전 (동일한 location-id 보유) 내의 용어집만 사용할 수 있습니다. 그렇지 않으면 INVALID_ARGUMENT (400) 오류가 반환됩니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "sourceLanguageCode": string,
  "targetLanguageCodes": [
    string
  ],
  "inputConfigs": [
    {
      object (BatchDocumentInputConfig)
    }
  ],
  "outputConfig": {
    object (BatchDocumentOutputConfig)
  },
  "glossaries": {
    string: {
      object (TranslateTextGlossaryConfig)
    },
    ...
  },
  "formatConversions": {
    string: string,
    ...
  },
  "customizedAttribution": string,
  "enableShadowRemovalNativePdf": boolean,
  "enableRotationCorrection": boolean
}
필드
sourceLanguageCode

string

필수 항목입니다. 입력 문서의 ISO-639 언어 코드입니다(예: 'en-US' 또는 'sr-Latn'). 지원되는 언어 코드는 지원되는 언어에 나열되어 있습니다.

targetLanguageCodes[]

string

필수 항목입니다. 입력 문서의 번역에 사용할 ISO-639 언어 코드입니다. 여기에 최대 10개의 언어 코드를 지정하세요.

inputConfigs[]

object (BatchDocumentInputConfig)

필수 항목입니다. 입력 구성입니다. 일치하는 파일의 총수는 100개 이하여야 합니다. 번역할 총 콘텐츠 크기는 100M 유니코드 코드포인트 이하여야 합니다. 파일은 UTF-8 인코딩을 사용해야 합니다.

outputConfig

object (BatchDocumentOutputConfig)

필수 항목입니다. 출력 구성입니다. 2개의 입력 구성이 동일한 파일 (즉, 동일한 입력 경로)과 일치하는 경우 중복 입력에 대한 출력이 생성되지 않습니다.

glossaries

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

(선택사항) 적용할 용어집입니다. 타겟 언어 코드로 키가 지정됩니다.

formatConversions

map (key: string, value: string)

(선택사항) 모든 입력 파일에 적용되는 파일 형식 변환 맵입니다. 맵 키는 원래 mimeType입니다. 맵 값은 번역된 문서의 타겟 mimeType입니다.

지원되는 파일 형식 변환에는 다음이 포함됩니다. - application/pdf에서 application/vnd.openxmlformats-officedocument.wordprocessingml.document

지정하지 않으면 출력 파일이 원본 파일과 동일한 형식으로 저장됩니다.

customizedAttribution

string

(선택사항) 이 플래그는 사용자가 맞춤설정한 기여 분석을 지원하기 위한 것입니다. 제공하지 않은 경우 기본값은 Machine Translated by Google입니다. 맞춤 저작자 표시는 https://cloud.google.com/translate/attribution#attribution_and_logos의 규칙을 따라야 합니다.

enableShadowRemovalNativePdf

boolean

(선택사항) true인 경우 텍스트 삭제 서버를 사용하여 네이티브 PDF 번역을 위한 배경 이미지의 그림자 텍스트를 삭제합니다. 그림자 제거 기능은 isTranslateNativePdfOnly: false && pdfNativeOnly: false

enableRotationCorrection

boolean

(선택사항) true인 경우 DVS에서 자동 회전 보정을 사용 설정합니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

BatchDocumentInputConfig

locations.batchTranslateDocument 요청의 입력 구성입니다.

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.
}
필드
통합 필드 source. 입력을 지정합니다. source은 다음 중 하나여야 합니다.
s3_source

object (s3Source)

소스 입력의 S3 버킷 위치입니다. 단일 파일 또는 와일드 카드일 수 있습니다.

파일 MIME 유형은 확장자를 기반으로 결정됩니다. 지원되는 MIME 유형은 다음과 같습니다.

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

.docx, .pptx, .xlsx에서 지원하는 최대 파일 크기는 100MB입니다. .pdf에서 지원하는 최대 파일 크기는 1GB이고 최대 페이지 제한은 1,000페이지입니다. 모든 입력 문서에 지원되는 최대 파일 크기는 1GB입니다.

BatchDocumentOutputConfig

locations.batchTranslateDocument 요청의 출력 구성입니다.

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.
}
필드
통합 필드 destination. 출력 대상입니다. 제공된 대상 디렉터리가 있어야 하며 비어 있어야 합니다. destination은 다음 중 하나여야 합니다.
s3_destination

object (s3Destination)

출력 콘텐츠의 S3 버킷 대상입니다. 단일 입력 문서마다 최대 2 * n개의 출력 파일이 생성됩니다. (n은 BatchTranslateDocumentRequest의 대상 언어 코드 수입니다.)

targetLanguageCode이 요청에 제공됩니다.