Java Idiomatic Client для облачного перевода.
? В октябре 2022 года эта библиотека переехала в Google-Cloud-Java/Java-Translate. Этот репозиторий будет архив в будущем. Будущие выпуски появятся в новом репозитории (https://github.com/googleapis/google-cloud-java/releases). Координаты артефакта Maven ( com.google.cloud:google-cloud-translate
) остаются прежними.
Если вы используете Maven с BOM, добавьте это в свой файл 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 >
Если вы используете Maven без BOM, добавьте это в свои зависимости:
< 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 '
Если вы используете Gradle без BOM, добавьте это в свои зависимости:
implementation ' com.google.cloud:google-cloud-translate:2.6.0 '
Если вы используете SBT, добавьте это в свои зависимости:
libraryDependencies + = " com.google.cloud " % " google-cloud-translate " % " 2.6.0 "
См. Раздел аутентификации в Readme базового каталога.
Клиентским приложениям, создающим вызовы API, должны быть предоставлены области авторизации, необходимые для желаемого облачного перевода API, и аутентифицированная принципала должна иметь роль (ы) IAM, необходимые для доступа к ресурсам GCP с использованием вызовов API -API TRAUD TRALVS.
Вам понадобится консольный проект Google Cloud Platform с включенным API Translation Cloud. Вам нужно будет позволить биллинг использовать Google Cloud Translation. Следуйте этим инструкциям, чтобы настроить ваш проект. Вам также необходимо будет настроить локальную среду разработки, установив Google Cloud SDK и запустив следующие команды в командной строке: gcloud auth login
и gcloud config set project [YOUR PROJECT ID]
.
Вам нужно будет получить библиотеку google-cloud-translate
. См. Раздел QuickStart, чтобы добавить google-cloud-translate
в качестве зависимости в вашем коде.
Облачный перевод может динамически перевести текст между тысячами языковых пар. Перевод позволяет веб -сайтам и программам программно интегрироваться с службой перевода.
См. Документы клиентской библиотеки Cloud Translation, чтобы узнать, как использовать эту клиентскую библиотеку Cloud Translation.
TranslateExample
- это простой интерфейс командной строки, который предоставляет некоторые функциональность Translation Google.
Чтобы сделать аутентифицированные запросы на перевод 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 установлен, вы можете сделать вызовы API, вызывая методы в службу перевода, созданную с помощью TranslateOptions.getDefaultInstance().getService()
.
Вы также можете явно установить ключ 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 8 или выше требуется для использования этого клиента.
Google Java Client Bibraries, Google Cloud Client Booitraries и Google Cloud API библиотеки API следуют за дорожной картой поддержки Oracle Java SE (см. Раздел «Выпуск продуктов Oracle Java SE»).
В целом, разработка новых функций происходит при поддержке самой низкой версии Java LTS, охватываемой главной поддержкой Oracle (которая обычно длится 5 лет от первоначальной общей доступности). Если изменяется минимальный необходимый JVM для данной библиотеки, он сопровождается основным выпуском SEMVER.
Java 11 и (в сентябре 2021 года) Java 17 - лучший выбор для новой разработки.
Google проверяет свои клиентские библиотеки со всеми текущими версиями LTS, охватываемыми расширенной поддержкой Oracle (которая обычно длится 8 лет от первоначальной общей доступности).
Клиентские библиотеки Google поддерживают Legacy Versions of Java -Runtime с долгосрочными стабильными библиотеками, которые не получают обновления функций на все усилия, так как может быть невозможным вернуть все исправления.
Google предоставляет обновления на наибольшей степени усилия для приложений, которые продолжают использовать Java 7, хотя приложениям, возможно, потребуется перейти на текущие версии библиотеки, которая поддерживает их JVM.
Последние версии и поддерживаемые версии Java идентифицированы в отдельном репозитории GitHub github.com/GoogleAPIs/java-SERVICENAME
и в Google-cloud-java.
Эта библиотека следует за семантической версией.
Вклад в эту библиотеку всегда приветствуется и очень рекомендуется.
См. Получите дополнительную информацию, как начать.
Обратите внимание, что этот проект выпущен с кодексом поведения участника. Участвуя в этом проекте, вы соглашаетесь соблюдать его условия. См. Кодекс поведения для получения дополнительной информации.
Apache 2.0 - См. Лицензию для получения дополнительной информации.
Java версия | Статус |
---|---|
Java 8 | |
Java 8 Osx | |
Java 8 Windows | |
Java 11 |
Java является зарегистрированным товарным знаком Oracle и/или ее филиалов.