Translation API를 사용하여 텍스트 번역

Cloud Translation을 사용하면 임의의 문자열을 지원되는 언어로 번역할 수 있습니다. 소스 언어를 알 수 없는 경우에도 언어 감지를 사용할 수 있습니다.

학습할 내용

  • Cloud Translation API 요청 만들기 및 curl로 API 호출하기
  • 텍스트 번역
  • 프리미엄 버전 사용
  • 언어 감지

필요한사항

  • Google Cloud Platform 프로젝트
  • 브라우저(Chrome, Firefox 등)

설문조사

이 튜토리얼을 어떻게 사용하실 계획인가요?

읽기만 할 계획입니다. 읽은 다음 연습 활동을 완료할 계획입니다.

귀하의 Google Cloud Platform 사용 경험을 평가해 주세요.

초급 중급 고급

자습형 환경 설정

아직 Google 계정 (Gmail 또는 Google Apps)이 없으면 계정을 만들어야 합니다. Google Cloud Platform 콘솔 (console.cloud.google.com)에 로그인하고 새 프로젝트를 만듭니다.

Screenshot from 2016-02-10 12:45:26.png

모든 Google Cloud 프로젝트에서 고유한 이름인 프로젝트 ID를 기억하세요(위의 이름은 이미 사용되었으므로 사용할 수 없습니다).

Google Cloud Platform 신규 사용자는 $300 상당의 무료 체험판을 사용할 수 있습니다.

컨퍼런스 Codelab 설정

강사가 미리 설정된 기존 프로젝트로 임시 계정을 공유하므로 결제 사용 설정 또는 codelab 실행과 관련된 비용에 대해 염려하지 않아도 됩니다. codelab이 종료되면 모든 계정이 사용 중지됩니다.

강사로부터 로그인할 수 있는 임시 사용자 이름 / 비밀번호를 받으면 Google Cloud 콘솔(https://console.cloud.google.com/)에 로그인합니다.

로그인하면 다음과 같이 표시됩니다.

화면 왼쪽 상단의 메뉴 아이콘을 클릭합니다.

드롭다운에서 API 관리자를 선택합니다.

API 사용 설정을 클릭합니다.

그런 다음 검색창에 'translate'를 검색합니다. Google Cloud Translation API를 클릭합니다.

API가 이미 사용 설정된 경우 '사용 중지' 버튼이 표시됩니다. API를 사용 중지하지 마세요.

API가 사용 중지된 경우 사용 설정을 클릭하여 Cloud Translation API를 사용 설정합니다.

사용 설정될 때까지 몇 초간 기다립니다. 사용 설정되면 다음이 표시됩니다.

Google Cloud Shell은 Cloud에서 실행되는 명령줄 환경입니다. 이 Debian 기반 가상 머신은 필요한 모든 개발 도구 (gcloud, bq, git 등)와 함께 로드되며, 영구 5GB 홈 디렉터리를 제공합니다. Cloud Shell을 사용하여 Translation API에 대한 요청을 만듭니다.

Cloud Shell을 시작하려면 헤더 바의 오른쪽 상단에 있는 'Google Cloud Shell 활성화' Screen Shot 2015-06-08 at 5.30.32 PM.png 아이콘을 클릭합니다.

콘솔 하단에 있는 새 프레임 내에 Cloud Shell 세션이 열리면서 명령줄 프롬프트가 표시됩니다. user@project:~$ 프롬프트가 표시될 때까지 기다립니다.

Translation API로 요청을 전송하기 위해 curl을 사용할 것이므로, 요청 URL에 전달할 API 키를 만들어야 합니다. API 키를 만들려면 다음과 같이 프로젝트 대시보드의 API 관리자 섹션으로 이동합니다.

그런 다음 사용자 인증 정보 탭으로 이동하여 사용자 인증 정보 만들기를 클릭합니다.

드롭다운 메뉴에서 API 키를 선택합니다.

방금 만든 키를 복사합니다.

API 키를 클립보드에 복사한 다음 다음 코드 줄을 사용하여 Cloud Shell의 환경 변수에 저장합니다. YOUR_API_KEY를 클립보드의 키로 대체해야 합니다.

export API_KEY=YOUR_API_KEY

이 예에서는 'My name is Steve'라는 문자열을 스페인어로 번역합니다. 다음 curl 명령어를 사용하여 번역할 텍스트와 이전에 저장한 API 키 환경 변수를 Translation API에 전달합니다.

TEXT="My%20name%20is%20Steve"
curl "https://translation.googleapis.com/language/translate/v2?target=es&key=${API_KEY}&q=${TEXT}"

다음과 같은 응답이 표시됩니다.

{
  "data": {
    "translations": [
      {
        "translatedText": "Mi nombre es Steve",
        "detectedSourceLanguage": "en"
      }
    ]
  }
}

대답에서 번역된 텍스트와 API가 감지한 소스 언어를 확인할 수 있습니다.​

Translation API를 사용하면 텍스트를 번역할 뿐만 아니라 텍스트의 언어를 감지할 수도 있습니다. 이 예에서는 두 문자열의 언어를 감지합니다. 다음 curl 명령어를 사용하여 검사할 텍스트와 이전에 저장한 API 키 환경 변수를 Translation API에 전달합니다. 

TEXT_ONE="Meu%20nome%20é%20Steven"
TEXT_TWO="日本のグーグルのオフィスは、東京の六本木ヒルズにあります"
curl "https://translation.googleapis.com/language/translate/v2/detect?key=${API_KEY}&q=${TEXT_ONE}&q=${TEXT_TWO}"

다음과 같은 응답이 나타납니다.

{
  "data": {
    "detections": [
      [
        {
          "confidence": 0.20671661198139191,
          "isReliable": false,
          "language": "pt"
        }
      ],
      [
        {
          "confidence": 0.97750955820083618,
          "isReliable": false,
          "language": "ja"
        }
      ]
    ]
  }
}

이 샘플에서 반환되는 언어는 'pt'와 'ja'입니다. 포르투갈어와 일본어의 ISO-639-1 식별자입니다. Translation API에서 지원하는 언어 목록에는 반환될 수 있는 모든 언어 코드가 나열되어 있습니다.

Cloud Translation API를 사용하여 텍스트를 번역하는 방법을 알아보았습니다.

학습한 내용

  • Cloud Translation API 요청 만들기 및 curl로 API 호출하기
  • 텍스트 번역
  • 프리미엄 버전 사용
  • 언어 감지

다음 단계