كيفية حذف جميع الصور في ورقة عمل Excel باستخدام Aspose.Cells Cloud

يقوم هذا الـ REST API بحذف جميع الصور في ورقة عمل.

المتطلبات المسبقة

حساب نشط على Aspose.Cells Cloud مع رمز وصول OAuth 2.0 ساري المفعول.
يتطلب إصدار API 3.0 (أو أحدث)، أما الإصدارات الأقدم فهي مُهمَلة.
يجب تخزين ملف Excel المستهدف في موقع تخزين مدعوم (افتراضي أو مخصص).

توافق الإصدار
يتبع هذا الـ endpoint مواصفات Cells Cloud 3.0 API. تأكد من أن مكتبات العميل وعناوين URL للطلبات تستهدف api.aspose.cloud/v3.0.

DeleteWorksheetPictures API

DELETE https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pictures

الأمان والمصادقة

تُعدّ واجهات برمجة التطبيقات Aspose.Cells Cloud آمنة وتحتاج إلى مصادقة تعتمد على رمز JWT.

معلمات الطلب

اسم المعلمة	النوع	الموقع	الوصف
name	string	Path	اسم ملف Excel.
sheetName	string	Path	اسم ورقة العمل التي تحتوي على الصور.
folder	string	Query	المجلد الذي يُخزَّن فيه الملف.
storageName	string	Query	اسم خدمة التخزين.

استجابات الخطأ

رمز HTTP	الوصف
401	غير مُصادَق – نقصان أو عدم صلاحية الرمز.
404	غير موجود – الملف أو ورقة العمل أو فهرس كسر الصفحة المحددة غير موجود.
400	طلب غير صالح – تركيب جملة الطلب أو المعلمات غير صحيحة.
500	خطأ داخلي في الخادم – تم مواجهة شرط غير متوقع.

تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول العام وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells بسهولة. يوضح المثال التالي كيفية استدعاء الـ API باستخدام cURL.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/{fileName}/worksheets/{sheetName}/pictures" \
  -X DELETE \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Response

{
  "Code": 200,
  "Status": "OK"
}

عائلة SDK للسحابة

استخدام SDK هو أسرع طريقة للتطوير. يتعامل الـ SDK مع التفاصيل منخفضة المستوى، مما يتيح لك التركيز على منطق أعمالك. راجع مستودع GitHub للحصول على قائمة كاملة بـ SDKs لـ Aspose.Cells Cloud.

تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر SDKs مختلفة:

ملاحظات: لا يدعم إجراء DELETE الترقيم (pagination)، ويخضع لقيود معدل الطلبات القياسية لـ Aspose.Cells Cloud API (افتراضيًا 100 طلب في الدقيقة). قم بتعديل منطق العميل وفقًا لذلك.

انظر أيضًا:

/pictures/delete/ – حذف صورة محددة من ورقة عمل.
/pictures/add/ – إضافة صورة إلى ورقة عمل.

حذف صورة من ورقة عمل Excel – واجهة Aspose.Cells Cloud API تحديث صورة في ملف Excel