使用 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 控制台：https://console.cloud.google.com/。

登录后，您应该会看到以下内容：

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

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

点击启用 API。

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

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

如果该 API 处于停用状态，请点击启用以启用 Cloud Translation API：

等待几秒钟，直到该功能启用。启用后，您会看到以下内容：

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

如需开始使用 Cloud Shell，请点击标题栏右上角的“激活 Google Cloud Shell”Screen Shot 2015-06-08 at 5.30.32 PM.png 图标

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

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

然后，前往凭据标签页，点击创建凭据：

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

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

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

export API_KEY=YOUR_API_KEY

在此示例中，您将把字符串“My name is 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 标识符。此翻译 API 支持的语言列表列出了所有可能返回的语言代码。

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

所学内容

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

后续步骤