今天我们正在研究翻译 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将为您提供翻译后的下载链接。您可以单击该链接并将文件保存在您想要的位置。
使用仪表板下载
仪表板 允许您选择文件,然后您可以使用“下载”按钮下载这些文件。