إضافة صورة إلى ورقة عمل Excel – واجهة Aspose.Cells Cloud API
تقوم هذه الواجهة (REST API) بإضافة صورة جديدة إلى ورقة عمل Excel.
المتطلبات الأساسية: يجب أن تمتلك رمز مصادقة Aspose Cloud صالحًا، وكتاب عمل موجود مسبقًا مخزنًا في وحدة تخزين مدعومة، وامتلاك الصلاحيات المناسبة لتعديل ورقة العمل.
PutWorksheetAddPicture API
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pictures
الأمان والمصادقة
واجهات Aspose.Cells Cloud API آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معاملات الطلب
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم كتاب العمل. |
| sheetName | string | path | اسم ورقة العمل. |
| picture | object | body | كائن الصورة (البيانات الثنائية). |
| upperLeftRow | integer | query | الفهرس الصفري (Zero-based) للصف العلوي الأيسر حيث سيتم وضع الصورة. |
| upperLeftColumn | integer | query | الفهرس الصفري للعمود الأيسر الأعلى حيث سيتم وضع الصورة. |
| lowerRightRow | integer | query | الفهرس الصفري للصف السفلي الأيمن لمنطقة الصورة. |
| lowerRightColumn | integer | query | الفهرس الصفري للعمود الأيمن السفلي لمنطقة الصورة. |
| picturePath | string | query | مسار ملف الصورة؛ وفي حال حذفه، يجب توفير بيانات الصورة في جسم الطلب. |
| folder | string | query | المجلد الذي يحتوي على كتاب العمل. |
| storageName | string | query | اسم خدمة التخزين. |
ملاحظة حول جسم الطلب: عند حذف picturePath، أرسل بيانات الصورة الثنائية في جسم الطلب باستخدام multipart/form-data.
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | نجاح (OK) | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معاملات ناقصة أو غير صالحة (مثل: نوع ملف غير مدعوم). |
| 401 | غير مُصدَّق (Unauthorized) | رمز JWT غير صالح أو ناقص. |
| 413 | حجم البيانات كبير جدًا (Payload Too Large) | تجاوز ملف التحميل الحد الأقصى المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
مثال لمخطط الاستجابة 200
{
"Code": 200,
"Status": "OK",
"PictureUrl": "https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pictures/1"
}
ملاحظة: الحد الأقصى لحجم الصورة هو 10 ميغابايت؛ سيتم رفض الملفات الأكبر مع استجابة 400 Bad Request.
يُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للوصول، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يُظهر المثال التالي كيفية إجراء المكالمات إلى واجهة Cloud API باستخدام cURL.
عائلة SDK السحابية
استخدام SDK يُعد أفضل طريقة لتسريع عملية التطوير. فتتولى SDK تفاصيل المستوى المنخفض، مما يمكّنك من التركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة التعليمات البرمجية التالية كيفية إجراء المكالمات إلى خدمات Aspose.Cells عبر واجهة الويب باستخدام SDKs مختلفة:
ملاحظة: تشمل تنسيقات الصور المدعومة PNG وJPEG وBMP وGIF. الحد الأقصى لحجم الصورة هو 10 ميغابايت؛ سيتم رفض الملفات الأكبر مع استجابة 400 Bad Request.