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

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

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

בדוגמאות האלה, ערכי ה-placeholder 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 קובע אם הפעולה חלה על העמודות או על השורות בגיליון.

אם הערך הוא 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
      }
    },
  ],
}