용어집 만들기 및 사용(Advanced)
용어집은 Cloud Translation API가 분야별 용어를 일관성 있게 번역하는 데 사용하는 커스텀 사전입니다. 여기에는 일반적으로 명명된 항목을 번역하는 방법을 지정하는 과정이 포함됩니다.
다음과 같은 사용 사례에 용어집을 사용할 수 있습니다.
- 제품 이름: 예를 들어 'Google Home'은 'Google Home'으로 번역해야 합니다.
- 모호한 단어: 예를 들어 'bat'라는 단어는 스포츠 장비나 동물을 의미할 수 있습니다. 스포츠와 관련된 단어를 번역하는 중이라면 용어집을 사용하여 'bat'라는 단어에 동물에 대한 번역이 아니라 스포츠에 대한 번역을 Cloud Translation API에 제공할 수 있습니다.
- 차용어: 예를 들어 프랑스어 'bouillabaisse'는 영어로도 'bouillabaisse'입니다. 'bouillabaisse'라는 영어 단어는 19세기 프랑스어에서 들어왔습니다. 따라서 프랑스 문화에 대한 지식이 없는 영어 화자는 bouillabaisse가 '부야베스'라는 생선 스튜 요리라는 것을 모를 수 있습니다. 프랑스어 'bouillabaisse'가 영어 'fish stew'로 번역되도록 용어집 번역을 재정의할 수 있습니다.
시작하기 전에
Cloud Translation API를 사용을 시작하려면 Cloud Translation API가 사용 설정된 프로젝트가 있고 적절한 사용자 인증 정보가 있어야 합니다. 공통 프로그래밍 언어용 클라이언트 라이브러리를 설치하여 API를 호출할 수도 있습니다. 자세한 내용은 설정 페이지를 참조하세요.
필수 권한
용어집을 사용하려면 서비스 계정에 용어집 관련 권한이 필요합니다. Cloud Translation API 편집자(roles/cloudtranslate.editor
)와 같은 사전 정의된 IAM 역할 중 하나를 사용하여 서비스 계정에 역할을 부여하거나 필요한 권한을 부여하는 커스텀 역할을 생성할 수 있습니다. IAM 권한 참조에서 모든 Cloud Translation API 권한을 볼 수 있습니다.
Cloud Translation 권한은 cloudtranslate
로 시작합니다.
용어집을 만들려면 용어집 파일이 있는 Cloud Storage 버킷의 객체를 읽을 수 있는 권한도 필요합니다. 스토리지 객체 뷰어(roles/storage.objectViewer
)와 같은 사전 정의된 IAM 역할 중 하나를 사용하여 서비스 계정에 역할을 부여하거나 객체를 읽을 수 있는 권한을 부여하는 커스텀 역할을 생성할 수 있습니다.
역할에 계정을 추가하는 방법에 대한 자세한 내용은 리소스에 대한 액세스 권한 부여, 변경, 취소를 참조하세요.
용어집 만들기
단일 토큰(단어) 또는 짧은 구문(보통 5단어 미만)이 용어집의 용어로 사용될 수 있습니다. 용어집 사용의 주요 단계는 다음과 같습니다.
- 용어집 파일 만들기
- Cloud Translation API를 사용하여 용어집 리소스 만들기
- 번역 요청 시 사용할 용어집 지정
한 프로젝트에 용어집이 여러 개 있을 수 있습니다. 사용 가능한 용어집 목록을 가져오고 더 이상 필요하지 않은 용어집을 삭제할 수 있습니다.
검색 제외 단어
Cloud Translation은 용어집에 포함된 일부 용어를 무시합니다. 이러한 용어를 검색 제외 단어라고 합니다. 검색 제외 단어를 번역할 때 Cloud Translation은 일치하는 용어집 항목을 무시합니다. 모든 검색 제외 단어 목록은 용어집을 참조하세요.
용어집 파일 만들기
기본적으로 용어집은 각 줄에 특정 용어가 여러 언어로 포함된 텍스트 파일입니다. Cloud Translation API는 한 쌍의 출발어 및 도착어에 원하는 번역을 지정하는 단방향 용어집과 여러 언어의 용어를 지정하는 동의어 세트를 모두 지원합니다.
용어집 입력 파일의 총 용어 수는 모든 용어를 모든 언어로 조합한 경우 1,040만(10,485,760) UTF-8 바이트를 초과할 수 없습니다. 용어집의 각 용어는 1,024 UTF-8 바이트 미만이어야 합니다. 1,024바이트를 초과하는 용어는 무시됩니다.
기본적으로 용어집 일치는 대소문자를 구분합니다. 용어집을 적용할 때 모든 항목의 대소문자를 무시해도 됩니다. 대소문자 구분 용어와 대소문자를 구분하지 않는 용어가 혼용된 경우 기본 동작을 사용하고, 대소문자를 구분하지 않는 용어의 경우 두 양식을 모두 용어집에 포함합니다.
단방향 용어집
Cloud Translation API는 TSV, CSV 또는 TMX 파일을 허용합니다.
TSV 및 CSV
탭으로 구분된 값(TSV)과 쉼표로 구분된 값(CSV)의 경우 각 행에는 탭(\t
) 또는 쉼표(,
)로 구분된 용어 쌍이 포함되어 있습니다. 다음 예시와 같이 첫 번째 열에는 출발어의 용어가 포함되고 두 번째 열에는 도착어의 용어가 포함됩니다.
Translation Memory eXchange(TMX)
Translation Memory eXchange(TMX)는 출발어와 도착어 번역을 제공하는 표준 XML 형식입니다. Cloud Translation API은 TMX 버전 1.4를 기반으로 하는 형식의 입력 파일을 지원합니다. 이 예에서는 필수 구조를 보여줍니다.
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE tmx SYSTEM "tmx14.dtd">
<tmx version="1.4">
<header segtype="sentence" o-tmf="UTF-8"
adminlang="en" srclang="en" datatype="PlainText"/>
<body>
<tu>
<tuv xml:lang="en">
<seg>account</seg>
</tuv>
<tuv xml:lang="es">
<seg>cuenta</seg>
</tuv>
</tu>
<tu>
<tuv xml:lang="en">
<seg>directions</seg>
</tuv>
<tuv xml:lang="es">
<seg>indicaciones</seg>
</tuv>
</tu>
</body>
</tmx>
올바른 형식의 TMX 파일에서 <header>
요소는 srclang
속성을 사용하여 출발어를 지정해야 하고, 모든 <tuv>
요소는 xml:lang
속성을 사용하여 포함된 텍스트의 언어를 지정해야 합니다. ISO-639 코드를 사용하여 출발어와 도착어를 지정하세요.
모든 <tu>
요소에는 출발어와 도착어가 동일한 <tuv>
요소 쌍이 포함되어야 합니다. <tu>
요소에 <tuv>
요소가 3개 이상 포함되어 있으면 Cloud Translation API는 출발어 및 도착어와 일치하는 첫 번째 <tuv>
요소만 처리하고 나머지는 무시합니다.
<tu>
요소에 일치하는 <tuv>
요소 쌍이 없으면 Cloud Translation API는 잘못된 <tu>
요소를 건너뜁니다.
Cloud Translation API는 <seg>
요소를 처리하기 전에 주위의 마크업 태그를 제거합니다. <tuv>
요소에 <seg>
요소가 2개 이상 포함되어 있으면 Cloud Translation API는 텍스트를 사이에 공백이 있는 단일 요소로 연결합니다.
위에 표시되지 않은 XML 태그가 파일에 포함되어 있으면 Cloud Translation API가 해당 태그를 무시합니다.
파일이 올바른 XML 및 TMX 형식을 따르지 않는 경우(예: 종료 태그 또는 <tmx>
요소가 없는 경우) Cloud Translation API는 해당 요소 처리를 취소합니다. 또한 잘못된 <tu>
요소를 1,024개 넘게 건너뛴 경우에도 Cloud Translation API가 처리를 취소합니다.
동의어 세트(CSV)
동의어 세트의 경우 Cloud Translation API는 CSV 형식의 파일만 허용합니다. 동의어 세트를 정의하려면 각 줄에 여러 언어의 용어가 나열되는 다중 열 CSV 파일을 만듭니다.
이 파일의 첫 번째 행은 ISO-639 또는 BCP-47 언어 코드를 사용하여 각 열의 언어를 지정하는 헤더 행입니다. 또한 품사(pos) 및 설명(pos)에 해당하는 선택적 열도 포함할 수 있습니다. 알고리즘은 현재 pos 정보를 사용하지 않으며 특정 pos 값의 유효성은 검사되지 않습니다.
각 후속 행에는 헤더에 지정된 언어의 동의어가 포함됩니다. 해당 용어가 모든 언어로 제공되지 않은 경우 열을 비워 둘 수 있습니다.
용어집 리소스 만들기
동의어를 지정했으면 용어집 리소스를 만들어 Cloud Translation API에 용어집 파일을 제공합니다.
단방향 용어집
단방향 용어집을 만들 때는 출발어(source_language_code
)와 도착어(target_language_code
)를 지정하여 언어 쌍(language_pair
)을 지정해야 합니다. 다음 예시에서는 REST API 및 명령줄을 사용하지만 클라이언트 라이브러리를 사용하여 단방향 용어집을 만들 수도 있습니다.
REST
새 용어집을 만들 때 용어집 ID(리소스 이름)를 지정합니다. 예:projects/my-project/locations/us-central1/glossaries/my-en-to-ru-glossary여기서
my-project
는 프로젝트 번호 또는 ID이고 my-en-ru-glossary
는 사용자가 제공한 용어집 ID입니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NUMBER_OR_ID: Google Cloud 프로젝트의 숫자 또는 영숫자 ID
- glossary-id: 용어집 ID(예: my_en_ru_glossary)
- bucket-name: 용어집 파일이 있는 버킷의 이름
- glossary-filename: 용어집 파일 이름
HTTP 메서드 및 URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/us-central1/glossaries
JSON 요청 본문:
{ "name":"projects/PROJECT_NUMBER_OR_ID/locations/us-central1/glossaries/glossary-id", "languagePair": { "sourceLanguageCode": "en", "targetLanguageCode": "ru" }, "inputConfig": { "gcsSource": { "inputUri": "gs://bucket-name/glossary-filename" } } }
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "name": "projects/project-number/locations/us-central1/operations/operation-id", "metadata": { "@type": "type.googleapis.com/google.cloud.translation.v3beta1.CreateGlossaryMetadata", "name": "projects/project-number/locations/us-central1/glossaries/glossary-id", "state": "RUNNING", "submitTime": "2019-11-19T19:05:10.650047636Z" } }
동의어 세트 용어집
동의어 세트에 용어집 용어를 지정했으면 용어집 리소스를 만들어 Cloud Translation API에 용어집 파일을 제공합니다.
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NUMBER_OR_ID: Google Cloud 프로젝트의 숫자 또는 영숫자 ID
- glossary-id: 용어집 ID
- bucket-name: 용어집 파일이 있는 버킷의 이름
- glossary-filename: 용어집 파일 이름
HTTP 메서드 및 URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/us-central1/glossaries
JSON 요청 본문:
{ "name":"projects/PROJECT_NUMBER_OR_ID/locations/us-central1/glossaries/glossary-id", "languageCodesSet": { "languageCodes": ["en", "en-GB", "ru", "fr", "pt-BR", "pt-PT", "es"] }, "inputConfig": { "gcsSource": { "inputUri": "gs://bucket-name/glossary-file-name" } } }
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "name": "projects/project-number/locations/us-central1/operations/20191103-09061569945989-5d937985-0000-21ac-816d-f4f5e80782d4", "metadata": { "@type": "type.googleapis.com/google.cloud.translation.v3beta1.CreateGlossaryMetadata", "name": "projects/project-number/locations/us-central1/glossaries/glossary-id", "state": "RUNNING", "submitTime": "2019-11-03T16:06:29.134496675Z" } }
Go
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Go API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Java API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Node.js API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Python API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
추가 언어
C#: 클라이언트 라이브러리 페이지의 C# 설정 안내를 따른 후 .NET용 Cloud Translation 참조 문서를 참조하세요.
PHP: 클라이언트 라이브러리 페이지의 PHP 설정 안내를 따른 후 PHP용 Cloud Translation 참고 문서를 참조하세요.
Ruby: 클라이언트 라이브러리 페이지의 Ruby 설정 안내를 따른 다음 Ruby용 Cloud Translation 참고 문서를 참조하세요.
작업 상태
용어집 리소스 만들기는 장기 실행 작업이므로 완료하는 데 상당한 시간이 걸릴 수 있습니다. 이 작업의 상태를 폴링하여 작업이 완료되었는지 확인하거나 작업을 취소할 수 있습니다.
자세한 내용은 장기 실행 작업을 참조하세요.
용어집 사용
용어집으로 텍스트 번역
Cloud Translation - Advanced에서 텍스트 번역에 사용할 번역 모델을 명시적으로 지정합니다. 또한 분야별 용어에 사용할 용어집을 지정할 수도 있습니다.
REST
이 예시에서는 기본 NMT 모델과 용어집을 사용하여 텍스트를 번역합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NUMBER_OR_ID: Google Cloud 프로젝트의 숫자 또는 영숫자 ID
- glossary-id: 용어집 ID입니다(예:
my-en-ru-glossary
). - BOOLEAN: 일치에 대소문자를 구분하지 않는지 여부입니다. 기본적으로 이 값은
false
입니다.
HTTP 메서드 및 URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/us-central1:translateText
JSON 요청 본문:
{ "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": "Dr. Watson, please discard your trash. You've shared unsolicited email with me. Let's talk about spam and importance ranking in a confidential mode.", "glossaryConfig": { "glossary": "projects/project-number/locations/us-central1/glossaries/glossary-id", "ignoreCase": BOOLEAN } }
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "glossaryTranslations": { "translatedText": "Доктор Ватсон, пожалуйста, откажитесь от своего мусора. Вы поделились нежелательной электронной почтой со я . Давайте поговорим о спаме и важности рейтинга в конфиденциальном режиме.", "glossaryConfig": { "glossary": "projects/project-number/locations/us-central1/glossaries/glossary-id", "ignoreCase": BOOLEAN } }, "translations": { "translatedText": "Доктор Ватсон, пожалуйста, откажитесь от своего мусора. Вы поделились нежелательной электронной почтой со мной. Давайте поговорим о спаме и важности рейтинга в конфиденциальном режиме.", } }
translations
필드에는 용어집이 적용되기 전의 일반적인 기계 번역이 포함되고, glossaryTranslations
필드에는 용어집이 적용된 후의 번역이 포함됩니다.
Go
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Go API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Java API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Node.js API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Python API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
추가 언어
C#: 클라이언트 라이브러리 페이지의 C# 설정 안내를 따른 후 .NET용 Cloud Translation 참조 문서를 참조하세요.
PHP: 클라이언트 라이브러리 페이지의 PHP 설정 안내를 따른 후 PHP용 Cloud Translation 참고 문서를 참조하세요.
Ruby: 클라이언트 라이브러리 페이지의 Ruby 설정 안내를 따른 다음 Ruby용 Cloud Translation 참고 문서를 참조하세요.
용어집에 관한 정보 가져오기
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NUMBER_OR_ID: Google Cloud 프로젝트의 숫자 또는 영숫자 ID
- glossary-id: 용어집 ID(예: 'my-en-to-ru-glossary')
HTTP 메서드 및 URL:
GET https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/us-central1/glossaries/glossary-id
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "name": "projects/project-number/locations/us-central1/glossaries/glossary-id", "languagePair": { "sourceLanguageCode": "en", "targetLanguageCode": "ru" }, "inputConfig": { "gcsSource": { "inputUri": "gs://bucket-name/glossary-file-name" } }, "entryCount": 9603 }
Go
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Go API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Java API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Node.js API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Python API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
추가 언어
C#: 클라이언트 라이브러리 페이지의 C# 설정 안내를 따른 후 .NET용 Cloud Translation 참조 문서를 참조하세요.
PHP: 클라이언트 라이브러리 페이지의 PHP 설정 안내를 따른 후 PHP용 Cloud Translation 참고 문서를 참조하세요.
Ruby: 클라이언트 라이브러리 페이지의 Ruby 설정 안내를 따른 다음 Ruby용 Cloud Translation 참고 문서를 참조하세요.
용어집 나열
한 프로젝트에 수많은 용어집이 포함될 수 있습니다. 이 섹션에서는 특정 프로젝트에 사용할 수 있는 용어집의 목록을 검색하는 방법을 설명합니다.
REST
이 예시에서는 지정된 프로젝트와 관련된 모든 용어집을 나열합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NUMBER_OR_ID: Google Cloud 프로젝트의 숫자 또는 영숫자 ID
HTTP 메서드 및 URL:
GET https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/us-central1/glossaries
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "glossaries": [ { "name": "projects/project-number/locations/us-central1/glossaries/glossary-id", "languagePair": { "sourceLanguageCode": "en", "targetLanguageCode": "ru" }, "inputConfig": { "gcsSource": { "inputUri": "gs://bucket-name/glossary-file-name" } }, "entryCount": 9603 }, ... ] }
Go
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Go API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Java API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Node.js API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Python API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
추가 언어
C#: 클라이언트 라이브러리 페이지의 C# 설정 안내를 따른 후 .NET용 Cloud Translation 참조 문서를 참조하세요.
PHP: 클라이언트 라이브러리 페이지의 PHP 설정 안내를 따른 후 PHP용 Cloud Translation 참고 문서를 참조하세요.
Ruby: 클라이언트 라이브러리 페이지의 Ruby 설정 안내를 따른 다음 Ruby용 Cloud Translation 참고 문서를 참조하세요.
용어집 업데이트
용어집을 업데이트하여 이름을 변경하거나 모든 항목을 새 용어집 입력 파일로 바꿀 수 있습니다. 용어집 항목의 변경사항을 롤백해야 하는 경우 원래 용어집 파일을 사용하여 수정된 용어집을 대체해야 합니다.
REST
용어집을 업데이트하려면 glossary.patch 메서드를 사용하여 PATCH 요청을 보냅니다. 다음 예시에서는 동의어 세트 용어집을 업데이트합니다. list 메서드를 사용하여 특정 용어집의 ID를 찾습니다.
update_mask
쿼리 매개변수는 용어집 입력 파일, 용어집 표시 이름 또는 둘 모두를 업데이트할 것인지 지정합니다. 하나 이상의 업데이트 마스크 매개변수가 필요합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NUMBER_OR_ID: Google Cloud 프로젝트의 숫자 또는 영숫자 ID
- LOCATION: 업데이트할 용어집이 있는 리전입니다(예:
us-central1
). - GLOSSARY_ID: 기존 용어집의 ID입니다.
- LANGUAGE_CODE: 이 동의어 세트 용어집의 언어를 지정하는 언어 코드입니다.
- GLOSSARY_FILE_PATH: 용어집 입력 파일의 위치와 파일 이름입니다.
HTTP 메서드 및 URL:
PATCH https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/glossaries/GLOSSARY_ID?update_mask=input_config&update_mask=display_name
JSON 요청 본문:
{ "name":"projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/glossaries/GLOSSARY_ID", "languageCodesSet": { "languageCodes": ["LANGUAGE_CODE", ...] }, "inputConfig": { "gcsSource": { "inputUri": "gs://GLOSSARY_FILE_PATH" } } }
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.translation.v3.UpdateGlossaryMetadata", "glossary": { "name": "projects/PROJECT_NUMBER/locations/LOCATION/glossaries/GLOSSARY_ID", "languageCodesSet": { "languageCodes": ["LANGUAGE_CODE", ...] }, "inputConfig": { "gcsSource": { "inputUri": "gs://GLOSSARY_FILE_PATH" } }, "entryCount": NUMBER_OF_ENTRIES, "submitTime": "2022-04-22T23:16:30.628806944Z", "endTime": "2022-04-22T23:41:15.115797Z", "displayName": "GLOSSARY_ID" }, "state": "RUNNING", "submitTime": "2022-04-22T23:50:24.337964527Z" } }
추가 언어
C#: 클라이언트 라이브러리 페이지의 C# 설정 안내를 따른 후 .NET용 Cloud Translation 참조 문서를 참조하세요.
PHP: 클라이언트 라이브러리 페이지의 PHP 설정 안내를 따른 후 PHP용 Cloud Translation 참고 문서를 참조하세요.
Ruby: 클라이언트 라이브러리 페이지의 Ruby 설정 안내를 따른 다음 Ruby용 Cloud Translation 참고 문서를 참조하세요.
용어집 삭제
다음 예시에서는 용어집을 삭제합니다.
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NUMBER_OR_ID: Google Cloud 프로젝트의 숫자 또는 영숫자 ID
- glossary-id: 용어집 ID
HTTP 메서드 및 URL:
DELETE https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/us-central1/glossaries/glossary-id
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.
Go
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Go API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Java API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Node.js API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Python API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
추가 언어
C#: 클라이언트 라이브러리 페이지의 C# 설정 안내를 따른 후 .NET용 Cloud Translation 참조 문서를 참조하세요.
PHP: 클라이언트 라이브러리 페이지의 PHP 설정 안내를 따른 후 PHP용 Cloud Translation 참고 문서를 참조하세요.
Ruby: 클라이언트 라이브러리 페이지의 Ruby 설정 안내를 따른 다음 Ruby용 Cloud Translation 참고 문서를 참조하세요.
용어집 항목 관리
용어집 항목은 한 언어의 용어를 다른 언어의 용어에 매핑합니다. 용어집에 새 항목을 추가하거나 기존 용어집의 모든 항목을 나열하거나 기존 항목을 수정할 수 있습니다.
새 항목 만들기
새 항목을 만들어 기존 용어집에 용어를 추가합니다. 단방향 용어집의 경우 한 용어가 출발어이고 다른 하나는 도착어인 용어 쌍을 제공합니다. 동의어 세트 용어집의 경우 세트의 각 항목이 용어 및 언어 코드를 지정하는 용어 세트를 제공합니다.
REST
다음 예시에서는 동의어 세트 용어집의 항목을 만듭니다. 요청당 하나의 항목만 만들 수 있습니다. 자세한 내용은 glossaryEntries.create 메서드를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NUMBER_OR_ID: Google Cloud 프로젝트의 숫자 또는 영숫자 ID
- LOCATION: 업데이트할 용어집이 있는 리전입니다(예:
us-central1
). - GLOSSARY_ID: 기존 용어집의 ID입니다.
- LANGUAGE_CODE: 용어 언어를 지정하는 언어 코드입니다.
- TERM: 용어집에 추가할 용어입니다.
- DESCRIPTION: 용어집 항목에 대한 정보입니다.
HTTP 메서드 및 URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/glossaries/GLOSSARY_ID/glossaryEntries
JSON 요청 본문:
{ termsSet: { terms: { languageCode: "LANGUAGE_CODE", text: "TERM" }, ... }, description: "DESCRIPTION" }
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/glossaries/GLOSSARY_ID/glossaryEntries/GLOSSARY_ENTRY_ID", "termsSet": { "terms": [ { "languageCode": "LANGUAGE_CODE", "text": "TERM" }, ... ] }, "description": "DESCRIPTION" }
추가 언어
C#: 클라이언트 라이브러리 페이지의 C# 설정 안내를 따른 후 .NET용 Cloud Translation 참조 문서를 참조하세요.
PHP: 클라이언트 라이브러리 페이지의 PHP 설정 안내를 따른 후 PHP용 Cloud Translation 참고 문서를 참조하세요.
Ruby: 클라이언트 라이브러리 페이지의 Ruby 설정 안내를 따른 다음 Ruby용 Cloud Translation 참고 문서를 참조하세요.
용어집 항목 나열
기존 용어집의 모든 항목을 나열합니다. 예를 들어 특정 용어집에서 용어 및 언어를 확인하려는 경우에 유용합니다.
REST
모든 용어집 항목을 나열하려면 glossaryEntries.list 메서드로 GET 요청을 보냅니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NUMBER_OR_ID: Google Cloud 프로젝트의 숫자 또는 영숫자 ID
- LOCATION: 업데이트할 용어집이 있는 리전입니다(예:
us-central1
). - GLOSSARY_ID: 기존 용어집의 ID입니다.
HTTP 메서드 및 URL:
GET https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/glossaries/GLOSSARY_ID/glossaryEntries
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "glossaryEntries": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/glossaries/GLOSSARY_ID/glossaryEntries/GLOSSARY_ENTRY_ID", "termsSet": { "terms": [ { "languageCode": "LANGUAGE_CODE", "text": "TERM" }, ... ] }, "description": "DESCRIPTION" }, ... ] }
추가 언어
C#: 클라이언트 라이브러리 페이지의 C# 설정 안내를 따른 후 .NET용 Cloud Translation 참조 문서를 참조하세요.
PHP: 클라이언트 라이브러리 페이지의 PHP 설정 안내를 따른 후 PHP용 Cloud Translation 참고 문서를 참조하세요.
Ruby: 클라이언트 라이브러리 페이지의 Ruby 설정 안내를 따른 다음 Ruby용 Cloud Translation 참고 문서를 참조하세요.
용어집 항목 가져오기
단일 항목을 가져와 해당 정보를 확인합니다.
REST
단일 용어집 항목을 가져오려면 glossaryEntries.get 메서드를 사용하여 GET 요청을 보냅니다. list 메서드를 사용하여 특정 항목의 ID를 찾습니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NUMBER_OR_ID: Google Cloud 프로젝트의 숫자 또는 영숫자 ID
- LOCATION: 업데이트할 용어집이 있는 리전입니다(예:
us-central1
). - GLOSSARY_ID: 기존 용어집의 ID입니다.
- GLOSSARY_ENTRY_ID: 기존 용어집 항목의 ID입니다.
HTTP 메서드 및 URL:
GET https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/glossaries/GLOSSARY_ID/glossaryEntries/GLOSSARY_ENTRY_ID
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/glossaries/GLOSSARY_ID/glossaryEntries/GLOSSARY_ENTRY_ID", "termsSet": { "terms": [ { "languageCode": "LANGUAGE_CODE", "text": "TERM" }, ... ] }, "description": "DESCRIPTION" }
추가 언어
C#: 클라이언트 라이브러리 페이지의 C# 설정 안내를 따른 후 .NET용 Cloud Translation 참조 문서를 참조하세요.
PHP: 클라이언트 라이브러리 페이지의 PHP 설정 안내를 따른 후 PHP용 Cloud Translation 참고 문서를 참조하세요.
Ruby: 클라이언트 라이브러리 페이지의 Ruby 설정 안내를 따른 다음 Ruby용 Cloud Translation 참고 문서를 참조하세요.
용어집 항목 업데이트
단일 항목을 업데이트하거나 용어집의 모든 항목을 대체할 수 있습니다. 모든 항목을 바꾸려면 용어집 업데이트를 참조하세요.
단방향 용어집의 항목을 수정하려면 한 용어가 출발어이고 다른 용어가 도착어인 용어 쌍을 제공합니다. 동의어 세트 용어집의 경우 세트의 각 항목이 용어 및 언어 코드를 지정하는 용어 세트를 제공합니다.
REST
다음 예시에서는 동의어 세트 용어집의 항목을 업데이트합니다. 자세한 내용은 glossaryEntries.patch 메서드를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NUMBER_OR_ID: Google Cloud 프로젝트의 숫자 또는 영숫자 ID
- LOCATION: 업데이트할 용어집이 있는 리전입니다(예:
us-central1
). - GLOSSARY_ID: 업데이트할 항목이 포함된 기존 용어집의 ID입니다.
- GLOSSARY_ENTRY_ID: 업데이트할 용어집 항목의 ID입니다.
- LANGUAGE_CODE: 용어 언어를 지정하는 언어 코드입니다.
- TERM: 업데이트할 용어입니다.
- DESCRIPTION: 용어집 항목에 대한 정보입니다.
HTTP 메서드 및 URL:
PATCH https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/glossaries/GLOSSARY_ID/glossaryEntries/GLOSSARY_ENTRY_ID
JSON 요청 본문:
{ termsSet: { terms: { languageCode: "LANGUAGE_CODE", text: "TERM" }, ... }, description: "DESCRIPTION" }
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/glossaries/GLOSSARY_ID/glossaryEntries/GLOSSARY_ENTRY_ID", "termsSet": { "terms": [ { "languageCode": "LANGUAGE_CODE", "text": "TERM" }, ... ] }, "description": "DESCRIPTION" }
추가 언어
C#: 클라이언트 라이브러리 페이지의 C# 설정 안내를 따른 후 .NET용 Cloud Translation 참조 문서를 참조하세요.
PHP: 클라이언트 라이브러리 페이지의 PHP 설정 안내를 따른 후 PHP용 Cloud Translation 참고 문서를 참조하세요.
Ruby: 클라이언트 라이브러리 페이지의 Ruby 설정 안내를 따른 다음 Ruby용 Cloud Translation 참고 문서를 참조하세요.
용어집 항목 삭제
단일 용어집 항목을 삭제합니다.
REST
단일 용어집 항목을 삭제하려면 glossaryEntries.delete 메서드를 사용하여 삭제 요청을 보냅니다. list 메서드를 사용하여 특정 항목의 ID를 찾습니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NUMBER_OR_ID: Google Cloud 프로젝트의 숫자 또는 영숫자 ID
- LOCATION: 업데이트할 용어집이 있는 리전입니다(예:
us-central1
). - GLOSSARY_ID: 삭제할 항목이 포함된 기존 용어집의 ID입니다.
- GLOSSARY_ENTRY_ID: 삭제할 용어집 항목의 ID입니다.
HTTP 메서드 및 URL:
DELETE https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/glossaries/GLOSSARY_ID/glossaryEntries/GLOSSARY_ENTRY_ID
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.
추가 언어
C#: 클라이언트 라이브러리 페이지의 C# 설정 안내를 따른 후 .NET용 Cloud Translation 참조 문서를 참조하세요.
PHP: 클라이언트 라이브러리 페이지의 PHP 설정 안내를 따른 후 PHP용 Cloud Translation 참고 문서를 참조하세요.
Ruby: 클라이언트 라이브러리 페이지의 Ruby 설정 안내를 따른 다음 Ruby용 Cloud Translation 참고 문서를 참조하세요.
추가 리소스
- 일반적인 문제 또는 오류를 해결하는 데 도움이 필요하면 문제 해결 페이지를 참조하세요.