الحصول على جميع الصور في ورقة عمل Excel - واجهة برمجة تطبيقات Aspose.Cells Cloud

تسترجع هذه واجهة برمجة التطبيقات REST جميع معلومات الصور من ورقة عمل Excel.

المتطلبات الأساسية
قبل استدعاء هذه النقطة النهائية، تأكد من وجود ما يلي:

رمز وصول JWT صالح لـ Aspose Cloud.
تحميل ملف Excel المستهدف إلى مساحة التخزين المحددة.
اسم مساحة التخزين الصحيح (في حال استخدام مساحة تخزين مخصصة).
اسم ورقة العمل التي تحتوي على الصور.

واجهة برمجة التطبيقات GetWorksheetPictures

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

ملاحظة: استخدم بروتوكول HTTPS (TLS 1.2 أو إصدار أحدث) عند استدعاء واجهة برمجة التطبيقات، وقم بتضمين رمز JWT صالح في رأس Authorization.

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

تُعد واجهات برمجة تطبيقات 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 عبر الويب. يوضح المثال التالي كيفية إجراء المكالمات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet2/pictures" \
-X GET \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

الاستجابة

{
  "Pictures": {
    "PictureList": [
      {
        "link": {
          "Href": "/0",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "link": {
          "Href": "/1",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "link": {
          "Href": "/2",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      }
    ],
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet2/pictures",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

استجابة ناجحة – تُعيّد المكالمة الناجحة رمز HTTP 200 مع حُملة JSON تحتوي على كائن Pictures يسرد رابط المورد لكل صورة.

عائلة وحدات تطوير البرمجي السحابية

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

توضح أمثلة الكود التالية كيفية إجراء المكالمات إلى خدمات Aspose.Cells عبر الويب باستخدام مختلف وحدات التطوير البرمجي:

يمكنك تنزيل وحدات التطوير البرمجي مباشرةً من مديري الحزم الخاصة بها (مثل NuGet لـ .NET، وMaven Central لـ Java، وComposer لـ PHP، وnpm لـ Node.js، وPyPI لـ Python، وCPAN لـ Perl، وGo modules لـ Go).

انظر أيضًا: إضافة صورة، حذف صورة، تحديث خصائص الصورة.

إضافة صورة إلى ملف Excel