Method: projects.translateText

입력 텍스트를 번역하고 번역된 텍스트를 반환합니다.

HTTP 요청

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 전화를 걸 프로젝트입니다. 호출자의 프로젝트를 참조해야 합니다.

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

요청 본문

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

JSON 표현
{
  "contents": [
    string
  ],
  "mime_type": string,
  "source_language_code": string,
  "target_language_code": string,
  "glossary_config": {
    object TranslateTextGlossaryConfig)
  },
    string: string,
    ...
  }
}
필드
contents[]

string

필수 항목입니다. 문자열 형식의 입력 콘텐츠입니다. 총 콘텐츠는 30,000개 미만의 코드 포인트가 권장됩니다. 이 필드의 최대 길이는 1024입니다.

mime_type

string

(선택사항) 소스 텍스트의 형식입니다(예: 'text/html', 'text/plain'). 비워 두면 MIME 유형은 기본적으로 'text/html'입니다.

source_language_code

string

(선택사항) 입력 텍스트의 BCP-47 언어 코드입니다(알려진 경우)(예: 'en-US' 또는 'sr-Latn'). 지원되는 언어 코드는 언어 지원에 나열되어 있습니다. 소스 언어가 지정되지 않으면 API에서 소스 언어를 자동으로 식별하려고 시도하고 응답 내에 소스 언어를 반환합니다.

target_language_code

string

필수 항목입니다. 입력 텍스트의 번역에 사용할 BCP-47 언어 코드입니다. 언어 지원에 나열된 언어 코드 중 하나로 설정됩니다.

glossary_config

object (TranslateTextGlossaryConfig)

(선택사항) 적용할 용어집입니다.

  • cloudtranslate.glossaries.predict

응답 본문

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