비동기 일괄 모드에서 대량의 문서를 번역합니다. 이 함수는 입력이 처리되는 동안 실시간 출력을 제공합니다. 호출자가 요청을 취소하면 부분 결과 (입력 파일의 경우 전체 또는 없음)가 지정된 출력 위치에서 계속 제공될 수 있습니다.
이 호출은 즉시 반환되며 google.longrunning.Operation.name을 사용하여 호출 상태를 폴링할 수 있습니다.
HTTP 요청
POST https://{TRANSLATION_GDC_ENDPOINT}/v3/{parent}:batchTranslateDocument
경로 매개변수
매개변수 | |
---|---|
parent |
필수 항목입니다. 전화를 걸 위치입니다. 형식은
동일한 리전 (동일한 location-id 보유) 내의 용어집만 사용할 수 있습니다. 그렇지 않으면 INVALID_ARGUMENT (400) 오류가 반환됩니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "sourceLanguageCode": string, "targetLanguageCodes": [ string ], "inputConfigs": [ { object ( |
필드 | |
---|---|
sourceLanguageCode |
필수 항목입니다. 입력 문서의 ISO-639 언어 코드입니다(예: 'en-US' 또는 'sr-Latn'). 지원되는 언어 코드는 지원되는 언어에 나열되어 있습니다. |
targetLanguageCodes[] |
필수 항목입니다. 입력 문서의 번역에 사용할 ISO-639 언어 코드입니다. 여기에 최대 10개의 언어 코드를 지정하세요. |
inputConfigs[] |
필수 항목입니다. 입력 구성입니다. 일치하는 파일의 총수는 100개 이하여야 합니다. 번역할 총 콘텐츠 크기는 100M 유니코드 코드포인트 이하여야 합니다. 파일은 UTF-8 인코딩을 사용해야 합니다. |
outputConfig |
필수 항목입니다. 출력 구성입니다. 2개의 입력 구성이 동일한 파일 (즉, 동일한 입력 경로)과 일치하는 경우 중복 입력에 대한 출력이 생성되지 않습니다. |
glossaries |
(선택사항) 적용할 용어집입니다. 타겟 언어 코드로 키가 지정됩니다. |
formatConversions |
(선택사항) 모든 입력 파일에 적용되는 파일 형식 변환 맵입니다. 맵 키는 원래 mimeType입니다. 맵 값은 번역된 문서의 타겟 mimeType입니다. 지원되는 파일 형식 변환에는 다음이 포함됩니다. - 지정하지 않으면 출력 파일이 원본 파일과 동일한 형식으로 저장됩니다. |
customizedAttribution |
(선택사항) 이 플래그는 사용자가 맞춤설정한 기여 분석을 지원하기 위한 것입니다. 제공하지 않은 경우 기본값은 |
enableShadowRemovalNativePdf |
(선택사항) true인 경우 텍스트 삭제 서버를 사용하여 네이티브 PDF 번역을 위한 배경 이미지의 그림자 텍스트를 삭제합니다. 그림자 제거 기능은 |
enableRotationCorrection |
(선택사항) true인 경우 DVS에서 자동 회전 보정을 사용 설정합니다. |
응답 본문
성공한 경우 응답 본문에 Operation
의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/cloud-platform
BatchDocumentInputConfig
locations.batchTranslateDocument 요청의 입력 구성입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 source . 입력을 지정합니다. source 은 다음 중 하나여야 합니다. |
|
s3_source |
소스 입력의 S3 버킷 위치입니다. 단일 파일 또는 와일드 카드일 수 있습니다. 파일 MIME 유형은 확장자를 기반으로 결정됩니다. 지원되는 MIME 유형은 다음과 같습니다.
|
BatchDocumentOutputConfig
locations.batchTranslateDocument 요청의 출력 구성입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 destination . 출력 대상입니다. 제공된 대상 디렉터리가 있어야 하며 비어 있어야 합니다. destination 은 다음 중 하나여야 합니다. |
|
s3_destination |
출력 콘텐츠의 S3 버킷 대상입니다. 단일 입력 문서마다 최대 2 * n개의 출력 파일이 생성됩니다. (n은
|