오늘 우리는 Word 및 Excel 문서를 다른 언어로 번역할 수 있는 번역 REST API를 살펴봅니다. GroupDocs.Translation Cloud를 사용하면 모든 문서를 영어에서 중국어, 프랑스어, 독일어, 이탈리아어, 러시아어 또는 스페인어로 또는 그 반대로 번역할 수 있습니다. 번역이 가능한 언어 쌍은 다음과 같습니다.
- 영어에서 중국어로, 중국어에서 영어로
- 영어에서 프랑스어로, 프랑스어에서 영어로
- 영어에서 독일어로, 독일어에서 영어로
- 영어에서 이탈리아어로, 이탈리아어에서 영어로
- 영어에서 러시아어로, 러시아어에서 영어로
- 영어에서 스페인어로, 스페인어에서 영어로
번역하는 동안 API는 단락, 표, 헤더를 처리합니다. 워드 프로세싱 문서의 바닥글, 각주, 미주 및 이미지 캡션까지. Excel 스프레드시트의 경우 셀, 차트, 테이블 및 피벗 테이블을 지원합니다.
REST API로 Word 또는 Excel 문서를 번역하는 방법
이 문서는 REST API를 사용하여 Word 또는 Excel 문서를 번역하는 흐름을 안내합니다. 따라야 할 단계는 다음과 같습니다.
번역할 문서 업로드
dashboard 또는 API용 Swagger UI를 사용하여 클라우드 저장소에 파일을 업로드합니다. 두 옵션을 모두 사용하여 클라우드에 업로드하는 방법을 보여드리겠습니다.
대시보드를 사용하여 파일 업로드
대시보드를 사용하여 클라우드에 문서를 직접 업로드할 수 있습니다. 서버에 계정을 생성하기만 하면 됩니다. 파일 업로드 버튼을 클릭하고 업로드할 문서를 선택하기만 하면 됩니다.
Swagger UI를 사용하여 파일 업로드
다른 옵션은 Swagger UI를 사용하여 이 링크에서 번역할 문서를 업로드하는 것입니다.
다음은 성공적인 업로드 후 서버의 응답입니다.
{
"uploaded": \[
"document.docx"
\],
"errors": \[\]
}
REST API를 사용하여 Word 또는 Excel 문서를 다른 언어로 번역
간단한 cURL 명령으로 업로드한 문서를 번역할 수 있습니다. 여기에서는 Word 문서를 영어에서 프랑스어로 번역하고 있습니다. 파일 document.docx는 이전에 MyStorage 아래의 myFolder에 업로드되었습니다. 번역된 문서를 myFolder와 같은 동일한 폴더에 translateDoc.docx로 저장하려고 합니다.
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 스프레드시트에 따라 다음에서 사용할 수 있습니다.
translate에 대한 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는 번역된 다운로드의 다운로드 링크를 제공합니다. 링크를 클릭하고 원하는 위치에 파일을 저장할 수 있습니다.
Swagger UI를 사용하여 번역된 문서 다운로드
대시보드를 사용하여 다운로드
대시보드에서 파일을 선택한 다음 다운로드 버튼을 사용하여 다운로드할 수 있습니다.
대시보드를 사용하여 다운로드