Method: projects.locations.translateDocument

동기 모드로 문서를 번역합니다.

HTTP 요청

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 리전 호출을 수행할 위치입니다.

형식은 projects/{project-number-or-id}/locations/{location-id}입니다.

전역 호출의 경우 projects/{project-number-or-id}/locations/global 또는 projects/{project-number-or-id}을 사용합니다.

AutoML 모델 또는 맞춤 용어집을 사용하는 요청에는 전역이 아닌 위치가 필요합니다.

모델과 용어집은 동일한 리전 (동일한 location-id)에 있어야 합니다. 그렇지 않으면 INVALID_ARGUMENT (400) 오류가 반환됩니다.

요청 본문

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

JSON 표현 
{
  "sourceLanguageCode": string,
  "targetLanguageCode": string,
  "documentInputConfig": {
    object (DocumentInputConfig)
  },
  "glossaryConfig": {
    object (TranslateTextGlossaryConfig)
  }
}
필드
sourceLanguageCode

string

(선택사항) 입력 문서의 ISO-639 언어 코드입니다(예: 'en-US' 또는 'sr-Latn'). 지원되는 언어 코드는 언어 지원에 나열되어 있습니다. 소스 언어가 지정되지 않으면 API에서 소스 언어를 자동으로 식별하려고 시도하고 응답 내에 소스 언어를 반환합니다. 요청에 용어집이나 맞춤 모델이 포함된 경우 출발어를 지정해야 합니다.
targetLanguageCode

string

필수 항목입니다. 입력 문서의 번역에 사용할 ISO-639 언어 코드입니다. 언어 지원에 나열된 언어 코드 중 하나로 설정됩니다.
documentInputConfig

object (DocumentInputConfig)

필수 항목입니다. 입력 구성입니다.
glossaryConfig

object (TranslateTextGlossaryConfig)

(선택사항) 적용할 용어집입니다. 용어집은 모델과 동일한 리전 (동일한 location-id) 내에 있어야 합니다. 그렇지 않으면 INVALID_ARGUMENT (400) 오류가 반환됩니다.

승인을 처리하려면 지정된 리소스 glossaryConfig에 대해 다음과 같은 IAM 권한이 필요합니다.

  • cloudtranslate.glossaries.docPredict

응답 본문

번역된 문서 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "documentTranslation": {
    object (DocumentTranslation)
  },
  "glossaryDocumentTranslation": {
    object (DocumentTranslation)
  },
  "glossaryConfig": {
    object (TranslateTextGlossaryConfig)
  }
}
필드
documentTranslation

object (DocumentTranslation)

번역된 문서입니다.
glossaryDocumentTranslation

object (DocumentTranslation)

요청에 용어가 제공된 경우 문서의 번역 출력입니다. 용어집 용어가 적용되지 않는 경우 [TranslateDocumentResponse.document_translation] 과 동일할 수 있습니다.
glossaryConfig

object (TranslateTextGlossaryConfig)

이 번역에 사용된 glossaryConfig입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

DocumentInputConfig

문서 번역 요청 입력 구성입니다.

JSON 표현 
{
  "mimeType": string,
  "content": string,
  "S3Source": {
    object (S3Source)
  }
}
필드
mimeType

string

입력 문서의 mimeType을 지정합니다.

지정하지 않으면 S3Source에서 제공된 파일의 파일 확장자를 사용하여 결정됩니다. 바이트 콘텐츠를 통해 제공된 파일의 경우 mimeType을 제공해야 합니다.

현재 지원되는 MIME 유형은 다음과 같습니다.

  • application/pdf
  • application/msword
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.ms-powerpoint
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.ms-excel
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

지원되는 파일 형식:

  • PDF
  • DOC
  • DOCX
  • PPT
  • PPTX
  • XLS
  • XLSX
content

string (bytes format)

바이트 스트림으로 나타낸 문서의 내용입니다.

base64 인코딩 문자열입니다.
S3Source

object (S3Source)

입력 콘텐츠의 스토리지 위치입니다.

DocumentTranslation

번역된 문서 메시지입니다.

JSON 표현 
{
  "byteStreamOutputs": [
    string
  ],
  "mimeType": string,
  "detectedLanguageCode": string
}
필드
byteStreamOutputs[]

string (bytes format)

번역된 문서의 배열입니다. 현재는 크기가 1일 것으로 예상됩니다. 향후 다른 유형의 파일 형식에 대해 여러 번역된 문서가 생성될 수 있습니다.

base64 인코딩 문자열입니다.
mimeType

string

번역된 문서의 MIME 유형입니다.
detectedLanguageCode

string

입력 문서에 대해 감지된 언어입니다. 사용자가 입력 문서의 출발어를 제공하지 않은 경우 이 필드에는 자동으로 감지된 언어 코드가 표시됩니다. 소스 언어가 전달된 경우 언어 자동 감지가 발생하지 않으며 이 필드는 비어 있습니다.