本文档介绍了如何使用 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-1 代码来指定目标语言。
下面显示了使用 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" }
如需发送请求,请选择以下方式之一:
curl
将请求正文保存在名为 request.json
的文件中,然后执行以下命令:
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://translation.googleapis.com/language/translate/v2 "
PowerShell
将请求正文保存在名为 request.json
的文件中,然后执行以下命令:
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/language/translate/v2 " | Select-Object -Expand Content
您应该收到类似以下内容的 JSON 响应:
{ "data": { "translations": [ { "translatedText": "Hallo Welt", "detectedSourceLanguage": "en" }, { "translatedText": "Mein Name ist Jeff", "detectedSourceLanguage": "en" } ] } }
translations
数组包含两个 translatedText
字段,其中译文以请求的 target
语言(de
:德语)提供。译文的排列顺序与相应源数组在请求中的顺序相同。
Go
在试用此示例之前,请按照《Translation 快速入门:使用客户端库》中的 Go 设置说明进行操作。如需了解详情,请参阅 Translation Go API 参考文档。
Java
在试用此示例之前,请按照《Translation 快速入门:使用客户端库》中的 Java 设置说明进行操作。如需了解详情,请参阅 Translation Java API 参考文档。
Node.js
在试用此示例之前,请按照《Translation 快速入门:使用客户端库》中的 Node.js 设置说明进行操作。如需了解详情,请参阅 Translation Node.js API 参考文档。
Python
在试用此示例之前,请按照《Translation 快速入门:使用客户端库》中的 Python 设置说明进行操作。如需了解详情,请参阅 Translation Python API 参考文档。
其他语言
C#:请按照客户端库页面上的 C# 设置说明操作,然后访问 .NET 版 Translation 参考文档。
PHP:请按照客户端库页面上的 PHP 设置说明操作,然后访问 PHP 版 Translation 参考文档。
Ruby:请按照客户端库页面上的 Ruby 设置说明操作,然后访问 Ruby 版 Translation 参考文档。
模型参数
当您向 Cloud Translation 基本版发出翻译请求时,系统将使用 Google 神经机器翻译 (NMT) 模型翻译您的文本。您不能使用任何其他模型。如需使用 AutoML 模型翻译文本,请使用 Cloud Translation 高级版。
自行试用
如果您是 Google Cloud 新手,请创建一个帐号来评估 Cloud Translation 在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
免费试用 Cloud Translation其他资源
- 如需有关解决常见问题或错误的帮助,请参阅问题排查页面。