إضافة شكل إلى ورقة عمل Excel باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud
تقوم هذه الواجهة البرمجية (REST API) بإضافة شكل إلى ورقة عمل Excel.
ينتمي نقطة النهاية إلى إصدار الواجهة البرمجية v3.0؛ لذا تأكد من استخدام رمز وصول JWT تم الحصول عليه عبر تدفق مصادقة Aspose Cloud OAuth2 (معرّف العميل/سر العميل)، وضمنه في الرأس Authorization: Bearer <token>.
الأمان والمصادقة
تتطلب واجهات برمجة تطبيقات Aspose.Cells Cloud أمانًا عاليًا وتستخدم مصادقة تعتمد على رمز JWT.
واجهة PutWorksheetShape برمجية
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/shapes
مَعلمات الطلب
| اسم المَعلمة | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم المستند. |
| sheetName | string | path | اسم ورقة العمل. |
| shapeDTO | object | body | كائن JSON يصف الشكل المراد إضافته (انظر مواصفة OpenAPI للحصول على المخطط الكامل). |
| drawingType | string | query | نوع كائن الشكل (مثل arc، line، rectangle). |
| upperLeftRow | integer | query | فهرس الصف العلوي الأيسر للشكل. |
| upperLeftColumn | integer | query | فهرس العمود العلوي الأيسر للشكل. |
| top | integer | query | الإزاحة العمودية للشكل من حافته العلوية، بوحدة البكسل. |
| left | integer | query | الإزاحة الأفقية للشكل من حافته اليسرى، بوحدة البكسل. |
| width | integer | query | عرض الشكل، بوحدة البكسل. |
| height | integer | query | ارتفاع الشكل، بوحدة البكسل. |
| folder | string | query | المجلد الذي يحتوي على المستند. |
| storageName | string | query | اسم وحدة التخزين. |
تُعرّف مواصفة OpenAPI واجهة برمجة تطبيقات متاحة عمومًا، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات ويب Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء استدعاء لواجهة البرمجة السحابية باستخدام cURL.
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | OK | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | Bad Request | مَعلمات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | Unauthorized | رمز JWT غير صالح أو مفقود. |
| 413 | Payload Too Large | حجم الملف المرفوع يتجاوز الحد المسموح به. |
| 500 | Internal Server Error | خطأ غير متوقع في الخادم. |
تتضمن الاستجابات الخاطئة الشائعة ما يلي:
- 400 Bad Request – مَعلمات مفقودة أو غير صالحة.
- 401 Unauthorized – رمز JWT غير صالح أو مفقود.
- 404 Not Found – ورقة العمل أو المستند المحدد غير موجود.
يُعاد كل خطأ على هيئة كائن JSON يحتوي على حقلَي Code و Message.
عائلة SDK السحابية
يُعد استخدام SDK أفضل طريقة لتسريع عملية التطوير، إذ تتعامل SDK مع التفاصيل منخفضة المستوى، مما يسمح لك بالتركيز على مهام مشروعك. يُرجى مراجعة مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام مكتبات SDK مختلفة: