الحصول على منطقة المخطط من ورقة عمل - واجهة برمجة تطبيقات Aspose.Cells Cloud
تُعيد هذه الواجهة REST معلومات منطقة المخطط.
المتطلبات المسبقة: لاستدعاء هذه النقطة النهائية (endpoint)، يجب أن يكون لديك رمز وصول JWT صالح، ويجب تحميل الملف المطلوب (workbook) مسبقًا إلى مساحة التخزين في Aspose Cloud، ويجب أن يكون تنسيق الملف مدعومًا من قبل Aspose.Cells.
الخلفية: تُعرّف منطقة المخطط (chart area) الصندوق المحيط الخارجي لأكبر مخطط في Excel، وتشمل العناوين والأساطير (legends) ومنطقة الرسم (plot area). يسمح استرداد خصائصها لك بتعديل التخطيط والتنسيق برمجيًا.
واجهة برمجة التطبيقات GetChartArea
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}/chartArea
الأمان والمصادقة
تُقدّم واجهات برمجة التطبيقات (APIs) الخاصة بـ Aspose.Cells Cloud واجهة آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معاملات الطلب
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم ملف المصنف (workbook). |
| sheetName | string | path | اسم ورقة العمل التي تحتوي على المخطط. |
| chartIndex | integer | path | الفهرس الصفري (zero-based) للمخطط. |
| folder | string | query | المجلد الذي يحتوي على المصنف. |
| storageName | string | query | اسم خدمة التخزين. |
الاستجابة
{
"ChartArea": {
"Area": {
"BackgroundColor": { "A": "0", "R": "0", "G": "0", "B": "0" },
"FillFormat": { "Type": "Automatic" },
"ForegroundColor": { "A": "0", "R": "0", "G": "0", "B": "0" },
"Formatting": "Automatic",
"InvertIfNegative": false,
"Transparency": 0.0
},
"AutoScaleFont": false,
"BackgroundMode": "Automatic",
"Border": {
"BeginArrowLength": "Medium",
"BeginArrowWidth": "Medium",
"BeginType": "None",
"CapType": "Flat",
"Color": { "A": "0", "R": "0", "G": "0", "B": "0" },
"CompoundType": "Single",
"DashType": "Solid",
"EndArrowLength": "Medium",
"EndArrowWidth": "Medium",
"EndType": "None",
"IsAuto": false,
"IsAutomaticColor": false,
"IsVisible": false,
"JoinType": "Round",
"Style": "Solid",
"Transparency": 0.0,
"Weight": "HairLine",
"WeightPt": 0.0
},
"Font": {
"Color": { "A": "255", "R": "0", "G": "0", "B": "0" },
"DoubleSize": 10.0,
"IsBold": false,
"IsItalic": false,
"IsStrikeout": false,
"IsSubscript": false,
"IsSuperscript": false,
"Name": "Arial",
"Size": 10,
"Underline": "None"
},
"IsAutomaticSize": false,
"IsInnerMode": false,
"Shadow": false,
"Width": 0,
"Height": 0,
"X": 0,
"Y": 0,
"link": {
"Href": "https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/worksheets/Sheet5/charts/0/chartArea",
"Rel": "self"
}
},
"Code": "200",
"Status": "OK"
}
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | OK (نجاح) | تطبيق المرشّح بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | Bad Request (طلب غير صالح) | معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | Unauthorized (غير مُصادَق) | رمز JWT غير صالح أو مفقود. |
| 413 | Payload Too Large (حمولة كبيرة جدًا) | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | Internal Server Error (خطأ داخلي في الخادم) | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة برمجة التطبيقات GetChartArea باستخدام SDKs
مواصفات واجهة برمجة التطبيقات GetChartArea
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للاستعمال، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات الويب الخاصة بـ Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء طلب إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
يُعد استخدام SDKs أفضل طريقة لتسريع عملية التطوير. فتتولى SDKs التعامل مع التفاصيل منخفضة المستوى، ما يتيح لك التركيز على مهام مشروعك. يُرجى مراجعة مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام مكتبات SDK مختلفة:
طلب HTTP عام (مثل استخدام fetch):
fetch('https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/worksheets/Sheet5/charts/0/chartArea', {
method: 'GET',
headers: {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer <jwt token>'
}
})
.then(response => response.json())
.then(data => console.log(data));