使用 Translation API 翻譯文字

Cloud Translation 可讓您將任意字串翻譯成任何支援的語言。語言偵測功能也支援原文語言。

您將會瞭解的內容

  • 建立 Cloud Translation API 要求並使用 curl 呼叫 API
  • 翻譯文字
  • 使用專業版
  • 偵測語言

敬請採取行動

  • Google Cloud Platform 專案
  • 瀏覽器，例如 Chrome 或 Firefox

問卷調查

您要如何使用本教學課程？

唯讀閱讀 閱讀內容並完成練習

您對於 Google Cloud Platform 的評價如何？

初級 中級 專業

自行調整環境設定

如果您還沒有 Google 帳戶 (Gmail 或 Google Apps)，請先建立帳戶。登入 Google Cloud Platform 主控台 (console.cloud.google.com)，然後建立新專案：

2016-02-10 12:45:26.png 的螢幕擷取畫面

提醒您，專案編號是所有 Google Cloud 專案的不重複名稱 (使用上述名稱後就無法使用，敬請見諒！)

新加入 Google Cloud Platform 的使用者可免費試用$300 美元。

程式碼研究室設定

老師會暫時與您共用現有專案的現有帳戶與您共用帳戶，因此您不必為帳單啟用帳單功能或執行本程式碼研究室的任何相關費用付費。請注意，程式碼研究室結束後，這些帳戶即將停用。

收到老師的臨時使用者名稱 / 密碼後，請登入 Google Cloud Console：https://console.cloud.google.com/。

登入 後，您應該會看到以下內容：

按一下畫面左上角的選單圖示。

從下拉式選單中選取 [API Manager] (API 管理員)。

按一下 [啟用 API]。

然後在搜尋框中搜尋「翻譯」。按一下 [Google Cloud Translation API]：

如果 API 已啟用，您會看到 [停用] 按鈕。請勿停用 API。

如果 API 已停用，請按一下 [啟用] 來啟用 Cloud Translation API：

等待幾秒鐘後再啟用。啟用後，您就會看到以下訊息：

Google Cloud Shell 是在 Cloud 中執行的指令列環境。這款以 Debian 為基礎的虛擬機器會載入您需要的所有開發工具 (gcloud、bq、git 等)，並提供永久的 5GB 主目錄。我們會使用 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 管理員」部分：

接著前往「Credentials」分頁，然後按一下 [Create credentials]：

在下拉式選單中選取 [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
  • 翻譯文字
  • 使用專業版
  • 偵測語言

後續步驟