本文說明如何使用 Cloud Translation - Basic (v2) 翻譯文字。
輸入文字可以是純文字或 HTML。Cloud Translation - Basic 不會翻譯輸入內容中的任何 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 代碼指定目標語言。
以下為使用 curl
或 PowerShell 的 POST
要求範例。範例中使用的存取憑證,屬於使用 Google Cloud Google Cloud CLI 建立的專案服務帳戶。如需安裝 Google Cloud CLI、使用服務帳戶建立專案,以及取得存取憑證的操作說明,請參閱「設定」頁面。
使用任何要求資料之前,請先替換以下項目:
PROJECT_NUMBER_OR_ID
: Google Cloud 專案的數值或英數字元 ID
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 print-access-token)" \
-H "x-goog-user-project: PROJECT_NUMBER_OR_ID" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://translation.googleapis.com/language/translate/v2"
PowerShell
將要求主體儲存在名為 request.json
的檔案中,然後執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER_OR_ID" }
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
在試用這個範例之前,請先按照Go使用用戶端程式庫的 Cloud Translation 快速入門導覽課程中的操作說明進行設定。詳情請參閱 Cloud Translation Go API 參考說明文件。
如要向 Cloud Translation 進行驗證,請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。
Java
在試用這個範例之前,請先按照Java使用用戶端程式庫的 Cloud Translation 快速入門導覽課程中的操作說明進行設定。詳情請參閱 Cloud Translation Java API 參考說明文件。
如要向 Cloud Translation 進行驗證,請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。
Node.js
在試用這個範例之前,請先按照Node.js使用用戶端程式庫的 Cloud Translation 快速入門導覽課程中的操作說明進行設定。詳情請參閱 Cloud Translation Node.js API 參考說明文件。
如要向 Cloud Translation 進行驗證,請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。
Python
在試用這個範例之前,請先按照Python使用用戶端程式庫的 Cloud Translation 快速入門導覽課程中的操作說明進行設定。詳情請參閱 Cloud Translation Python API 參考說明文件。
如要向 Cloud Translation 進行驗證,請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。
其他語言
C#: 請按照用戶端程式庫頁面的 C# 設定說明操作, 然後前往 .NET 適用的 Cloud Translation 參考說明文件。
PHP: 請按照用戶端程式庫頁面的 PHP 設定說明 操作,然後前往 PHP 適用的 Cloud Translation 參考說明文件。
Ruby: 請按照用戶端程式庫頁面的 Ruby 設定說明 操作,然後前往 Ruby 適用的 Cloud Translation 參考文件。
模型參數
當您向 Cloud Translation - Basic 提出翻譯要求時,系統會使用 Google 神經機器翻譯 (NMT) 模型翻譯文字。你無法使用任何其他模型。如要使用 AutoML 模型翻譯文字,請使用 Cloud Translation - Advanced。
歡迎試用
如果您未曾使用過 Google Cloud,歡迎建立帳戶,親自體驗實際使用 Cloud Translation 的成效。新客戶可以獲得價值 $300 美元的免費抵免額,可用於執行、測試及部署工作負載。
免費試用 Cloud Translation其他資源
- 如需解決常見問題或錯誤的說明,請參閱「疑難排解」頁面。