تحديث صورة في ملف Excel باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud REST API
تقوم هذه الواجهة البرمجية REST بتحديث صورة مُعرَّفة بفهرسها في ورقة عمل Excel.
المتطلبات المسبقة: يجب أن تمتلك رمز JWT صالحًا من Aspose Cloud، وملف Excel المستهدف المخزّن في مساحة التخزين الخاصة بك في Aspose Cloud، واستخدام إصدار API 3.0 أو أحدث.
واجهة برمجة تطبيقات PostWorksheetPicture
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pictures/{pictureIndex}
الأمان والمصادقة
تتطلب واجهات برمجة تطبيقات Aspose.Cells Cloud مصادقة مبنية على رمز JWT token لضمان الأمان.
مُعاملات الطلب
| اسم المُعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم مستند Excel. |
| sheetName | string | path | اسم ورقة العمل التي تحتوي على الصورة. |
| pictureIndex | integer | path | الفهرس بصيغة صفرية (zero‑based) للصورة المراد تحديثها. |
| picture | object | body | كائن JSON يصف خصائص الصورة المراد تحديثها. |
| folder | string | query | المجلد الذي يُخزّن فيه المستند. |
| storageName | string | query | اسم خدمة التخزين. |
ملاحظة: الفهرس بصيغة صفرية (zero‑based). تنسيقات الصور المدعومة تشمل JPEG وPNG وBMP وGIF. أقصى حجم للصورة هو 10 ميغا بايت.
استجابات الأخطاء
| كود HTTP | الوصف |
|---|---|
| 401 | غير مصرّح – رمز مفقود أو غير صالح. |
| 404 | غير موجود – الملف أو ورقة العمل أو فهرس الصورة المحددة غير موجودة. |
| 400 | طلب غير صالح – بنية الطلب مشوّهة أو المُعاملات غير صالحة. |
| 500 | خطأ داخلي في الخادم – حدثت حالة غير متوقعة. |
يُعرّف مواصفات OpenAPI واجهة برمجة قابلة للوصول العام، ويتيح لك إجراء تفاعلات REST مباشرة من متصفّح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء استدعاء إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
عائلة SDK السحابية
استخدام SDK هو أسرع طريقة للتطوير. فتتولى SDK معالجة التفاصيل من المستوى المنخفض، مما يسمح لك بالتركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells باستخدام مكتبات SDK متنوعة:
انظر أيضًا: إضافة صورة، حذف صورة، جلب صورة، مسح الصور – عمليات أخرى مرتبطة بالصور في واجهة برمجة تطبيقات Aspose.Cells Cloud.