تتيح لك Google Sheets API إضافة الصفوف والأعمدة وإزالتها ومعالجتها في أوراق البيانات. توضح الأمثلة الواردة في هذه الصفحة كيف يمكن تحقيق بعض عمليات الصفوف والأعمدة الشائعة باستخدام Sheets API.
ويتم تقديم هذه الأمثلة في شكل طلبات HTTP لتكون محايدة لغة. للتعرّف على كيفية تنفيذ تحديث مجمّع بلغات مختلفة باستخدام مكتبات برامج واجهة Google API، اطّلِع على تحديث جداول البيانات.
في هذه الأمثلة، يشير العنصران النائبان SPREADSHEET_ID وSHEET_ID
إلى مكان توفير هذه المعرّفات. يمكنك العثور على رقم تعريف جدول البيانات في عنوان URL لجدول البيانات. يمكنك الحصول على معرّف الورقة باستخدام الإجراء spreadsheets.get. ويتم تحديد النطاقات باستخدام تدوين A1. مثال على
النطاق Sheet1!A1:D5.
ضبط عرض العمود أو ارتفاع الصف
يوضّح نموذج التعليمات البرمجية spreadsheets.batchUpdate التالي كيفية استخدام UpdateDimensionPropertiesRequest لتعديل سمة العرض في العمود A إلى 160 بكسل. يحدّث الطلب الثاني خاصية ارتفاع الصف
للصفوف الثلاثة الأولى لتكون 40 بكسل. ويحدّد الحقل dimension ما إذا كانت العملية تنطبق على الأعمدة أو الصفوف في ورقة بيانات.
في ما يلي بروتوكول الطلب.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"updateDimensionProperties": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 1
},
"properties": {
"pixelSize": 160
},
"fields": "pixelSize"
}
},
{
"updateDimensionProperties": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
},
"properties": {
"pixelSize": 40
},
"fields": "pixelSize"
}
}
]
}
إلحاق صفوف أو أعمدة فارغة
يوضح نموذج التعليمات البرمجية spreadsheets.batchUpdate التالي كيفية استخدام AppendDimensionRequest لإلحاق الصفوف والأعمدة. يُلحق الطلب الأول ثلاثة صفوف فارغة بنهاية الورقة، بينما يلحق الثاني بعمود واحد فارغ. ويحدّد الحقل dimension ما إذا كانت العملية تنطبق على الأعمدة أو الصفوف في ورقة بيانات.
في ما يلي بروتوكول الطلب.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"appendDimension": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"length": 3
}
},
{
"appendDimension": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"length": 1
}
}
]
}
تغيير حجم العمود تلقائيًا
يوضّح نموذج التعليمات البرمجية spreadsheets.batchUpdate التالي كيفية استخدام AutoResizeDimensionsRequest لتغيير حجم الأعمدة A:C، بناءً على حجم محتوى العمود. يشير الحقل dimension إلى أنّ العملية تنطبق على أعمدة الورقة.
في ما يلي بروتوكول الطلب.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}
تغيير حجم صف تلقائيًا
يوضّح نموذج التعليمات البرمجية spreadsheets.batchUpdate التالي كيفية استخدام AutoResizeDimensionsRequest لمحو ارتفاع الصفوف من الصفوف الثلاثة الأولى. ثم يزداد ارتفاع الصفوف ديناميكيًا
بناءً على محتوى الخلايا في كل صف. يشير الحقل dimension إلى أنّ العملية تنطبق على صفوف ورقة البيانات.
في ما يلي بروتوكول الطلب.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}
حذف صفوف أو أعمدة
يوضّح نموذج التعليمات البرمجية spreadsheets.batchUpdate التالي كيفية استخدام DeleteDimensionRequest لحذف أول ثلاثة صفوف في ورقة البيانات. يحذف طلب ثانٍ الأعمدة B:D.
يحدد الحقل dimension ما إذا كان سيتم تطبيق العملية على الأعمدة أو الصفوف في ورقة البيانات.
في ما يلي بروتوكول الطلب.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"deleteDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
}
}
},
{
"deleteDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 1,
"endIndex": 4
}
}
},
],
}
إدراج صف أو عمود فارغ
يوضّح نموذج التعليمات البرمجية spreadsheets.batchUpdate التالي كيفية استخدام InsertDimensionRequest لإدراج أعمدة أو صفوف في فهرس معيّن (مثل إضافة صفوف فارغة في أعلى الورقة). يدرج الطلب الأول عمودين فارغين في العمود C.
يدرج طلب ثانٍ ثلاثة صفوف فارغة تبدأ من الصف 1.
يحدد الحقل dimension ما إذا كان سيتم تطبيق العملية على الأعمدة أو الصفوف في ورقة البيانات.
إذا كانت القيمة "صحيح"، يطلب الحقل inheritFromBefore من "واجهة برمجة التطبيقات لجداول بيانات Google" منح
الأعمدة أو الصفوف الجديدة الخصائص نفسها للصف أو العمود السابق، وإذا كانت القيمة
خطأ، سيتم اكتساب السمات من السمات بعد الأعمدة أو الصفوف الجديدة.
لا يمكن أن يكون inheritFromBefore صحيحًا في حال إدراج صف في الصف 1 أو عمود في
العمود A.
في ما يلي بروتوكول الطلب.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"insertDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 2,
"endIndex": 4
},
"inheritFromBefore": true
}
},
{
"insertDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
},
"inheritFromBefore": false
}
},
],
}
نقل صف أو عمود
يوضح نموذج التعليمات البرمجية spreadsheets.batchUpdate التالي كيفية استخدام
MoveDimensionRequest
لنقل العمود A إلى العمود D. ينقل الطلب الثاني الصفوف من 5 إلى 10
إلى موضع الصف 20.
يحدد الحقل dimension ما إذا كان سيتم تطبيق العملية على الأعمدة أو الصفوف في ورقة البيانات. ويحدِّد الحقل destinationIndex مكان نقل بيانات المصدر باستخدام فهرس بدء يستند إلى صفر.
في ما يلي بروتوكول الطلب.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"moveDimension": {
"source": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 1
},
"destinationIndex": 3
}
},
{
"moveDimension": {
"source": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 4,
"endIndex": 10
},
"destinationIndex": 19
}
},
],
}