시작하기: 번역API

구글 번역 API는 유료 서비스입니다. 웹사이트 번역은 구글 웹사이트 번역 가젯을 이용하세요.

컨텐츠 바로가기

소개

이 문서는 구글 번역 API를 사용해 어플리케이션을 만드려고 하는 개발자를 위한 것입니다. 구글 번역은 텍스트를 자동으로 번역해 주는 도구입니다 (예: 프랑스어를 영어로). 구글 번역 API를 사용해서 웹페이지나 앱에 있는 텍스트를 프로그래밍적으로 번역하는데 사용할 수 있습니다.

설정

구글 번역 API를 사용하려면 먼저 구글 클라우드 플랫폼 콘솔에서 프로젝트를 만들거나 선택을 하고 API를 쓸 수 있도록 합니다. 걸려있는 링크를 이용하면 구글 번역 API를 자동적으로 활성화하도록 해 줍니다.

어플리케이션을 식별하는 방법

어플리케이션이 구글 번역 API로 보내는 모든 요청은 API 키를 사용하여 구글에게 어플리케이션을 식별해야 합니다.

API 키 사용법에 대한 자세한 정보는 REST 사용법 문서 내에 있는 어플리케이션을 구글에게 식별하는 방법을 참조하세요.

번역 API의 백그라운드 동작

번역 컨셉

구글 번역은 하나의 언어에서 다른 언어로 자동적으로 텍스트를 번역하는 툴입니다.

원문은 번역이 되는 텍스트입니다. ‘소스 언어’는 원문이 쓰여진 언어입니다. ‘타겟 언어’는 원문이 번역된 언어입니다.

번역 API 동작

구글 번역 API를 호출하는 3가지 메서드가 있습니다.

오퍼레이션설명REST HTTP 맵핑
translate소스언어에서 타겟언어로 원문을 번역한다.GET
languages번역 메서드에 의해 지원되는 소스언어와 타겟언어의 목록을 보여준다.GET
detect원문의 언어를 감지한다.GET

호출 스타일

API를 호출하는 몇가지 방법이 있습니다.

  • REST를 바로 사용하기
  • 자바스크립트에서 REST를 사용하기 (서버쪽 코드 필요하지 않음)

REST

구글 번역 API에서의 REST는 전통적인 REST와는 약간 다릅니다. 리소스에 대한 접근 대신 서비스에 대한 접근을 제공합니다. 결과적으로 서비스 엔드포인트 역할을 하는 단일 URI를 제공합니다.

API 동작에 기술된 것과 같이 GET 방식을 사용해 구글 번역 API 서비스 엔드포인트에 접근할 수 있습니다. 쿼리 파라미터와 같은 모든 서비스 요청의 디테일한 것들은 넘어가도 됩니다.

Translate

구글 번역 API 단일 URI의 특정 포맷은:

‘parameters’에는 어떠한 파라미터든지 올 수 있습니다. 자세한 내용은 REST 사용법 문서에 있는 Working with resultsQuery parameter reference를 참조해 주세요.

번역 API의 예제는 다음과 같습니다.

Discover supported languages

언어 목록을 리턴하는 특정 포맷은:

‘parameters’에는 어떠한 파라미터든지 올 수 있습니다. 자세한 내용은 REST 사용법 문서에 있는 Working with resultsQuery parameter reference를 참조해 주세요.

language 메서드의 예제는 다음과 같습니다.

Detect source language

텍스트의 언어를 탐지하는 특정 포맷은:

‘parameters’에는 어떠한 파라미터든지 올 수 있습니다. 자세한 내용은 REST 사용법 문서에 있는 Working with resultsQuery parameter reference를 참조해 주세요.

detect 메서드의 예제는 다음과 같습니다.

REST from JavaScript

자바스크립트에서 REST를 사용하여 번역 API를 호출할 수 있습니다. 콜백 쿼리 파라미터와 콜백 함수를 사용합니다. 그러나 알고 있어야 할 것은 여러분의 API 키가 HTML 소스상에 나타날 수 있다는 것입니다. 기본적으로 키는 어떠한 사이트에서도 사용할 수 있습니다. 그러므로 권한이 없는 사이트에서의 키 사용 방지를 위해서는 여러분이 관리하는 도메인에서만 제한적으로 사용할 수 있도록 해야 합니다.

다음 단계를 따라 여러분의 API 키를 특정 도메인에서만 허용하도록 하십시요.

  1. 구글 클라우드 플랫폼 콘솔로 이동합니다.
  2. 프로젝트를 선택합니다.
  3. 메뉴에서 API Manager를 선택하고 API를 선택합니다.
  4. API 정보 페이지에서 API 이름 근처에 있는 Quota 링크를 선택합니다.
  5. 왼쪽 사이드바에서 API Access를 선택합니다.
  6. Simple API Access section 페이지에서 Edit allowed referers 링크를 클릭합니다.

다음 소스코드는 이러한 접근 방식을 사용한 예입니다.