تحديث أسلوب خلايا متعددة – مرجع واجهة برمجة تطبيقات Aspose.Cells Cloud (الإصدار 3.0)
واجهة برمجة تطبيقات REST
تقوم هذه واجهة برمجة تطبيقات REST بضبط النمط لمجموعة من الخلايا في ملف عمل إكسل.
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/style
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتحتاج إلى مصادقة باستخدام رمز مميز JWT.
مُعلَمات الطلب
| اسم المُعلَمة | النوع | الموقع | الوصف |
|---|---|---|---|
| name | نص (string) | المسار (path) | اسم ملف العمل. |
| sheetName | نص (string) | المسار (path) | اسم ورقة العمل. |
| range | نص (string) | الاستعلام (query) | نطاق الخلايا (مثل A1:A10). |
| style | كائن (object) | الجسم (body) | كائن JSON يُعرّف النمط المراد تطبيقه. |
| folder | نص (string) | الاستعلام (query) | المجلد الذي يحتوي على ملف العمل. |
| storageName | نص (string) | الاستعلام (query) | اسم وحدة التخزين. |
كائن النمط (Style object)
يمثّل كائن JSON style تنسيق الخلايا، وقد يحتوي على أيٍّ من الخصائص الاختيارية التالية:
- Font – إعدادات الخط (
Name،Size،IsBold،IsItalic،Color، إلخ). - BackgroundColor – لون الخلفية بصيغة ARGB.
- ForegroundColor – لون المقدّمة بصيغة ARGB.
- Name، CultureCustom، Custom – بيانات تعريف إضافية للنمط.
الاستجابة
ترجع كائن CellCloudResponse.
- نظرة عامة على حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
Status |
نص (string) | |
Code |
عدد صحيح (integer) | 200، 400، 401، 500، … |
{
"Status":"OK",
"Code":200
}
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم تطبيق المرشّح بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | مُعلَمات ناقصة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مُصادَق (Unauthorized) | رمز مُتَوَسِّط JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا (Payload Too Large) | حجم الملف المرفّع يتجاوز الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة برمجة تطبيقات PostUpdateWorksheetRangeStyle مع حزم تطوير البرمجيات (SDKs)
مواصفات واجهة برمجة تطبيقات PostUpdateWorksheetRangeStyle
توفّر مواصفات OpenAPI المخطط الكامل.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells السحابية. يُظهر المثال التالي كيفية إجراء مكالمات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام حزم تطوير البرمجيات (SDKs) الخاصة بـ Aspose.Cells Cloud
استخدام حزمة تطوير البرمجيات (SDK) هو أفضل طريقة لتسريع عملية التطوير، إذ تقوم SDK بمعالجة التفاصيل الدقيقة منخفضة المستوى، مما يتيح لك التركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بحزم تطوير البرمجيات الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells باستخدام حزم تطوير البرمجيات المختلفة: