software

Python으로 Google Cloud Translation API 마스터하기: 개발자를 위한 가이드

발행: (2026년 1월 20일 오후 02:07 GMT+9)
8 min read
원문: Dev.to

Source: Dev.to

📋 필수 조건

  • Google 계정.
  • 신용 카드 (무료 티어 내에 머물러도 Google Cloud 청구 계정 설정에 필요합니다).
  • 머신에 Python 3.7+이 설치되어 있어야 합니다.
  • 패키지 설치를 위한 pip.

1️⃣ Google Cloud 프로젝트 만들기

  1. 클라우드 콘솔 열기

    • 웹 브라우저에서 로 이동합니다.

  2. 새 프로젝트 만들기

    • 왼쪽 상단에 있는 프로젝트 드롭다운을 클릭합니다 (보통 “My First Project” 또는 현재 프로젝트 이름이 표시됩니다).
    • 팝업에서 **“New Project”**를 클릭합니다.
    • 프로젝트 이름: Python-Translation-Project (또는 원하는 명확한 이름을 사용하세요).
    • 위치: 선택 사항 – 조직/폴더가 있으면 선택하고, 없으면 “No organization”으로 둡니다.
    • **“Create”**를 클릭하고 프로비저닝이 완료될 때까지 잠시 기다립니다.

  3. 새 프로젝트 선택

    • 준비가 되면 드롭다운 메뉴에서 프로젝트를 선택합니다.

2️⃣ Cloud Translation API 활성화

  1. API 라이브러리 열기

    • 왼쪽 상단의 탐색 메뉴 (☰)를 클릭합니다.
    • APIs & Services → Library 로 이동합니다.

  2. 검색 및 활성화

    • 검색창에 “Cloud Translation API” 를 입력합니다.
    • “Cloud Translation API” 결과를 클릭합니다.
    • 큰 파란색 “ENABLE” 버튼을 누릅니다.

문제 해결: 나중에 403 Forbidden 오류가 표시되면 이 단계를 다시 확인하세요. 활성화가 전파되는 데 몇 분 정도 걸릴 수 있으며, 코드가 사용하는 프로젝트에 API가 활성화되지 않았을 수도 있습니다.

Source: …

3️⃣ 서비스 계정 만들기 (인증용)

  1. 자격 증명 열기

    • 탐색 메뉴(☰)를 클릭합니다.
    • APIs & Services → Credentials 로 이동합니다.

  2. 서비스 계정 생성

    • + CREATE CREDENTIALS → Service account 를 클릭합니다.
    • Service account name: translation-service-account (또는 유사한 이름)
    • Description (optional): “Service account for Python Translation API”.
    • “CREATE AND CONTINUE” 를 클릭합니다.

  3. 권한 부여

    • “Grant this service account access to project” 아래에서 Select a role 를 클릭합니다.
    • “Cloud Translation API User” 를 검색하여 선택합니다.
    • “CONTINUE” 를 클릭합니다.

  4. 완료

    • (선택 사항) “Grant users access to this service account” 를 건너뜁니다.
    • “DONE” 을 클릭합니다.

  5. JSON 키 다운로드

    • Credentials 페이지로 돌아가 Service Accounts 아래에 새 서비스 계정을 찾습니다.
    • 이메일 주소를 클릭 → Keys 탭 → ADD KEY → Create new key 를 선택합니다.
    • JSON (기본 및 권장) 을 선택하고 CREATE 를 클릭합니다.
    • .json 파일이 자동으로 다운로드됩니다. 이 파일을 안전하게 보관하세요 – 서비스 계정의 “비밀번호”와 같습니다.

4️⃣ 프로젝트 설정 및 설치 (로컬 머신)

4.1 프로젝트 디렉터리 만들기

mkdir my-translation-app
cd my-translation-app

4.2 자격 증명 이동하기

mkdir credentials
mv /path/to/your/downloaded-key.json credentials/google_key.json

