Documentation

title: “العمل مع صفوف ملفات إكسل – واجهة Aspose.Cells Cloud API” ArticleTitle: “العمل مع صفوف ملفات إكسل – واجهة Aspose.Cells Cloud API” second_title: “مستند” linktype: “docs” url: /rows/ aliases: [/working-with-rows/] keywords: “Aspose.Cells, صفوف إكسل, واجهة REST API, تعديل جداول البيانات” description: “قم بتعديل الصفوف في ملفات إكسل باستخدام واجهة Aspose.Cells Cloud REST API. يدعم منصات أندرويد، C#، Go، Java، Node.js، Perl، PHP، Python، Ruby، و Swift.” weight: 100

آخر تحديث: يوليو 2026

مرجع سريع لواجهة API للعمليات الشائعة على الصفوف:

العملية	طريقة HTTP	نقطة النهاية	المعلمات الرئيسية
الحصول على صف	GET	`/cells/{fileName}/worksheets/{sheetName}/rows/{rowIndex}`	`fileName`, `sheetName`, `rowIndex`
إضافة صف	POST	`/cells/{fileName}/worksheets/{sheetName}/rows`	`rowIndex`, `height`
نسخ الصفوف	POST	`/cells/{fileName}/worksheets/{sheetName}/rows/copy`	`sourceIndex`, `destinationIndex`, `rowCount`
حذف صف	DELETE	`/cells/{fileName}/worksheets/{sheetName}/rows/{rowIndex}`	`fileName`, `sheetName`, `rowIndex`
إخفاء الصفوف	POST	`/cells/{fileName}/worksheets/{sheetName}/rows/hide`	`startIndex`, `endIndex`
إظهار الصفوف المخفية	POST	`/cells/{fileName}/worksheets/{sheetName}/rows/unhide`	`startIndex`, `endIndex`
تجميع الصفوف	POST	`/cells/{fileName}/worksheets/{sheetName}/rows/group`	`startIndex`, `endIndex`
إلغاء تجميع الصفوف	POST	`/cells/{fileName}/worksheets/{sheetName}/rows/ungroup`	`startIndex`, `endIndex`

تفاصيل الطلب والاستجابة

الحصول على صف
الطلب: لا يوجد محتوى مطلوب.
الاستجابة (200):
```
{
  "RowIndex": 5,
  "Height": 15.0,
  "IsHidden": false,
  "Style": { ... }
}
```
الأخطاء: 400 Bad Request (مؤشر غير صالح)، 404 Not Found (ملف أو ورقة مفقودة).
إضافة صف
محتوى الطلب (JSON):
```
{
  "RowIndex": 10,
  "Height": 20.0
}
```
الاستجابة (201):
```
{ "Code": "Success", "Status": "Row added", "RowIndex": 10 }
```
الأخطاء: 400 Bad Request (معلمات مفقودة أو غير صالحة)، 401 Unauthorized.

نسخ الصفوف
محتوى الطلب (JSON):

{
  "SourceIndex": 2,
  "DestinationIndex": 8,
  "RowCount": 3
}

الاستجابة (200):

{ "Code": "Success", "Status": "Rows copied" }

الأخطاء: 400 Bad Request، 404 Not Found.

حذف صف
الطلب: لا يوجد محتوى.
الاستجابة (200):
```
{ "Code": "Success", "Status": "Row deleted", "RowIndex": 7 }
```
الأخطاء: 400 Bad Request، 404 Not Found.
إخفاء الصفوف
محتوى الطلب (JSON):
```
{ "StartIndex": 3, "EndIndex": 5 }
```
الاستجابة (200): { "Code": "Success", "Status": "Rows hidden" }
الأخطاء: 400 Bad Request.
إظهار الصفوف المخفية – نفس محتوى الطلب مثل إخفاء الصفوف؛ الاستجابة متماثلة، والحالة تكون “Rows unhidden”.
تجميع الصفوف – نفس محتوى الطلب مثل إخفاء الصفوف؛ حالة الاستجابة تكون “Rows grouped”.
إلغاء تجميع الصفوف – نفس محتوى الطلب مثل إخفاء الصفوف؛ حالة الاستجابة تكون “Rows ungrouped”.

تتطلب جميع العمليات رمز وصول ساري لبروتوكول OAuth 2.0/JWT وإصدارًا مناسبًا من مكتبة SDK.