تحديث خصائص ورقة العمل – مرجع واجهة برمجة تطبيقات Aspose.Cells Cloud (الإصدار 3.0)
تقوم هذه الواجهة البرمجية لواجهة الويب (REST API) بتحديث الخصائص الأساسية لورقة العمل.
واجهة برمجة تطبيقات REST
المتطلبات المسبقة: يجب أن يكون لديك حساب Aspose Cloud ساري المفعول، والحصول على رمز وصول JWT، وضمان تخزين ملف المصنف المستهدف في موقع تخزين مدعوم. ويجب أن تُرسل جميع الطلبات عبر بروتوكول HTTPS.
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}
معلمات الطلب
| اسم المعلمة | النوع | المسار / سلسلة الاستعلام / جسم HTTP | الوصف |
|---|---|---|---|
| name | string | path | اسم ملف المصنف (مع امتداده). |
| sheetName | string | path | اسم ورقة العمل التي سيتم تحديثها. |
| sheet | object | body | كائن JSON يحتوي على أزواج (مفتاح/قيمة) لخصائص ورقة العمل (مثل DisplayZeros، IsRulerVisible). |
| folder | string | query | مسار المجلد داخل مساحة التخزين حيث يوجد المصنف. |
| storageName | string | query | اسم مساحة التخزين المراد استخدامها. |
يُرسل كائن sheet في جسم الطلب بصيغة JSON. وتتضمن الخصائص التي يمكن تعديلها على سبيل المثال: DisplayZeros، IsRulerVisible، IsGridlinesVisible، وغير ذلك من الخصائص المُعرّفة في مواصفات الواجهة البرمجية.
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول العام، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells عبر الويب بسهولة. يوضح المثال التالي كيفية إجراء استدعاءات لواجهة برمجة التطبيقات السحابية باستخدام cURL.
رموز الاستجابة الشائعة:
- 200 – نجاح. تم تحديث خصائص ورقة العمل بنجاح.
- 400 – طلب غير صالح (مثل JSON معطّل أو معلمة مطلوبة مفقودة).
- 401 – غير مصرّح به – رمز JWT مفقود أو غير صالح.
- 404 – المصنف أو ورقة العمل غير موجودين.
- 500 – خطأ داخلي في الخادم.
| الرمز | المعنى |
|---|---|
| 200 | نجاح – تم تحديث خصائص ورقة العمل. |
| 400 | طلب غير صالح – JSON معطّل أو معلمة مطلوبة مفقودة. |
| 401 | غير مصرّح به – رمز JWT مفقود أو غير صالح. |
| 404 | غير موجود – المصنف أو ورقة العمل غير موجودين. |
| 500 | خطأ داخلي في الخادم. |
مجموعة أدوات تطوير البرمجيات (SDK) السحابية
استخدام إطار عمل SDK هو أسرع طريقة لتسريع عملية التطوير، حيث يتعامل إطار العمل مع التفاصيل منخفضة المستوى، مما يمكّنك من التركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر الأمثلة التالية كيفية إجراء استدعاءات لخدمات الويب Aspose.Cells باستخدام SDKs مختلفة: