使用 Translation API 翻译文本

Cloud Translation 支持将任意字符串翻译成任何受支持的语言。当源语言未知时，也可以使用语言检测。

学习内容

  • 创建 Cloud Translation API 请求并使用 curl 调用 API
  • 翻译文本
  • 使用 Premium Edition
  • 检测语言

所需

  • 一个 Google Cloud Platform 项目
  • 一个浏览器，例如 Chrome 或 Firefox

调查问卷

您将如何使用本教程？

仅阅读教程内容 阅读并完成练习

您如何评价自己在使用 Google Cloud Platform 方面的经验水平？

新手 中级 熟练

自定进度的环境设置

如果您还没有 Google 帐号（Gmail 或 Google Apps），则必须创建一个。登录 Google Cloud Platform Console (console.cloud.google.com) 并创建一个新项目：

2016-02-10 12:45:26 的屏幕截图.png

请记住项目 ID，它在所有 Google Cloud 项目中都是唯一名称（很抱歉，上述名称已被占用，您无法使用！）。

Google Cloud Platform 的新用户有资格获享 $300 免费试用。

会议专用 Codelab 设置

教师将与您现有项目的临时帐号共享，因此您无需担心启用结算功能或运行此 Codelab 所产生的任何费用。请注意，此 Codelab 完成后，所有这些帐号很快就会停用。

收到教师的临时用户名/密码后，您就可以登录 Google Cloud Console：https://console.cloud.google.com/。

登录后会显示以下内容：

点击屏幕左上角的菜单图标。

从下拉菜单中选择 API 管理器。

点击启用 API。

然后，在搜索框中搜索“翻译”。点击 Google Cloud Translation API：

如果 API 已启用，您会看到一个“停用”按钮。请勿停用 API。

如果该 API 已停用，请点击启用以启用 Cloud Translation API：

请稍等片刻，以将其启用。启用之后，您将看到以下内容：

Google Cloud Shell 是在云端运行的命令行环境。这是一款基于 Debian 的虚拟机，其中预装了您需要的所有开发工具（gcloud、bq、git 等），并提供 5GB 的永久性主目录。我们将使用 Cloud Shell 创建对 Translation API 的请求。

如需开始使用 Cloud Shell，请点击标题栏右上角的“激活 Google Cloud Shell”图标 2015 年 6 月 8 日下午 5.30.32 的屏幕截图

一个 Cloud Shell 会话随即会在控制台底部的新框内打开，并显示命令行提示符。等待 user@project:~$ 提示出现

由于我们将使用 curl 向 Translation API 发送请求，因此需要生成 API 密钥以传入请求网址。如需创建 API 密钥，请转到项目信息中心的“API 管理器”部分：

然后，导航到凭据标签页，并点击创建凭据：

在下拉菜单中选择 API 密钥：

接下来，复制您刚刚生成的密钥。

将您的 API 密钥复制到剪贴板，然后使用以下代码行将其保存到 Cloud Shell 中的环境变量中。请务必将 YOUR_API_KEY 替换为剪贴板中的密钥。

export API_KEY=YOUR_API_KEY

在此示例中，您将字符串 "我的名字是 Steve" 翻译成西班牙语。使用以下 curl 命令将要翻译的文本以及您之前保存的 API 密钥环境变量传递给 Translation API：

TEXT="My%20name%20is%20Steve"
curl "https://translation.googleapis.com/language/translate/v2?target=es&key=${API_KEY}&q=${TEXT}"

您的响应应如下所示：

{
  "data": {
    "translations": [
      {
        "translatedText": "Mi nombre es Steve",
        "detectedSourceLanguage": "en"
      }
    ]
  }
}

在响应中，您可以看到翻译的文本以及 API 检测到的源语言。

除了翻译文本之外，Translation API 还可让您检测文本的语言。在此示例中，您将检测两个字符串的语言。使用以下 curl 命令将要检查的文本以及您之前保存的 API 密钥环境变量传递给 Translation API：

TEXT_ONE="Meu%20nome%20é%20Steven"
TEXT_TWO="日本のグーグルのオフィスは、東京の六本木ヒルズにあります"
curl "https://translation.googleapis.com/language/translate/v2/detect?key=${API_KEY}&q=${TEXT_ONE}&q=${TEXT_TWO}"

您的响应应如下所示：

{
  "data": {
    "detections": [
      [
        {
          "confidence": 0.20671661198139191,
          "isReliable": false,
          "language": "pt"
        }
      ],
      [
        {
          "confidence": 0.97750955820083618,
          "isReliable": false,
          "language": "ja"
        }
      ]
    ]
  }
}

此示例返回的语言是“pt”和“ja”。以下是适用于葡萄牙语和日语的 ISO-639-1 标识符。此 Translation API 支持的语言列表列出了可以返回的所有语言代码。

您已了解如何使用 Cloud Translation API 翻译文本！

所学内容

  • 创建 Cloud Translation API 请求并使用 curl 调用 API
  • 翻译文本
  • 使用 Premium Edition
  • 检测语言

后续步骤