ضبط إعدادات الصفحة لورقة عمل – دليل API السحابي Aspose.Cells

متطلبات مسبقة: لاستدعاء هذه الواجهة البرمجية، يجب أن تمتلك رمز JWT (OAuth) صالحًا، كما يجب أن يكون الملف المصنف موجودًا في مساحة تخزين Aspose Cloud التي تمتلك صلاحيات القراءة والكتابة فيها. تأكد من تضمين الرمز في رأس Authorization، وأن حسابك يتمتع بحد كافٍ من الطلب المسموح به لواجهة API.

تقوم هذه الواجهة البرمجية REST بضبط إعدادات الصفحة لورقة عمل Excel.

واجهة برمجة تطبيقات REST (REST API)

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pagesetup

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

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

معلمات الطلب

اسم المعلمة	النوع	الموقع	الوصف
name	string	path	اسم المستند.
sheetName	string	path	اسم ورقة العمل.
pageSetup	object	body	وصف إعدادات الصفحة.
folder	string	query	مجلد المستند.
storageName	string	query	اسم مساحة التخزين.

مثال على حمولة JSON لموضوع pageSetup

{
  "pageSetup": {
    "orientation": "Portrait",
    "paperSize": "A4",
    "fitToPagesTall": 1,
    "fitToPagesWide": 1,
    "centerHorizontally": true,
    "centerVertically": false
  }
}

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

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

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/myWorkbook.xlsx/worksheets/Tasks/pagesetup" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>" \
-d '{
  "pageSetup": {
    "orientation": "Portrait",
    "paperSize": "A4",
    "fitToPagesTall": 1,
    "fitToPagesWide": 1,
    "centerHorizontally": true,
    "centerVertically": false
  }
}'

الاستجابة

تعيد واجهة API كائن JSON يُظهر نتيجة العملية:

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

رموز حالات الاستجابة المحتملة

الكود	المعنى	الحالة
200	OK (تم بنجاح)	تم تحديث إعدادات الصفحة بنجاح
400	Bad Request (طلب غير صالح)	حمولة JSON غير صالحة أو حقول مطلوبة مفقودة
401	Unauthorized (غير مصرّح)	رمز JWT مفقود أو غير صالح
404	Not Found (غير موجود)	اسم الملف المصنف أو ورقة العمل غير موجود
500	Internal Server Error (خطأ داخلي في الخادم)	فشل غير متوقع في الخادم

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

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

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