java translate

Java 용 Google Cloud Translation 클라이언트

클라우드 번역을위한 Java 관용 클라이언트.

• 제품 문서
• 클라이언트 라이브러리 문서

? 2022 년 10 월,이 도서관은 Google-Cloud-Java/Java-Translate로 옮겼습니다. 이 저장소는 향후 보관 될 것입니다. 향후 릴리스는 새로운 저장소 (https://github.com/googleapis/googleapis/googogle-cloud-java/releases)에 나타납니다. Maven Artifact 좌표 ( com.google.cloud:google-cloud-translate )는 동일하게 유지됩니다.

QuickStart

BOM과 함께 Maven을 사용하는 경우 POM.XML 파일에 추가하십시오.

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

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

BOM없이 Maven을 사용하는 경우 의존성에 추가하십시오.

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

Gradle 5.x 이상을 사용하는 경우 종속성에 추가하십시오.

implementation platform( ' com.google.cloud:libraries-bom:26.1.4 ' )

implementation ' com.google.cloud:google-cloud-translate '

BOM이없는 Gradle을 사용하는 경우 종속성에 추가하십시오.

implementation ' com.google.cloud:google-cloud-translate:2.6.0 '

SBT를 사용하는 경우 종속성에 추가하십시오.

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

입증

Base Directory의 readme의 인증 섹션을 참조하십시오.

권한 부여

API 호출을 작성하는 클라이언트 응용 프로그램에는 원하는 클라우드 번역 API에 필요한 승인 범위가 부여되어야하며, 인증 교장은 클라우드 번역 API 호출을 사용하여 GCP 리소스에 액세스하는 데 필요한 IAM 역할을 가져야합니다.

시작하기

전제 조건

Cloud Translation API가 활성화 된 Google Cloud 플랫폼 콘솔 프로젝트가 필요합니다. Google Cloud Translation을 사용하려면 청구를 활성화해야합니다. 다음 지침을 따라 프로젝트를 설정하십시오. 또한 Google Cloud SDK를 설치하고 다음 명령을 명령 줄에서 실행하여 로컬 개발 환경을 설정해야합니다. gcloud auth login 및 gcloud config set project [YOUR PROJECT ID] .

설치 및 설정

google-cloud-translate 라이브러리를 얻어야합니다. Code의 종속성으로 google-cloud-translate 추가하려면 QuickStart 섹션을 참조하십시오.

클라우드 번역에 대해

클라우드 번역은 수천 개의 언어 쌍 사이에서 텍스트를 동적으로 번역 할 수 있습니다. 번역을 통해 웹 사이트 및 프로그램이 프로그래밍 방식으로 번역 서비스와 통합 할 수 있습니다.

이 클라우드 번역 클라이언트 라이브러리를 사용하는 방법을 배우려면 클라우드 번역 클라이언트 라이브러리 문서를 참조하십시오.

예제 응용 프로그램

TranslateExample 은 Google Translation의 기능 중 일부를 제공하는 간단한 명령 줄 인터페이스입니다.

공인 서비스 객체 생성

Google 번역에 대한 인증 요청을하려면 자격 증명이있는 서비스 객체를 만들거나 API 키를 사용해야합니다. 인증하는 가장 간단한 방법은 응용 프로그램 기본 자격 증명을 사용하는 것입니다. 이러한 자격 증명은 귀하의 환경에서 자동으로 추론되므로 서비스 개체를 만들려면 다음 코드 만 있으면됩니다.

 import com . google . cloud . translate . Translate ;
import com . google . cloud . translate . TranslateOptions ;

Translate translate = TranslateOptions . getDefaultInstance (). getService ();

이 코드는 API 키와 함께 사용할 수도 있습니다. 기본적으로 API 키는 GOOGLE_API_KEY 환경 변수에서 찾습니다. API 키가 설정되면 TranslateOptions.getDefaultInstance().getService() 통해 생성 된 번역 서비스에서 메소드를 호출하여 API 호출을 할 수 있습니다.

API 키를 다음과 같이 명시 적으로 설정할 수도 있습니다.

 Translate translate = TranslateOptions . newBuilder (). setApiKey ( "myKey" ). build (). getService ();

언어 탐지

Google 번역을 사용하면 일부 텍스트의 언어를 감지 할 수 있습니다. 이 서비스는 감지 된 언어 코드와 수준의 신뢰를 제공합니다.

파일 상단에 다음 가져 오기를 추가하십시오.

 import com . google . cloud . translate . Detection ;

그런 다음 텍스트 샘플을 선택하십시오.

 final String mysteriousText = "Hola Mundo" ;

그런 다음 다음 코드를 추가하여 텍스트의 언어를 감지하십시오.

 Detection detection = translate . detect ( mysteriousText );
String detectedLanguage = detection . getLanguage ();

번역 텍스트

Google 번역을 사용하면 일부 텍스트를 번역 할 수 있습니다. 하나 이상의 텍스트를 번역 할 때는 소스 언어를 제공하거나 서비스가이를 감지 할 수 있습니다.

파일 상단에 다음 가져 오기를 추가하십시오.

 import com . google . cloud . translate . Translate . TranslateOption ;
import com . google . cloud . translate . Translation ;

그런 다음 다음 코드를 추가하여 텍스트를 번역하고 이전에 감지 된 언어 ( detectedLanguage )를 소스 언어 및 영어로 지정하여 대상 언어로서 (소스 언어를 제공하는 것이 선택적이라면, 서비스가 자동으로 감지하려고 시도 함). :

 Translation translation = translate . translate (
    mysteriousText ,
    TranslateOption . sourceLanguage ( detectedLanguage ),
    TranslateOption . targetLanguage ( "en" ));

완전한 소스 코드

DetectlanguageAndtranslate.java에서는 위에 표시된 모든 코드를 하나의 프로그램으로 구성했습니다. 이 프로그램은 응용 프로그램 기본 자격 증명 또는 유효한 API 키를 사용할 수 있다고 가정합니다.

샘플

샘플은 samples/ 디렉토리에 있습니다.

견본	소스 코드	시도해보십시오
QuickStart 샘플	소스 코드
용어집과 모델로 텍스트를 번역하십시오	소스 코드
배치 문서를 번역합니다	소스 코드
문서를 번역하십시오	소스 코드

문제 해결

도움을 받으려면 공유 문제 해결 문서의 지침을 따르십시오.

수송

클라우드 번역은 전송 계층에 GRPC 및 HTTP/JSON을 모두 사용합니다.

지원되는 Java 버전

이 클라이언트를 사용하려면 Java 8 이상이 필요합니다.

Google의 Java 클라이언트 라이브러리, Google Cloud 클라이언트 라이브러리 및 Google Cloud API 라이브러리는 Oracle Java Se Support 로드맵을 따르십시오 (Oracle Java SE 제품 릴리스 섹션 참조).

새로운 개발을 위해

일반적으로, 새로운 기능 개발은 Oracle의 프리미어 지원이 적용되는 가장 낮은 Java LTS 버전 (일반적으로 초기 일반 가용성에서 5 년 동안 지속됨)을 지원함으로써 발생합니다. 주어진 라이브러리에 필요한 최소 JVM이 변경되면 Semver 메이저 릴리스가 동반됩니다.

Java 11과 (2021 년 9 월) Java 17은 새로운 개발을위한 최고의 선택입니다.

생산 시스템을 최신 상태로 유지합니다

Google은 Oracle의 확장 된 지원 (일반적으로 초기 일반 가용성에서 8 년 동안 지속됨)으로 다루는 모든 LTS 버전을 사용하여 클라이언트 라이브러리를 테스트합니다.

레거시 지원

Google의 클라이언트 라이브러리는 모든 패치를 백트 포트 할 수 없을 수 있으므로 최상의 노력으로 기능 업데이트를받지 못하는 장기 안정 라이브러리를 갖춘 레거시 버전의 Java Runtimes를 지원합니다.

Google은 Java 7을 계속 사용하는 앱에 최선의 노력으로 업데이트를 제공하지만 앱은 JVM을 지원하는 현재 버전의 라이브러리로 업그레이드해야 할 수도 있습니다.

특정 정보를 찾을 수있는 곳

최신 버전과 지원되는 Java 버전은 개별 Github 저장소 github.com/GoogleAPIs/java-SERVICENAME 및 Google-Cloud-java에서 식별됩니다.

버전 작성

이 라이브러리는 시맨틱 버전을 따릅니다.

기여

이 라이브러리에 대한 기여는 항상 환영 받고 적합합니다.

자세한 내용은 시작 방법을 참조하십시오.

이 프로젝트는 기고자 행동 강령으로 공개됩니다. 이 프로젝트에 참여함으로써 귀하는 그 용어를 준수하는 데 동의합니다. 자세한 내용은 행동 강령을 참조하십시오.

특허

Apache 2.0- 자세한 내용은 라이센스를 참조하십시오.

CI 상태

자바 버전	상태
Java 8
Java 8 OSX
Java 8 Windows
Java 11

Java는 Oracle 및/또는 그 계열사의 등록 상표입니다.