用于云翻译的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和/或其分支机构的注册商标。