تحويل ملف Excel إلى PPTX باستخدام واجهة Aspose.Cells Cloud API الإصدار 3.0
تقوم هذه الواجهة البرمجية REST بتحويل ملف جدول بيانات إلى تنسيق PPTX.
واجهة PostConvertWorkbookToPptx
POST https://api.aspose.cloud/v3.0/cells/convert/pptx
الأمان والمصادقة
واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتحتاج إلى مصادقة تعتمد على رمز JWT.
معاملات الاستعلام
| اسم المعامل | النوع | الوصف |
|---|---|---|
password |
string | كلمة المرور المطلوبة لفتح كتاب عمل Excel. |
storageName |
string | اسم وحدة التخزين التي يقع فيها الملف المصدر. |
checkExcelRestriction |
bool | يُشير إلى ما إذا كان سيتم تطبيق قيود ملف Excel عند تعديل الكائنات المرتبطة بالخلية. |
معامل نص الطلب
| اسم المعامل | النوع | الوصف |
|---|---|---|
datafile |
ملف بيانات | ملف Excel المُضمَّن في الجزء الأول من نص الطلب متعدد الأجزاء. |
مثال على نص طلب متعدد الأجزاء (مبسَّط):
--boundary
Content-Disposition: form-data; name="File"; filename="input.xlsx"
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
<المحتوى الثنائي لملف input.xlsx>
--boundary
Content-Disposition: form-data; name="password"
MyPwd
--boundary--
الاستجابة
ترجع الواجهة البرمجية كائن FileInfo يحتوي على ملف pptx المُولَّد.
| الحقل | النوع | الوصف |
|---|---|---|
| Filename | string | اسم ملف pptx (مثل example.pptx). |
| FileSize | int | حجم الملف بالبايت. |
| FileContent | string | محتوى ملف pptx مشفرًا بترميز Base64. |
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم تطبيق المرشّح بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصادق عليه (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حمل البيانات كبير جدًا (Payload Too Large) | حجم الملف المرفَق يتجاوز الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقَّع في الخادم. |
ملاحظات: تدعم نقطة النهاية التنسيقات الشائعة لملفات Excel (.xlsx، .xls، .xlsm). يقتصر الحد الأقصى لحجم الملف على 50 ميغابايت. قد تُقيَّد عملية التحويل لكتب العمل التي تحتوي على ماكرو أو أوراق محمية ما لم تُزوَّد المعاملات المناسبة.
كيفية استخدام واجهة PostConvertWorkbookToPptx باستخدام مكتبات SDK
مواصفات واجهة PostConvertWorkbookToPptx
تُعرِّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة علنًا وتسمح لك بإجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells بسهولة. يُظهر المثال التالي كيفية استدعاء واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام مكتبات SDK الخاصة بـ Aspose.Cells Cloud
استخدام مكتبة SDK هو أسرع طريقة لتطوير التطبيقات. فتُجرِّدك المكتبة من تفاصيل البرمجة منخفضة المستوى لتتمكن من التركيز على مشروعك. راجع [مستودع GitHub](https://github.com/aspose-cells-cloud" rel=“noopener noreferrer”) للحصول على قائمة كاملة بمكتبات SDK الخاصة بـ Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells باستخدام مكتبات SDK المختلفة:
واجهات برمجة تطبيقات أخرى تنفّذ هذه الوظيفة
- POST /cells/convert/pdf – تحويل ملف Excel إلى PDF.
- POST /cells/convert/png – تحويل ملف Excel إلى صور PNG.
- POST /cells/convert/svg – تحويل ملف Excel إلى تنسيق SVG.