واجهة برمجة تطبيقات Aspose.Cells Cloud – الحصول على MaxDataColumn من ورقة عمل إكسل (الإصدار 3.0)

تُعيد هذه الواجهة برمجة التطبيقات (REST API) أقصى فهرس لعمود يحتوي على بيانات في ورقة عمل إكسل عندما يُعيّن المعامل cellOrMethodName إلى القيمة maxdatacolumn.

مثال باستخدام cURL

تفاصيل الطلب

  • طريقة HTTP: GET
  • نمط نقطة النهاية (Endpoint): https://api.aspose.com/v3.0/cells/{fileName}/worksheets/{sheetName}/cells/maxdatacolumn
  • المعاملات المسار (Path Parameters):
    • fileName – اسم ملف إكسل (مثلًا: myWorkbook.xlsx).
    • sheetName – اسم ورقة العمل (مثلًا: Sheet1).
  • الرؤوس (Headers):
    • Authorization: Bearer <access_token> (إلزامي)
    • Accept: application/json (مستحسن)

المعاملات

اسم المعامل الموقع النوع الإلزامية الوصف
fileName في المسار نص (string) نعم اسم ملف إكسل المخزّن في مساحة التخزين السحابية.
sheetName في المسار نص (string) نعم ورقة العمل التي سيتم استرجاع أقصى عمود يحتوي بيانات منها.
cellOrMethodName في المسار نص (string) نعم يجب تعيينها إلى maxdatacolumn لاستدعاء هذه العملية.

الاستجابات

رمز الحالة الوصف محتوى الاستجابة (Payload)
200 نجاح – يُعيد فهرس أقصى عمود يحتوي بيانات. { "MaxDataColumn": 12 }
401 غير مصرّح – رمز وصول غير صالح أو مفقود. { "error": "Invalid authentication." }
404 غير موجود – الملف أو ورقة العمل غير موجودين. { "error": "Resource not found." }
500 خطأ داخلي في الخادم – حالة غير متوقعة. { "error": "Server error." }

معالجة الأخطاء
في حال فشل الطلب، راجع رمز الحالة (HTTP Status Code) والرسالة error في جسم الاستجابة. تأكّد من أن رمز الوصول (access token) ساري المفعول، وأن الملف وورقة العمل المحدّدان موجودان في مساحة التخزين السحابية الخاصة بحساب Aspose Cloud.

  • استخدام حزم تطوير البرامج (SDKs) الخاصة بـ Aspose.Cells Cloud

استخدام حزمة تطوير البرامج (SDK) هو أكثر الطرق كفاءةً لتسريع عملية التطوير، إذ تتعامل الحزمة مع التفاصيل منخفضة المستوى، ما يتيح لك التركيز على مهام مشروعك. يُرجى زيارة مستودع GitHub للاطّلاع على قائمة كاملة بحزم تطوير البرامج (SDKs) الخاصة بـ Aspose.Cells Cloud.

توضّح أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام حزم تطوير برامج مختلفة:

الحصول على MaxColumn من ورقة عمل Excel استرجاع MinRow من ورقة عمل Excel – مرجع واجهة برمجة تطبيقات Aspose.Cells Cloud