ב-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 } }, ], }