今天我們正在研究翻譯 REST API,它可以將 Word 和 Excel 文檔翻譯成其他語言。通過GroupDocs.Translation Cloud,任何文檔都可以從英語翻譯成中文、法語、德語、意大利語、俄語或西班牙語,反之亦然。以下是可以進行翻譯的語言對。
- 英譯漢和漢譯英
- 英語到法語和法語到英語
- 英語到德語和德語到英語
- 英語到意大利語和意大利語到英語
- 英語到俄語和俄語到英語
- 英語到西班牙語和西班牙語到英語
翻譯時,API 會處理段落、表格和標題。頁腳、腳註、尾註,甚至 Word 處理文檔的圖像標題。對於 Excel 電子表格,它支持單元格、圖表、表格以及數據透視表。
如何使用 REST API 翻譯 Word 或 Excel 文檔
本文將引導您了解使用 REST API 翻譯 Word 或 Excel 文檔的流程。以下是要遵循的步驟:
上傳文檔進行翻譯
使用 儀表板 或使用 API 的 Swagger UI 在雲存儲中上傳文件。我將向您展示如何使用這兩個選項在雲上上傳。
使用儀表板上傳文件
您可以使用儀表板直接將文檔上傳到雲端。您所需要的只是在服務器上創建一個帳戶。只需單擊“上傳文件”按鈕並選擇要上傳的文檔即可。
使用 Swagger UI 上傳文件
另一種選擇是使用 Swagger UI 從此 鏈接 上傳文檔進行翻譯。
以下是上傳成功後服務器的響應。
{
"uploaded": \[
"document.docx"
\],
"errors": \[\]
}
使用 REST API 將 Word 或 Excel 文檔翻譯成不同語言
簡單的 cURL 命令即可讓您翻譯上傳的文檔。在這裡,我將 Word 文檔從英語翻譯成法語。文件 document.docx 之前已上傳到 MyStorage 下的 myFolder 中。我打算將翻譯後的文檔另存為translatedDoc.docx 在同一文件夾(即myFolder)中。
curl -X POST "https://api.groupdocs.cloud/v1.0/translation/runTranslationTask" \\
-H "accept: application/json" \\
-H "authorization: Bearer TOKEN" \\
-H "Content-Type: application/json" \\
-H "x-aspose-client: Containerize.Swagger" \\
-d "'\[ { \\"format\\":\\"docx\\", \\"pair\\":\\"en-fr\\", \\"name\\":\\"document.docx\\", \\"folder\\":\\"myFolder\\", \\"savepath\\":\\"myFolder\\", \\"savefile\\":\\"translatedDoc.docx\\", \\"storage\\":\\"MyStorage\\" }\]'"
我想將一份文檔從英語翻譯成法語,所以我使用了“en-fr”。您可以根據需要從以下內容中使用相關對:
我使用“docx”作為文檔文件格式。您可以根據您的源Word文檔或Excel電子表格使用以下內容:
如果您想使用 API 參考的 Swagger UI 翻譯,您只需在翻譯請求中提供所需的值並執行命令即可。
無論您是從任何地方運行 cURL 命令還是使用 Swagger UI,無論哪種情況,以下都是成功翻譯後服務器的響應。翻譯後的文件將作為輸出存儲在上述文件夾中。
{
"error": "",
"status": "ok",
"message": "word file saved successfully"
}
下載翻譯文件
翻譯後的文檔可以輕鬆地從雲存儲下載。您可以使用以下 cURL 命令 Swagger UI,或使用儀表板下載文件。
使用 cURL 下載
curl -X GET "https://api.groupdocs.cloud/v1.0/translation/storage/file/myFolder%5CtranslatedDoc.docx?storageName=MyStorage&versionId=VsBZptoyKpehpqmUCsjuoA6jVBGsXk4B" \\
-H "accept: multipart/form-data" \\
-H "authorization: Bearer TOKEN" \\
-H "x-aspose-client: Containerize.Swagger"
使用 Swagger UI 下載
Swagger UI for download將為您提供翻譯後的下載鏈接。您可以單擊該鏈接並將文件保存在您想要的位置。
使用儀表板下載
儀表板 允許您選擇文件,然後您可以使用“下載”按鈕下載這些文件。