빠른 시작(Basic)

이 페이지에서는 curl을 사용하여 Cloud Translation - Basic (v2) 요청을 수행하는 방법을 보여줍니다.

시작하기 전에

  1. Google 계정으로 로그인합니다.

    아직 계정이 없으면 새 계정을 등록하세요.

  2. Cloud Console 프로젝트를 설정합니다.

    프로젝트 설정

    클릭하여 다음을 수행하세요.

    • 프로젝트를 만들거나 선택합니다.
    • 프로젝트에 Cloud Translation API를 사용 설정합니다.
    • 서비스 계정을 만듭니다.
    • 비공개 키를 JSON으로 다운로드합니다.

    언제든지 Cloud Console에서 이 리소스를 보고 관리할 수 있습니다.

  3. GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 키가 포함된 JSON 파일의 경로로 설정합니다. 이 변수는 현재 셸 세션에만 적용되므로, 새 세션을 열 경우, 변수를 다시 설정합니다.

  4. Cloud SDK 설치 및 초기화

Translation API 요청하기

v2 번역 메서드에 REST 메서드 호출을 사용하여 Translation API를 요청합니다.

  1. curl을 사용하여 https://translation.googleapis.com/language/translate/v2 엔드포인트에 요청합니다.

    curl 명령어에는 번역할 텍스트(q), 번역 출발어(source), 번역 도착어(target)가 있는 JSON이 포함됩니다.

    출발어와 도착어는 ISO-639-1 코드를 사용하여 식별합니다. 예시에서는 출발어가 영어(en)이고 도착어가 스페인어(es)이며, 쿼리 형식은 일반 텍스트를 의미하는 'text'로 지정합니다.

    샘플 curl 명령어는 gcloud auth application-default print-access-token 명령어를 사용하여 인증 토큰을 가져옵니다.

    curl -s -X POST -H "Content-Type: application/json" \
        -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
        --data "{
      'q': 'The Great Pyramid of Giza (also known as the Pyramid of Khufu or the
            Pyramid of Cheops) is the oldest and largest of the three pyramids in
            the Giza pyramid complex.',
      'source': 'en',
      'target': 'es',
      'format': 'text'
    }" "https://translation.googleapis.com/language/translate/v2"
      

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

    {
      "data": {
        "translations": [
          {
            "translatedText": "La Gran Pirámide de Giza (también conocida como la
             Pirámide de Khufu o la Pirámide de Keops) es la más antigua y más
             grande de las tres pirámides en el complejo de la pirámide de Giza."
          }
        ]
      }
    }
    
      

축하합니다. 첫 번째 요청을 Cloud Translation API로 보냈습니다.

Cloud Translation - Basic 클라이언트 라이브러리 설치

클라이언트 라이브러리는 널리 사용되는 여러 언어에서 사용할 수 있으며 권장되는 옵션입니다. 클라이언트 라이브러리를 설치하려면 다음 안내를 따르세요.

C#

nuget install Google.Cloud.Translation.V2

Go

go get -u cloud.google.com/go/translate

자바

Maven을 사용하는 경우 pom.xml 파일에 다음을 추가합니다. BOM에 대한 자세한 내용은 Google Cloud Platform 라이브러리 BOM을 참조하세요.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>10.1.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-translate</artifactId>
  </dependency>
</dependencies>

Gradle을 사용하는 경우 종속 항목에 다음을 추가합니다.

compile 'com.google.cloud:google-cloud-translate:1.95.2'

SBT를 사용하는 경우 종속 항목에 다음을 추가합니다.

libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "1.95.2"

IntelliJ 또는 Eclipse를 사용하는 경우 다음 IDE 플러그인을 사용하여 프로젝트에 클라이언트 라이브러리를 추가할 수 있습니다.

이 플러그인은 서비스 계정의 키 관리와 같은 추가 기능을 제공합니다. 자세한 내용은 각 플러그인의 문서를 참조하세요.

Node.js

Node.js 개발 환경 설정에 관한 자세한 내용은 Node.js 개발 환경 설정 가이드를 참조하세요.

npm install --save @google-cloud/translate

PHP

composer require google/cloud-translate

Python

Python 개발 환경 설정에 관한 자세한 내용은 Python 개발 환경 설정 가이드를 참조하세요.

pip install google-cloud-translate==2.0.1

Ruby

Ruby 개발 환경 설정에 관한 자세한 내용은 Ruby 개발 환경 설정 가이드를 참조하세요.

gem install google-cloud-translate

설치 안내를 보려면 Translation 클라이언트 라이브러리로 이동하세요.

삭제

불필요한 Google Cloud 요금이 청구되지 않도록 하려면 Cloud Console을 사용하여 필요하지 않은 프로젝트를 삭제하세요.

다음 단계