تحديث خصائص الرسم البياني – Aspose.Cells Cloud REST API
تقوم هذه الـ REST API بتحديث خصائص الرسم البياني.
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
واجهة PostWorksheetChart API
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}
معاملات الطلب
| اسم المعاملة | النوع | المسار/سلسلة الاستعلام/جسم الطلب | الوصف |
|---|---|---|---|
| name | string | path | اسم ملف Excel. |
| sheetName | string | path | اسم ورقة العمل التي يحتوي عليها الرسم البياني. |
| chartIndex | integer | path | المؤشر صفر-الأساسي للرسم البياني المراد تحديثه. |
| chart | object | body | كائن JSON يُعرّف خصائص الرسم البياني التي يجب تعديلها. |
| folder | string | query | المجلد في التخزين حيث يوجد الملف. |
| storageName | string | query | اسم خدمة التخزين. |
مخطط جسم الطلب
يحتوي كائن chart على الخصائص التي يمكنك تعديلها. فيما يلي مثال تمثيلي بتنسيق JSON يشمل عدة حقول شائعة الاستخدام:
{
"Title": {
"Text": "المبيعات الفصلية"
},
"ShowLegend": true,
"Type": "Line",
"DataLabels": {
"ShowValue": true,
"ShowPercentage": false
},
"ChartArea": {
"BorderColor": "Blue",
"FillColor": "White"
}
}
ملاحظة: يجب تزويد الحقول التي تحتاج فقط إلى تغييرها. تحتفظ الخصائص المُهملة بقيمها الحالية.
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة علنًا وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات ويب Aspose.Cells. يُظهر المثال التالي كيفية إجراء المكالمات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
الاستجابة
ترجع الواجهة كائن JSON يُشير إلى نتيجة العملية. وتُظهر التحديثات الناجحة ما يلي:
{
"Code": 200,
"Status": "OK"
}
رموز حالة النجاح
| حالة HTTP | الوصف |
|---|---|
| 200 | OK – تم تحديث خصائص الرسم البياني بنجاح. |
رؤوس الاستجابة
| الرأس | الوصف |
|---|---|
Content-Type |
application/json – يشير إلى أن جسم الاستجابة مُنسّق بتنسيق JSON. |
X-RequestId |
مُعرّف فريد للطلب (مفيد في حل المشاكل). |
تشمل استجابات الخطأ المحتملة ما يلي:
| حالة HTTP | الوصف |
|---|---|
| 400 | Bad Request – معاملات أو جسم غير صالح. |
| 401 | Unauthorized – رمز مفقود أو غير صالح. |
| 404 | Not Found – ملف أو ورقة عمل أو رسم بياني غير موجود. |
| 500 | Internal Server Error |
للحصول على عمليات أخرى مرتبطة بالرسوم البيانية، راجع المواضيع ذات الصلة مثل تحديث عنوان الرسم البياني وتحديث أسطورة الرسم البياني.
عائلة SDK السحابية
استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. يعتني SDK بالتفاصيل منخفضة المستوى ويسمح لك بالتركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية إجراء مكالمات إلى خدمات ويب Aspose.Cells باستخدام SDKs مختلفة: