Bugün, Word ve Excel belgelerini diğer dillere çevirebilen çeviri REST API’sini inceliyoruz. GroupDocs.Translation Cloud ile herhangi bir belge İngilizceden Çinceye, Fransızcaya, Almancaya, İtalyancaya, Rusçaya veya İspanyolcaya veya tam tersine çevrilebilir. İşte çevirinin yapılabileceği dil çiftleri.
- İngilizceden Çinceye & Çinceden İngilizceye
- İngilizceden Fransızcaya & Fransızcadan İngilizceye
- İngilizceden Almancaya ve Almancadan İngilizceye
- İngilizceden İtalyancaya ve İtalyancadan İngilizceye
- İngilizceden Rusçaya & Rusçadan İngilizceye
- İngilizceden İspanyolcaya ve İspanyolcadan İngilizceye
Çeviri yaparken API paragrafları, tabloları ve başlıkları halleder. Kelime işlem belgelerinizin altbilgileri, dipnotları, son notları ve hatta resim altyazıları. Excel elektronik tabloları için hücreleri, çizelgeleri, tabloları ve ayrıca pivot tabloları destekler.
REST API ile Word veya Excel Belgesini Çevirme
Bu makale, REST API’sini kullanarak Word veya Excel belgelerini çevirme akışına yönlendirecektir. İzlenecek adımlar şunlardır:
Belgeyi Çevirmek İçin Yükle
Gösterge panosu veya API için Swagger UI kullanarak dosyanızı bulut depolama alanına yükleyin. Size her iki seçeneği de kullanarak Buluta nasıl yükleme yapacağınızı göstereceğim.
Dashboard’u kullanarak dosyanızı yükleyin
Gösterge panosunu kullanarak belgenizi doğrudan Buluta yükleyebilirsiniz. Tek ihtiyacınız olan sunucuda bir hesap oluşturmak. Dosya Yükle düğmesine tıklayın ve yüklenecek belgenizi seçin.
Dosyanızı Swagger UI kullanarak yükleyin
Diğer seçenek, belgenizi bu bağlantıdan çevrilmek üzere karşıya yüklemek için Swagger kullanıcı arayüzünü kullanmaktır.
Başarılı yüklemeden sonra sunucudan gelen yanıt aşağıda olacaktır.
{
"uploaded": \[
"document.docx"
\],
"errors": \[\]
}
REST API ile Word veya Excel Belgelerini Farklı Dillere Çevirin
Basit cURL komutu, yüklenen belgenizi çevirmenizi sağlar. Burada Word belgesini İngilizce’den Fransızca’ya çeviriyorum. Document.docx dosyası daha önce MyStorage altındaki myFolder’a yüklendi. Çevrilen belgeyi aynı klasörde, yani myFolder’da translateDoc.docx olarak kaydetmeyi düşünüyorum.
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\\" }\]'"
Bir belgeyi İngilizceden Fransızcaya çevirmek istedim, bu yüzden çifti “en-fr” olarak kullandım. Aşağıdakilerden ihtiyacınıza göre ilgili çifti kullanabilirsiniz:
Belge dosyası formatı için “docx” kullandım. Aşağıdakilerden kaynak Word belgenize veya Excel elektronik tablonuza göre kullanabilirsiniz:
translate API referansının Swagger kullanıcı arayüzünü kullanmak istiyorsanız, sadece çeviri talebinde gerekli değerleri sağlayabilir ve komutu çalıştırabilirsiniz.
CURL komutunu herhangi bir yerden çalıştırmış veya Swagger UI kullanmış olsanız da, her iki durumda da başarılı çeviriden sonra sunucudan gelecek yanıt aşağıdaki gibidir. Çevrilen dosya çıktı olarak belirtilen klasörde saklanacaktır.
{
"error": "",
"status": "ok",
"message": "word file saved successfully"
}
Çevrilmiş Belgeyi İndirin
Çevrilen belge, Bulut depolama alanından kolayca indirilebilir. Dosyayı indirmek için aşağıdaki cURL komutunu, Swagger UI veya kontrol panelini kullanabilirsiniz.
cURL ile indir
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 kullanıcı arayüzünü kullanarak indirin
İndirme için Swagger UI size çevrilmiş indirmenin indirme bağlantısını sağlayacaktır. Bağlantıya tıklayıp dosyayı istediğiniz yere kaydedebilirsiniz.
Dashboard’u kullanarak indir
Gösterge panosu dosya(lar)ı seçmenize izin verir ve ardından İndir düğmesini kullanarak bunları indirebilirsiniz.
API hakkında daha fazla bilgiyi belgelerden veya Let’s talk more @ Ücretsiz Destek Forumu sayfasından öğrenebilirsiniz.