(간편하게 파일명을 google_key.json으로 변경합니다.)

4.3 가상 환경 설정

python3 -m venv venv
# On macOS/Linux
source venv/bin/activate
# On Windows
venv\Scripts\activate

4.4 클라이언트 라이브러리 설치

pip install google-cloud-translate

5️⃣ 번역 스크립트 작성

프로젝트 루트에 translate_text.py 파일을 만들고 아래 코드를 붙여넣으세요:

import os
from google.cloud import translate_v2 as translate

# 👉 IMPORTANT: Point to your service‑account key file.
os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "credentials/google_key.json"

def translate_single_text(text: str, target_language_code: str) -> None:
    """
    Translates a single piece of text to the target language.
    """
    # Initialise the client
    client = translate.Client()

    # Perform translation
    result = client.translate(text, target_language=target_language_code)

    print(f"Original Text: {text}")
    print(f"Target Language: {target_language_code}")
    print(f"Translated Text: {result['translatedText']}")
    print(f"Detected Source Language: {result['detectedSourceLanguage']}")

if __name__ == "__main__":
    my_text = "Hello world, this is a test of the Google Cloud Translation API."

    # Example translations
    translate_single_text(my_text, "es")   # Spanish
    print("-" * 30)
    translate_single_text(my_text, "fr")   # French
    print("-" * 30)
    translate_single_text("Wie geht es dir?", "en")  # German → English

5.1 스크립트 실행

python translate_text.py

다음과 유사한 출력이 표시됩니다:

Original Text: Hello world, this is a test of the Google Cloud Translation API.
Target Language: es
Translated Text: Hola mundo, esto es una prueba de la API de traducción de Google Cloud.
Detected Source Language: en
------------------------------
Original Text: Hello world, this is a test of the Google Cloud Translation API.
Target Language: fr
Translated Text: Bonjour le monde, ceci est un test de l'API de traduction Google Cloud.
Detected Source Language: en
------------------------------
Original Text: Wie geht es dir?
Target Language: en
Translated Text: How are you?
Detected Source Language: de

🎉 다음은?

  • 다양한 언어 탐색 – ISO‑639‑1 코드(예: ja는 일본어)를 사용하세요.
  • 배치 번역 – 한 번에 여러 문자열을 번역합니다.
  • 고급 기능 – 용어집 지원, 모델 선택 등.

행복한 코딩! 🚀

번역 API 결과

대상 언어: es
감지된 원본 언어: en

원본 텍스트

Hello world, this is a test of the Google Cloud Translation API.

번역된 텍스트

Hola mundo, esta es una prueba de la API de traducción de Google Cloud.

대상 언어: fr
감지된 원본 언어: en

원본 텍스트

Hello world, this is a test of the Google Cloud Translation API.

번역된 텍스트

Bonjour le monde, ceci est un test de l’API de traduction de Google Cloud.

원본 텍스트

Wie geht es dir?

대상 언어: en
감지된 원본 언어: de

번역된 텍스트

How are you?

.gitignore

Create a .gitignore file in the root of your my-translation-app directory before pushing any code to GitHub.

# Credentials and Secrets
credentials/
.env

# Python Environment
venv/
__pycache__/
*.py[cod]

This prevents sensitive files such as google_key.json and your virtual environment from being accidentally committed to version control.

다음 단계

이제 다음을 완료했습니다:

  1. Google Cloud 프로젝트를 설정했습니다.
  2. Translation API를 활성화했습니다.
  3. 보안 서비스 계정을 구성했습니다.
  4. 텍스트를 번역하는 Python 스크립트를 작성했습니다.

이 기본 설정은 서비스 를 더 큰 데이터 파이프라인이나 웹 애플리케이션에 통합하는 등 보다 고급 번역 작업을 수행하는 데 필수적입니다.

번역을 즐기세요!

Back to Blog

관련 글

더 보기 »