الحصول على الخلايا المدمجة من ورقة عمل Excel – واجهة برمجة تطبيقات Aspose.Cells Cloud
تُعيد هذه الواجهة البرمجية لمخدمات REST معلومات حول الخلايا المدمجة في ورقة عمل Excel.
ملاحظة – يُسمى كائن الواجهة البرمجية MergedCell (مفرد). أما في النصوص التفسيرية فنُشير إلى المفهوم العام للخلايا المدمجة (جمع).
واجهة برمجة التطبيقات (REST API)
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/mergedCells
الأمان والمصادقة
تتطلب واجهات برمجة تطبيقات Aspose.Cells Cloud مصادقةً مبنية على رمز JWT، وهي آمنة.
معاملات الطلب
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | نص (string) | المسار (path) | اسم ملف Excel. |
| sheetName | نص (string) | المسار (path) | اسم ورقة العمل. |
| folder | نص (string) | الاستعلام (query) | المجلد الذي يحتوي على المستند. |
| storageName | نص (string) | الاستعلام (query) | اسم وحدة التخزين المراد استخدامها. |
الاستجابة
ترجع استجابة من نوع MergedCellsResponse.
{
"Status":"OK",
"Code":200,
"MergedCells":{
"Count": 0,
"MergedCellList":[
{
"Link":{
"Href":"",
"Rel":"",
"Type":"",
"Title":""
}
}
]
}
}
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | نجاح (OK) | تمت تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معاملات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مخوّل (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة GetWorksheetMergedCells مع مكتبات SDK
مواصفات واجهة GetWorksheetMergedCells
تعرّف مواصفات OpenAPI على واجهة برمجة تطبيقات عامة قابلة للاستدعاء وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب الخاصة بـ Aspose.Cells. يوضح المثال التالي كيفية إجراء استدعاء إلى واجهة برمجة تطبيقات السحابة باستخدام cURL.
استخدام مكتبات SDK الخاصة بـ Aspose.Cells Cloud
يُعد استخدام مكتبات SDK أسرع طريقة لتطوير التطبيقات مقابل الواجهة البرمجية. فتتولى المكتبات معالجة التفاصيل منخفضة المستوى، مما يسمح لك بالتركيز على منطق عملك. راجع مستودع GitHub للحصول على قائمة كاملة بمكتبات SDK الخاصة بـ Aspose.Cells Cloud.
تعرض أمثلة الكود التالية كيفية استدعاء خدمات الويب الخاصة بـ Aspose.Cells باستخدام مكتبات SDK مختلفة: