نحن نبحث اليوم في ترجمة REST API التي يمكنها ترجمة مستندات Word و Excel إلى لغات أخرى. باستخدام GroupDocs.Translation Cloud ، يمكن ترجمة أي مستند من الإنجليزية إلى الصينية أو الفرنسية أو الألمانية أو الإيطالية أو الروسية أو الإسبانية والعكس. إذن ، ها هي أزواج اللغات التي يمكن أن تتم الترجمة بها.
- من الإنجليزية إلى الصينية ومن الصينية إلى الإنجليزية
- الإنجليزية إلى الفرنسية والفرنسية إلى الإنجليزية
- من الإنجليزية إلى الألمانية ومن الألمانية إلى الإنجليزية
- الإنجليزية إلى الإيطالية والإيطالية إلى الإنجليزية
- من الإنجليزية إلى الروسية ومن الروسية إلى الإنجليزية
- من الإنجليزية إلى الإسبانية ومن الإسبانية إلى الإنجليزية
أثناء الترجمة ، تهتم API بالفقرات والجداول والعناوين. التذييلات والحواشي السفلية والتعليقات الختامية وحتى التسميات التوضيحية للصور لمستندات معالجة الكلمات الخاصة بك. بالنسبة لجداول بيانات Excel ، فهي تدعم الخلايا والمخططات والجداول وكذلك الجداول المحورية.
كيفية ترجمة مستند Word أو Excel باستخدام واجهة برمجة تطبيقات REST
ستوجهك هذه المقالة إلى التدفق لترجمة مستندات Word أو Excel باستخدام REST API. فيما يلي الخطوات التي يجب اتباعها:
تحميل المستند لترجمته
قم بتحميل ملفك على التخزين السحابي باستخدام لوحة القيادة أو باستخدام Swagger UI لواجهة برمجة التطبيقات. سأوضح لك كيفية التحميل على السحابة باستخدام كلا الخيارين.
قم بتحميل ملفك باستخدام لوحة التحكم
يمكنك تحميل المستند مباشرة على السحابة باستخدام لوحة القيادة. كل ما تحتاجه هو إنشاء حساب على الخادم. ما عليك سوى النقر فوق الزر تحميل ملف وتحديد المستند الذي تريد تحميله.
قم بتحميل ملفك باستخدام Swagger UI
الخيار الآخر هو استخدام Swagger UI لتحميل المستند الخاص بك للترجمة من هذا الرابط.
فيما يلي الاستجابة من الخادم بعد التحميل الناجح.
{
"uploaded": \[
"document.docx"
\],
"errors": \[\]
}
ترجمة مستندات Word أو Excel إلى لغات مختلفة باستخدام واجهة برمجة تطبيقات REST
سيسمح لك أمر cURL البسيط بترجمة المستند الذي تم تحميله. هنا أقوم بترجمة مستند Word من الإنجليزية إلى الفرنسية. تم تحميل الملف document.docx مسبقًا في myFolder ضمن MyStorage. أعتزم حفظ المستند المترجم كـ translDoc.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 وفقًا لمصدرك مما يلي:
إذا كنت ترغب في استخدام Swagger UI لمرجع API لـ ترجم ، يمكنك فقط تقديم القيم المطلوبة في طلب الترجمة وتنفيذ الأمر.
سواء قمت بتشغيل الأمر 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 رابط تنزيل التنزيل المترجم. يمكنك النقر فوق الارتباط وحفظ الملف في المكان الذي تريده.
قم بتنزيل المستند المترجم باستخدام Swagger UI
تنزيل باستخدام لوحة القيادة
تتيح لك لوحة القيادة تحديد الملف (الملفات) ومن ثم يمكنك تنزيلها باستخدام الزر تنزيل.
تنزيل باستخدام لوحة القيادة
يمكنك معرفة المزيد حول API من الوثائق أو Let’s talk more @ Free Support Forum.