استرجاع كائن OLE من ورقة عمل Excel – واجهة برمجة تطبيقات Aspose.Cells Cloud
Contents
[
Hide
]
تقوم هذه الواجهة البرمجية لواجهة الويب (REST API) باسترجاع كائن OLE من ورقة عمل Excel.
الأمان والمصادقة
تُعد واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتشترط المصادقة باستخدام رمز JWT.
واجهة REST
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/oleobjects/{objectNumber}?format={format}
معلمات الطلب
| اسم المعلمة | النوع | الموقع | الوصف |
|---|---|---|---|
| name | نص (string) | المسار | اسم المستند. |
| sheetName | نص (string) | المسار | اسم ورقة العمل. |
| objectNumber | عدد صحيح (integer) | المسار | رقم الكائن داخل ورقة العمل. |
| format | نص (string) | استعلام | تنسيق التصدير المرغوب للكائن (مثل: png, jpeg). |
| folder | نص (string) | استعلام | المجلد الذي يحتوي على المستند. |
| storageName | نص (string) | استعلام | اسم وحدة التخزين المراد استخدامها. |
خيارات وحدة التخزين
- folder – يُحدد المجلد الفرعي داخل وحدة التخزين الافتراضية حيث يكمن ملف العمل.
- storageName – يُتجاوز اسم وحدة التخزين الافتراضية إذا كان ملف العمل محفوظًا في مكان آخر.
يُعرّف مواصفات OpenAPI واجهة برمجة قابلة للوصول العام، وتمكّنك من إجراء تفاعلات REST مباشرة من خلال متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL لاستدعاء خدمة الويب Aspose.Cells. يوضح المثال التالي كيفية طلب كائن OLE كصورة PNG.
استجابات الأخطاء
| حالة HTTP | رمز الخطأ | الوصف |
|---|---|---|
| 400 | BadRequest | معلمات مفقودة أو غير صالحة. |
| 401 | Unauthorized | رمز JWT غير صالح أو مفقود. |
| 404 | NotFound | لم يتم العثور على ملف العمل أو ورقة العمل أو كائن OLE. |
| 500 | ServerError | خطأ غير متوقع في الخادم. |
مثال على استجابة الخطأ 404
{
"Code": 404,
"Status": "NotFound",
"Message": "لم يتم العثور على كائن OLE المطلوب برقم 0 في ورقة العمل 'Sheet1'."
}
عائلة SDK للسحابة
استخدام SDK هو أسرع طريقة لدمج الواجهة البرمجية. تُدار التفاصيل من المستوى المنخفض بواسطة SDKs، ما يتيح لك التركيز على منطق عملك. راجع مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام SDKs مختلفة: