Dzisiaj przyjrzymy się interfejsowi API REST tłumaczenia, który może tłumaczyć dokumenty Word i Excel na inne języki. Dzięki GroupDocs.Translation Cloud każdy dokument można przetłumaczyć z angielskiego na chiński, francuski, niemiecki, włoski, rosyjski lub hiszpański i odwrotnie. Oto pary językowe, w których można wykonać tłumaczenie.
- Z angielskiego na chiński iz chińskiego na angielski
- z angielskiego na francuski iz francuskiego na angielski
- Z angielskiego na niemiecki iz niemieckiego na angielski
- z angielskiego na włoski i z włoskiego na angielski
- Angielski na rosyjski i rosyjski na angielski
- Z angielskiego na hiszpański iz hiszpańskiego na angielski
Podczas tłumaczenia API dba o akapity, tabele, nagłówki. stopki, przypisy dolne, przypisy końcowe, a nawet podpisy obrazów w dokumentach edytora Word. W przypadku arkuszy kalkulacyjnych Excel obsługuje komórki, wykresy, tabele, a także tabele przestawne.
Jak przetłumaczyć dokument Worda lub Excela za pomocą REST API
Ten artykuł przeprowadzi Cię przez proces tłumaczenia dokumentów programu Word lub Excel przy użyciu interfejsu API REST. Oto kroki, które należy wykonać:
- Prześlij dokument do przetłumaczenia
- Przetłumacz dokument na różne języki
- Pobierz przetłumaczony dokument
Prześlij dokument do przetłumaczenia
Prześlij swój plik do magazynu w chmurze za pomocą pulpitu nawigacyjnego lub Swagger UI dla interfejsu API. Pokażę ci, jak przesłać do chmury, korzystając z obu opcji.
Prześlij plik za pomocą Dashboard
Możesz bezpośrednio przesłać swój dokument do Chmury za pomocą pulpitu nawigacyjnego. Wystarczy założyć konto na serwerze. Po prostu kliknij przycisk Prześlij plik i wybierz dokument do przesłania.
Prześlij swój plik za pomocą interfejsu Swagger
Inną opcją jest użycie interfejsu użytkownika Swagger do przesłania dokumentu do tłumaczenia z tego link.
Poniżej znajduje się odpowiedź serwera po pomyślnym przesłaniu.
{
"uploaded": \[
"document.docx"
\],
"errors": \[\]
}
Tłumacz dokumenty Word lub Excel na różne języki za pomocą REST API
Proste polecenie cURL pozwoli Ci przetłumaczyć przesłany dokument. Tutaj tłumaczę dokument programu Word z angielskiego na francuski. Plik document.docx został przesłany wcześniej do myFolder w obszarze MyStorage. Zamierzam zapisać przetłumaczony dokument jako translateDoc.docx w tym samym folderze, tj. 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\\" }\]'"
Chciałem przetłumaczyć dokument z angielskiego na francuski, więc użyłem tej pary jako „en-fr”. Możesz użyć odpowiedniej pary w zależności od potrzeb spośród następujących:
Użyłem „docx” dla formatu pliku dokumentu. Możesz użyć zgodnie ze swoim źródłowym dokumentem Word lub arkuszem kalkulacyjnym Excel z następujących:
Jeśli chcesz użyć Swagger UI odwołania API do translate, możesz po prostu podać wymagane wartości w żądaniu tłumaczenia i wykonać polecenie.
Niezależnie od tego, czy uruchomiłeś polecenie cURL z dowolnego miejsca, czy korzystasz z interfejsu użytkownika Swagger, w obu przypadkach po pomyślnym przetłumaczeniu pojawi się odpowiedź serwera. Przetłumaczony plik zostanie zapisany we wspomnianym folderze jako plik wyjściowy.
{
"error": "",
"status": "ok",
"message": "word file saved successfully"
}
Pobierz przetłumaczony dokument
Przetłumaczony dokument można łatwo pobrać z magazynu w chmurze. Możesz użyć następującego polecenia cURL, Swagger UI lub użyć pulpitu nawigacyjnego, aby pobrać plik.
Pobierz za pomocą 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"
Pobierz za pomocą interfejsu Swagger
Swagger UI do pobrania dostarczy Ci link do pobrania przetłumaczonego pliku do pobrania. Możesz kliknąć łącze i zapisać plik w żądanej lokalizacji.
Pobierz za pomocą pulpitu nawigacyjnego
Dashboard umożliwia wybranie plików, a następnie pobranie ich za pomocą przycisku Pobierz.
Możesz dowiedzieć się więcej o interfejsie API z dokumentacji lub Porozmawiajmy więcej na Bezpłatne forum pomocy.