本文档介绍了如何使用 Cloud Translation 基本版 (v2) 翻译文本。
输入文本可以是纯文本或 HTML。Cloud Translation 基本版不会翻译输入文本中的任何 HTML 标记,只会翻译出现在标记之间的文本。由于源语言和目标语言之间存在差异,输出会尽可能地保留(未翻译的)HTML 标记,并将翻译的文本置于标记之间。 由于翻译中的词序更改,输出中 HTML 标记的顺序可能与输入文本中的顺序不同。
准备工作
在开始使用 Cloud Translation API 之前,您必须具有启用了 Cloud Translation API 的项目,并且必须具有适当的凭据。您还可以安装常用编程语言的客户端库,以便调用 API。如需了解详情,请参阅设置页面。
翻译文本
本部分介绍了从 https://translation.googleapis.com/language/translate/v2
端点请求翻译的一些方法。
翻译输入字符串
REST
要翻译文本,请发出POST
请求,并在请求正文中提供 JSON,以标识要翻译的语言 (target
) 以及要翻译的文本 (q
)。您可以通过添加多个 q
字段或 q
字段值列表来提供多个要翻译的文本片段,所提供的文本段不能超过 128 个。您可以使用相应的 ISO-639 代码来指定目标语言。
下面显示了使用 curl
或 PowerShell 的 POST
请求的示例。该示例针对通过 Google Cloud CLI 为项目设置的服务帐号使用访问令牌。如需了解有关安装 Google Cloud CLI、使用服务帐号设置项目以及获取访问令牌的说明,请参阅设置页面。
HTTP 方法和网址:
POST https://translation.googleapis.com/language/translate/v2
请求 JSON 正文:
{ "q": ["Hello world", "My name is Jeff"], "target": "de" }
如需发送您的请求,请展开以下选项之一:
您应该收到类似以下内容的 JSON 响应:
{ "data": { "translations": [ { "translatedText": "Hallo Welt", "detectedSourceLanguage": "en" }, { "translatedText": "Mein Name ist Jeff", "detectedSourceLanguage": "en" } ] } }
translations
数组包含两个 translatedText
字段,其中译文以请求的 target
语言(de
:德语)提供。译文的排列顺序与相应源数组在请求中的顺序相同。
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 基本版发出翻译请求时,系统将使用 Google 神经机器翻译 (NMT) 模型翻译您的文本。您不能使用任何其他模型。如需使用 AutoML 模型翻译文本,请使用 Cloud Translation 高级版。
自行试用
如果您是 Google Cloud 新手,请创建一个帐号来评估 Cloud Translation 在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
免费试用 Cloud Translation其他资源
- 如需有关解决常见问题或错误的帮助,请参阅问题排查页面。