텍스트를 로마자로 변환

Preview

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

로마자 변환은 라틴어가 아닌 스크립트를 라틴어 스크립트로 변환합니다. 라틴어 스크립트는 출발어의 발음을 기준으로 합니다. 예를 들어 Cloud Translation은 다음 일본어 문자 こんにちは世界를 Kon'nichiwa sekai와 같이 로마자로 변환합니다.

로마자 변환이 가능한 언어를 확인하려면 지원되는 언어를 참조하세요.

시작하기 전에

Cloud Translation API를 사용을 시작하려면 Cloud Translation API가 사용 설정된 프로젝트가 있고 적절한 사용자 인증 정보가 있어야 합니다. 공통 프로그래밍 언어용 클라이언트 라이브러리를 설치하여 API를 호출할 수도 있습니다. 자세한 내용은 설정 페이지를 참조하세요.

텍스트를 로마자로 변환

REST

romanizeText 메서드를 사용하여 라틴어가 아닌 스크립트를 라틴어 스크립트로 변환합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_NUMBER_OR_ID: Google Cloud 프로젝트의 숫자 또는 영숫자 ID
• LOCATION: 이 작업을 실행할 리전입니다. 예를 들면 us-central1입니다.
• SOURCE_LANGUAGE: 소스 텍스트의 언어 코드입니다.
• SOURCE_TEXT: 로마자로 변환할 출발어의 텍스트입니다.

HTTP 메서드 및 URL:

POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:romanizeText

JSON 요청 본문:

{
  "source_language_code": "SOURCE_LANGUAGE",
  "contents": "SOURCE_TEXT"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER_OR_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:romanizeText"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER_OR_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:romanizeText" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "romanizations": [
    {
      "romanizedText": "ROMANIZED_TEXT"
    }
  ]
}

다음 단계

• 로마자 변환은 전송된 문자 단위로 가격이 책정됩니다. 자세한 내용은 가격 책정을 참조하세요.