تحديث عنوان المخطط في ورقة عمل إكسل – وثائق Aspose.Cells Cloud
يقوم هذا الـ REST API بتحديث عنوان المخطط.
المتطلبات الأساسية: يجب أن يكون لديك حساب Aspose Cloud ساري المفعول ورمز مميز JWT للتوثيق. تشمل الخطوات النموذجية ما يلي:
- التسجيل في حساب Aspose Cloud.
- إنشاء رمز مميز JWT عبر نقطة نهاية المصادقة.
- التأكد من تخزين ملف العمل المستهدف في تخزين سحابي مدعوم (افتراضي أو مخصص).
PostWorksheetChartTitle API
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}/title
يجب إجراء جميع استدعاءات API عبر بروتوكول HTTPS لتجنب تحذيرات المحتوى المختلط.
الأمان والمصادقة
تُعد واجهات برمجة التطبيقات (APIs) الخاصة بـ Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز مميز JWT.
معاملات الطلب
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم ملف العمل (Workbook). |
| sheetName | string | path | اسم ورقة العمل. |
| chartIndex | integer | path | الفهرس الصفري (zero-based) للمخطط. |
| title | string | body | العنوان الجديد للمخطط. |
| folder | string | query | مجلد ملف العمل. |
| storageName | string | query | اسم التخزين. |
رموز حالة الاستجابة
| الرمز | الوصف |
|---|---|
| 200 | نجاح العملية (OK) – تم تحديث عنوان المخطط بنجاح. |
| 400 | طلب غير صالح (Bad Request) – معاملات ناقصة أو غير صحيحة. |
| 401 | غير مخوّل (Unauthorized) – رمز مميز JWT غير صالح أو مفقود. |
| 404 | غير موجود (Not Found) – ملف العمل أو ورقة العمل أو المخطط غير موجود. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) – حالة غير متوقعة في الخادم. |
ملاحظة: الفهرس chartIndex يبدأ من الصفر (zero-based)، ويُشار إلى أول مخطط في ورقة العمل بالرقم 0.
مواصفات OpenAPI تُعرّف واجهة برمجة تطبيقات قابلة للوصول العام وتتيح لك إجراء تفاعلات REST مباشرة من خلال متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب الخاصة بـ Aspose.Cells. يوضح المثال التالي كيفية إجراء استدعاءات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
مجموعة أدوات SDK السحابية
استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. فتتولى مجموعة SDK إدارة التفاصيل منخفضة المستوى وتركّز أنت على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية إجراء استدعاءات إلى خدمات الويب الخاصة بـ Aspose.Cells باستخدام SDKs متنوعة: