用於雲翻譯的Java慣用客戶端。
? 2022年10月,該圖書館已轉移到Google-Cloud-Java/Java-Translate。該存儲庫將來會存檔。未來版本將出現在新的存儲庫中(https://github.com/googleapis/google-cloud-java/releases)。 Maven人工製品坐標( com.google.cloud:google-cloud-translate
)保持不變。
如果您正在使用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 "
請參閱“基本目錄”讀數中的身份驗證部分。
必須授予客戶端應用程序調用所需的雲翻譯API所需的授權範圍,並且身份驗證的主體必須使用Cloud Translation API調用訪問GCP資源所需的IAM角色。
您將需要一個啟用Cloud Translation API的Google Cloud Platform控制台項目。您將需要啟用計費才能使用Google Cloud Translation。請按照以下說明進行設置。您還需要通過安裝Google Cloud SDK並在命令行中運行以下命令來設置本地開發環境: gcloud auth login
and gcloud config set project [YOUR PROJECT ID]
。
您需要獲取google-cloud-translate
庫。請參閱快速啟動部分,以添加google-cloud-translate
作為代碼中的依賴性。
雲翻譯可以在數千種語言對之間動態翻譯文本。翻譯使網站和程序可以編程與翻譯服務集成。
請參閱雲翻譯客戶庫文檔,以了解如何使用此云翻譯客戶庫庫。
TranslateExample
是一個簡單的命令行界面,可提供一些Google Translation的功能。
為了向Google翻譯提出身份驗證的請求,您必須創建具有憑據的服務對像或使用API密鑰。身份驗證的最簡單方法是使用應用程序默認憑據。這些憑據會自動從您的環境中推斷出來,因此您只需要以下代碼來創建您的服務對象:
import com . google . cloud . translate . Translate ;
import com . google . cloud . translate . TranslateOptions ;
Translate translate = TranslateOptions . getDefaultInstance (). getService ();
請注意,此代碼也可以與API密鑰一起使用。默認情況下,在GOOGLE_API_KEY
環境變量中尋找一個API鍵。設置了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" ));
在destectlanguageandtranslate.java中,我們將上面顯示的所有代碼整合到一個程序中。該程序假設應用程序默認憑據或有效的API密鑰可用。
樣品在samples/
目錄中。
樣本 | 原始碼 | 嘗試一下 |
---|---|---|
快速啟動樣本 | 原始碼 | |
用詞彙表和模型翻譯文本 | 原始碼 | |
批次翻譯文檔 | 原始碼 | |
翻譯文檔 | 原始碼 |
要獲得幫助,請按照共享故障排除文檔中的說明進行操作。
Cloud Translation使用GRPC和HTTP/JSON用於傳輸層。
使用此客戶端需要Java 8或更高。
Google的Java客戶端庫,Google Cloud客戶端庫和Google Cloud API庫,請遵循Oracle Java SE支持路線圖(請參閱《 Oracle Java SE產品發布》部分)。
一般而言,新功能開發發生在支持Oracle Premier Support涵蓋的最低Java LTS版本(通常持續5年以來,從最初的一般可用性開始)。如果更改給定庫的最低JVM所需的JVM,則附有SEMVER專業版本。
Java 11和(2021年9月)Java 17是新開發項目的最佳選擇。
Google測試其客戶庫,其中所有當前LTS版本都涵蓋了Oracle的擴展支持(通常從初始常規可用性開始持續8年)。
Google的客戶庫支持Java Runtimes的舊版本,其中包括長期穩定的庫,這些庫不會在最佳的基礎上收到功能更新,因為可能無法備份所有補丁程序。
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和/或其分支機構的註冊商標。