פעולות של שורות ועמודות

באמצעות Google Sheets API אפשר להוסיף שורות ועמודות, להסיר אותם ולערוך אותם. גיליונות אלקטרוניים. הדוגמאות בדף הזה ממחישות כיצד שורות ועמודות נפוצות ניתן לבצע פעולות שונות באמצעות ה-API של Sheets.

הדוגמאות האלה מוצגות בצורה של בקשות HTTP ניטרלי. כדי ללמוד איך להטמיע עדכון בכמות גדולה בשפות שונות באמצעות על ספריות הלקוח של Google API, ראו עדכון גיליונות אלקטרוניים.

בדוגמאות האלה, ערכי ה-placeholders 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 לספק לעמודות או לשורות החדשות אותם מאפיינים כמו בשורה או בעמודה הקודמת, False, לקבל בירושה מהמאפיינים אחרי העמודות או השורות החדשות. הערך inheritFromBefore לא יכול להיות True אם מוסיפים שורה בשורה 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
      }
    },
  ],
}