نسخ نطاق في ورقة عمل مع خيارات اللصق – Aspose.Cells Cloud API

تقوم هذه واجهة برمجة تطبيقات REST بنسخ نطاق في ورقة عمل من ملف عمل Excel. وللحصول على العمليات ذات الصلة، راجع وثائق الحصول على النطاق وتحديث النطاق.

المتطلبات المسبقة: لاستخدام هذه النقطة النهائية، يجب أن يكون لديك رمز OAuth 2.0 / JWT صالح، وأن تضمن توافق إصدار واجهة برمجة التطبيقات مع عنوان URL للطلب.

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

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

مُعاملات الطلب

اسم المُعامل	النوع	الموقع	الوصف
name	string	path	اسم ملف العمل.
sheetName	string	path	اسم ورقة العمل.
rangeOperate	string	body	العملية المراد تنفيذها: `copydata`، `copystyle`، `copyto`، أو `copyvalue`.
folder	string	query	المجلد الذي يحتوي على ملف العمل.
storageName	string	query	اسم خدمة التخزين.

ملاحظات: يحدد الحقل rangeOperate ما سيتم نسخه. استخدم copydata لنسخ قيم الخلايا فقط، وcopystyle للتنسيق، وcopyto لكل من البيانات والتنسيق، وcopyvalue لنسخ القيم دون الصيغ. تدعم واجهة برمجة التطبيقات النطاقات التي تصل إلى مليون خلية؛ وقد تؤدي النطاقات الأكبر إلى حدوث انتهاء للمهلة الزمنية.

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

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

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/ranges" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "Operate": "string",
        "Source": {
          "ColumnCount": 0,
          "ColumnWidth": 0,
          "FirstColumn": 0,
          "FirstRow": 0,
          "Name": "string",
          "RefersTo": "string",
          "RowCount": 0,
          "RowHeight": 0,
          "Worksheet": "string"
        },
        "Target": {
          "ColumnCount": 0,
          "ColumnWidth": 0,
          "FirstColumn": 0,
          "FirstRow": 0,
          "Name": "string",
          "RefersTo": "string",
          "RowCount": 0,
          "RowHeight": 0,
          "Worksheet": "string"
        },
        "PasteOptions": {
          "OnlyVisibleCells": true,
          "PasteType": "string",
          "SkipBlanks": true,
          "Transpose": true
        }
      }'

الاستجابة

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

تعيد الاستجابة الناجحة حالة 200 OK. وفي حالة حدوث خطأ، قد تُعيد واجهة برمجة التطبيقات أحمال مثل:

{
  "Code": 400,
  "Message": "Bad Request – مُعلمات غير صالحة."
}

أو

{
  "Code": 401,
  "Message": "Unauthorized – رمز المصادقة مفقود أو غير صالح."
}

تتضمن كائنات الخطأ هذه رمز حالة HTTP ورسالة وصفية تساعد في تشخيص المشكلات.

يمكنك تنزيل ملف عمل تجريبي لاختبار عملية النسخ من هنا.

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

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

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