Package google.cloud.translation.v3

중요: 괄호 안에 나열된 URL에 액세스하려면 인터넷에 연결해야 합니다. URL은 오프라인 환경 외부에서 액세스할 수 있도록 제공됩니다.

TranslationService

자연어 번역 작업을 제공합니다.

DetectLanguage

rpc DetectLanguage(DetectLanguageRequest) returns (DetectLanguageResponse)

요청에 포함된 텍스트의 언어를 감지합니다.

GetSupportedLanguages

rpc GetSupportedLanguages(GetSupportedLanguagesRequest) returns (SupportedLanguages)

번역이 지원되는 언어 목록을 반환합니다.

TranslateText

rpc TranslateText(TranslateTextRequest) returns (TranslateTextResponse)

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

DetectLanguageRequest

언어 감지에 대한 요청 메시지입니다.

필드
parent

string

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

형식: projects/{project-id}.

mime_type

string

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

content

string

문자열로 저장된 입력의 콘텐츠입니다.

DetectLanguageResponse

언어 감지에 대한 응답 메시지입니다.

필드
languages[]

DetectedLanguage

Translation API에서 감지한 가장 가능성이 높은 언어입니다. 각 요청에 대해 Translation API는 항상 하나의 결과만 반환합니다.

DetectedLanguage

언어 감지에 대한 응답 메시지입니다.

필드
language_code

string

요청에 포함된 원본 콘텐츠에서 자동으로 감지된 BCP-47 언어 코드입니다.

confidence

float

이 언어에 대한 감지 결과의 신뢰도입니다.

S3Source

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

필드
input_uri

string

필수 항목입니다. 소스 데이터 URI입니다. 예를 들면 s3://my_bucket/my_object입니다.

GetSupportedLanguagesRequest

지원 언어 검색에 대한 요청 메시지입니다.

필드
parent

string

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

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

display_language_code

string

(선택사항) 지원되는 언어의 현지화된 사람이 읽을 수 있는 이름을 반환하는 데 사용할 언어입니다. 누락된 경우 표시 이름이 응답에 반환되지 않습니다.

SupportedLanguage

지원되는 언어 하나와 관련된 정보에 해당하는 단일 지원 언어 응답입니다.

필드
language_code

string

지원되는 언어 코드입니다. 일반적으로 ISO 639-1 식별자(예: 'en', 'ja')로 구성됩니다. 언어 및 지역 식별자를 포함한 BCP-47 코드가 반환되는 경우도 있습니다 (예: 'zh-TW', 'zh-CN').

display_name

string

요청에 지정된 표시 언어로 현지화된 언어의 사람이 읽을 수 있는 이름입니다.

support_source

bool

소스 언어로 사용할 수 있습니다.

support_target

bool

대상 언어로 사용할 수 있습니다.

SupportedLanguages

지원 언어 검색에 대한 응답 메시지입니다.

필드
languages[]

SupportedLanguage

지원 언어 응답의 목록입니다. 이 목록에는 Translation API에서 지원하는 각 언어의 항목이 포함되어 있습니다.

TranslateTextRequest

동기 번역의 요청 메시지입니다.

필드
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). 지원되는 언어 코드는 언어 지원에 나열되어 있습니다.

target_language_code

string

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

parent

string

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

형식: projects/{project-id}

TranslateTextResponse

필드
translations[]

Translation

텍스트 번역 응답입니다. 이 필드의 길이는 contents와 같습니다.

번역

단일 번역 응답입니다.

필드
translated_text

string

도착어로 번역된 텍스트입니다. 번역 중에 오류가 발생하면 이 필드가 응답에서 제외될 수 있습니다.

detected_language_code

string

소스 언어가 전달된 경우 언어 자동 감지가 발생하지 않으며 이 필드는 비어 있습니다.