Basic에서 Advanced로 마이그레이션
용어집 및 AutoML 모델과 같은 최신 Cloud Translation 기능을 사용하고 싶은 기존 Cloud Translation - Basic(v2) 사용자는 Cloud Translation - Advanced(v3)를 사용할 수 있도록 애플리케이션을 마이그레이션해야 합니다. 비교 정보를 보려면 Basic과 Advanced 비교를 참조하세요.
Advanced 버전으로 마이그레이션하면 Identity and Access Management(IAM) 및 Advanced 버전 클라이언트 라이브러리를 사용할 수 있습니다. 다음 섹션에서는 마이그레이션 태스크와 두 버전 간의 주요 차이점을 설명합니다.
Advanced로 마이그레이션
다음 단계에서는 Cloud Translation - Basic에서 Cloud Translation - Advanced로 기존 애플리케이션을 업데이트할 때 필요한 작업들을 설명합니다.
- Cloud Translation - Basic API에 액세스하는 Google Cloud 프로젝트, 애플리케이션, 사용자의 인벤토리를 작성합니다. 서비스 계정을 제공하고 Cloud Translation - Advanced 클라이언트 라이브러리를 사용하도록 업데이트해야 합니다.
- 애플리케이션에 사용할 서비스 계정과 인증을 설정합니다.
- IAM 역할을 사용하여 서비스 계정에 대해 권한을 설정합니다.
- 프로젝트에 Cloud Translation - Advanced를 사용 설정합니다. Cloud Translation - Advanced에서 AutoML 모델을 사용하는 경우 AutoML도 사용 설정해야 합니다. 자세한 내용은 설정 가이드를 참조하세요.
- Cloud Translation - Advanced 클라이언트 라이브러리 및 메서드를 사용합니다. Cloud Translation - Advanced 요청 시 프로젝트 번호(또는 프로젝트 ID)와 프로젝트 위치(
global또는us-central1등)를 포함해야 합니다. - Cloud Translation - Advanced의 번역 요청 크기가 한도를 초과하지 않는지 확인합니다.
- 번역 요청 할당량 모니터링을 계획합니다. 두 버전의 API는 동일한 일일 및 월간 할당량을 공유합니다.
- 결제에서 변경된 사항이 없는지 검토합니다.
Advanced와 Basic 사이의 주요 차이점
마이그레이션 태스크 이해를 돕기 위해 다음 섹션에서는 Advanced 및 Basic 버전 사이의 주요 차이점을 설명합니다.
서비스 계정
Cloud Translation - Basic의 경우 API 키 또는 서비스 계정을 사용하여 인증된 요청을 전송할 수 있습니다.
Cloud Translation - Advanced에는 고객 관리 리소스가 필요한 기능이 있으며, 이러한 리소스에는 IAM 역할 및 권한 관리가 필요합니다. 따라서 API 키를 사용하여 서비스에 인증할 수 없습니다. 대신 Cloud Translation - Advanced로 인증할 때 서비스 계정을 사용해야 합니다.
자세한 내용은 설정 가이드를 참조하세요.
IAM 역할
Cloud Translation - Basic 서비스 계정을 사용할 때 서비스 계정은 인증용으로만 사용됩니다. 서비스 계정과 연관된 권한이 무엇이든 간에 Cloud Translation - Basic을 호출할 수 있습니다. 하지만 Cloud Translation - Advanced의 경우에는 권한에 따라 달라집니다.
서비스 계정에 Cloud Translation - Advanced 호출 권한을 부여하려면 여기에 IAM 역할을 할당합니다. Cloud Translation - Advanced는 프로젝트의 특정 리소스에 액세스하기 위해 서비스 계정에 할당할 수 있는 여러 IAM 역할이 포함됩니다. 예를 들어 서비스 계정을 사용하여 텍스트를 번역하려면 여기에 roles/cloudtranslate.user 역할을 할당합니다. 자세한 내용은 Cloud Translation - Advanced 세부정보에서 IAM 역할을 참조하세요.
Cloud Storage에 의존하는 AutoML 모델 또는 다른 기능을 사용하려면 해당 서비스에 대해서도 적합한 역할을 포함시켜야 합니다. 모든 IAM 역할 목록을 보려면 IAM 역할 문서를 참조하세요.
번역 모델
Cloud Translation - Basic을 사용하여 번역을 요청하면 Google은 선행 학습된 인공신경망 기계 번역(NMT) 모델을 사용합니다. Cloud Translation - Advanced의 경우 선행 학습된 NMT 모델이나 AutoML Translation 커스텀 모델을 사용할 수 있습니다.
번역 요청에 사용하는 서비스 계정에는 다른 프로젝트에 있을 수 있는 NMT 및 AutoML 모델에 액세스할 수 있는 권한이 있어야 합니다. 예를 들어 유지보수 및 청구를 간소화하기 위해 번역 모델이 포함된 중앙 프로젝트를 사용할 수 있습니다. 해당 프로젝트 또는 다른 프로젝트의 서비스 계정이 이러한 모델을 사용할 수 있지만 이렇게 하기 위해서는 권한이 필요합니다.
번역 모델에 대한 자세한 내용은 텍스트 번역(Advanced)을 참조하세요.
클라이언트 라이브러리
Cloud Translation - Advanced의 클라이언트 라이브러리 및 메서드는 Cloud Translation - Basic과 다릅니다. 예를 들어 Cloud Translation - Advanced 호출에는 리소스 이름이 필요합니다. 자세한 내용은 Cloud Translation - Advanced 클라이언트 라이브러리 개요를 보거나 텍스트 번역(Advanced 버전) 빠른 시작을 참조하세요.
리소스, 프로젝트, 위치
Cloud Translation - Advanced에 대한 요청에는 사용하려는 리소스 이름이 필요합니다. 리소스는 일반적으로 프로젝트 이름 및 해당 위치를 포함하는 정규화된 이름입니다. 이 이름은 요청이 실행된 위치를 지정합니다. 예를 들어 AutoML 모델의 이름은 리소스 이름입니다.
Google Cloud 프로젝트에 my-project 이름이 있고 리소스 위치가 us-central1이면 리소스의 전체 이름이 다음과 같을 수 있습니다.
projects/MY_PROJECT/locations/us-central1/...
getSupportedLanguages 요청을 전송하는 URL은 다음과 같을 수 있습니다.
https://translation.googleapis.com/v3/projects/my-project/locations/us-central1/supportedLanguages
요청당 콘텐츠 한도
Cloud Translation API는 소량의 요청을 번역하는 데 최적화되어 있습니다. 요청당 권장되는 최대 길이는 5,000자(코드 포인트)입니다. 하지만 포함되는 문자 수가 많을수록 응답 지연 시간이 늘어납니다. Cloud Translation - Advanced의 단일 요청당 최대 코드 포인트 수는 30,000입니다. Cloud Translation - Basic의 최대 요청 크기는 100,000바이트입니다.
Cloud Translation API는 남아 있는 할당량에 상관없이 최댓값보다 큰 요청은 거부하고 400 INVALID_ARGUMENT 오류를 표시합니다.
할당량 및 한도에 대한 자세한 내용은 할당량을 참조하세요.
다음 단계
Cloud Translation - Advanced를 사용하여 텍스트를 번역하거나, 용어집을 만들거나, 일괄 요청을 수행합니다.