[譯] 使用谷歌Cloud Translation API翻譯文本

原文： Translation APIでテキストをほんやくする

概要

使用Cloud Translation，能夠將任意的字符串翻譯爲API支持的語言。因爲語言檢測功能的存在，即便在源語言未知的狀況下，也能使用該API。

將要學習的東西

• 建立Cloud Translation API請求，使用curl調用API
• 翻譯文本的方法
• 高級版（Premium Edition）的使用方法
• 檢測語言

必要的準備

• 建立Google Cloud Platform項目
• 瀏覽器（Chrome、Firefox 等）

設置和一些說明

根據本身的狀況進行設置

還未擁有Google帳號（Gmail / Google Apps）的狀況下，建立帳號是必須的。登陸Google Cloud Platform Console（console.cloud.google.com），建立一個新項目。

請記住項目名稱。任意一個Google Cloud項目都擁有惟一的名稱（上述的名稱已經被使用了，因此實際上沒法使用）。

Google Cloud Platform的新用戶將贈與至關於$ 300的試用金。

* 用於教學的帳號

教師將已有的項目進行設置，生成臨時帳號。若你獲得了教師發放的臨時帳號，你將沒必要顧慮項目中產生的費用。可是，一旦該教學項目結束，全部的臨時帳號將被無效化。

當你從教師那收到了臨時帳號的用戶名/密碼，就可以登陸Google Cloud Console（https://console.cloud.google....）。

登陸後，你將看到以下界面。

啓用Translation API

點擊屏幕左上角的菜單圖標。

在下拉菜單中選擇 [API Manager]

點擊 [啓用API] 。

而後，在搜索框中輸入「translate」。點擊 [Google Cloud Translation API]。

API已經啓用的狀況下，只會顯示 [停用] 按鈕。請不要停用API。

API還未啓用的狀況下，點擊[啓用]，啓用 Cloud Translation API 。

等待數秒，API成功啓用後，將顯示以下。

激活Cloud Shell

Google Cloud Shell 是在雲端運行的命令行環境。這臺基於 Debian 的虛擬機可以加載任何您須要的開發工具（gcloud、bq、git等），並提供永久的5 GB主目錄。此次教程將使用 Cloud Shell 建立對 Translation API 的請求。

點擊標題欄右側的 [激活 Google Cloud Shell] 按鈕（>_），啓動Cloud Shell。

Cloud Shell 將在控制檯底部的新窗口中打開，並顯示命令行提示符。請等待提示符 user@project:~$ 出現。

生成API Key

你將經過使用curl發送一個請求來調用 Translation API 。在發送請求時，你須要在 URL 中插入一個生成的 API 密鑰。爲了建立 API 密鑰，讓咱們點擊側邊欄的 [API Manager] 。

而後，在 [憑據] 選項卡中點擊 [建立憑據] 。

在下拉菜單中選擇 [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 檢測到的源語言。

Premium 模式

Google Cloud Translation 在幾乎全部翻譯任務中都是用了 Standard Edition 模式。然而 Google 從最近開始，使用了更爲強大的 Neural machine Translation System 來優化翻譯服務。在這裏，咱們可使用 Premium 模式。詳情請參閱此處的指南。

檢測語言

除了文本翻譯之外，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.84644311666488647,
          "isReliable": false,
          "language": "pt"
        }
      ],
      [
        {
          "confidence": 1,
          "isReliable": false,
          "language": "ja"
        }
      ]
    ]
  }
}

本例中返回的語言是 「pt」和「ja」。它們是 ISO-639-1 的標識符，指葡萄牙語和日本語。關於可能的返回值，在Translation API 支持的語言一覽中能夠查詢。

恭喜！

在這次嚮導中，咱們學習瞭如何使用 Cloud Translation API 進行文本的翻譯。

學到的東西

• 建立Cloud Translation API請求，使用curl調用API
• 翻譯文本的方法
• 高級版（Premium Edition）的使用方法
• 檢測語言

下一步

• 經過經常使用的編程語言，使用客戶端庫，學習 Translation API 的示例應用程序。
• 嘗試使用 Vision API 、Speech API 。