إضافة صورة خلفية إلى دفتر عمل
واجهة برمجة التطبيقات REST
تقوم هذه واجهة برمجة التطبيقات REST بإضافة صورة خلفية إلى دفتر عمل Excel.
POST https://api.aspose.cloud/v3.0/cells/{name}/background
الأمان والمصادقة
واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتحتاج إلى مصادقة تعتمد على رمز JWT.
معاملات الاستعلام
| اسم المعامل | النوع | الوصف |
|---|---|---|
picPath |
نص | مسار ملف الصورة المراد استخدامه كخلفية. |
folder |
نص | المجلد الذي يحتوي على دفتر العمل الأصلي. |
storageName |
نص | اسم وحدة التخزين التي يوجد فيها الملف. |
معامل جسم الطلب
| اسم المعامل | النوع | الوصف |
|---|---|---|
datafile |
ملف | ملف دفتر العمل الذي سيتم تطبيق الخلفية عليه. |
معامل المسار – {name} في عنوان URL يمثل اسم ملف دفتر العمل (مثلًا: Book1.xlsx).
الاستجابة
{
"Status" : "OK",
"Code" : 200
}
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح | تمت عملية تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح | معاملات مفقودة أو غير صحيحة (مثلًا: نوع ملف غير مدعوم). |
| 401 | غير مصرّح به | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا | يتجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة PutWorkbookBackground API باستخدام حزم تطويرات البرمجيات (SDKs)
مواصفات واجهة PutWorkbookBackground API
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للوصول تتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells عبر الويب بسهولة. يُظهر المثال التالي طلبًا كاملًا، بما في ذلك علامة تحميل الملف متعدد الأجزاء (multipart file upload) ورأس المصادقة المطلوب.
استخدام حزم تطويرات Aspose.Cells Cloud SDKs
استخدام حزمة تطوير البرمجيات (SDK) هو أسرع طريقة للتطوير. فحزمة SDK تُجرّدك من التفاصيل منخفضة المستوى، ما يسمح لك بالتركيز على منطق أعمالك. راجع مستودع GitHub للحصول على قائمة كاملة بحزم تطويرات Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر حزم تطويرات مختلفة: