عمليات الصفوف والأعمدة

تتيح لك Google Sheets API إضافة الصفوف والأعمدة وإزالتها ومعالجتها في وأوراق البيانات. توضح الأمثلة في هذه الصفحة كيف أن بعض الصفوف والأعمدة الشائعة العمليات باستخدام Sheets API.

يتم تقديم هذه الأمثلة في شكل طلبات HTTP لتكون اللغة محايدة. لمعرفة كيفية تنفيذ تحديث مجمّع بلغات مختلفة باستخدام مكتبات عملاء واجهة Google API، راجع تحديث جداول البيانات.

في هذه الأمثلة، العنصران النائبان SPREADSHEET_ID وSHEET_ID يشير إلى مكان تقديم أرقام التعريف هذه. يمكنك العثور على جدول البيانات 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 ما إذا كانت العملية تنطبق على الأعمدة أو صفوف الورقة.

إذا كانت القيمة هي true، يخبر الحقل inheritFromBefore واجهة برمجة التطبيقات Sheets API بتقديم الأعمدة الجديدة أو الصفوف التي لها نفس الخصائص مثل الصف أو العمود السابق وإذا كان خطأ، ليتم اكتسابه من السمات بعد الأعمدة أو الصفوف الجديدة. لا يمكن أن يكون 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
      }
    },
  ],
}