בנוסף לנתוני הערכים שמופיעים בתאים, גיליון אלקטרוני כולל סוגים רבים אחרים של נתונים, כמו:
- מידות
- פורמטים וגבולות של תאים
- טווחי תאים בעלי שם
- טווחי תאים מוגנים
- עיצוב מותנה
אלה חלק מסוגי הנתונים הרבים ששולטים במראה ובתפעול של גיליון אלקטרוני. השיטה spreadsheets.batchUpdate
מאפשרת לעדכן את כל הפרטים האלה של הגיליון האלקטרוני. השינויים מקובצים בקבוצה, כך שאם בקשה אחת נכשלת, אף אחד מהשינויים האחרים (שעשויים להיות תלויים) לא נכתב.
בדף הזה נסביר את העקרונות הבסיסיים של השימוש ב-method spreadsheets.batchUpdate
. אם אתם צריכים לקרוא ולכתוב נתונים של ערכי תאים, תוכלו להשתמש גם במשאב spreadsheets.values
שמתואר בקטע קריאה וכתיבה של ערכי תאים.
קטגוריות של פעולות
אפשר לקבץ את הפעולות הספציפיות שנתמכות ב-spreadsheets.batchUpdate
לקטגוריות הרחבות הבאות:
קטגוריה | תיאור |
---|---|
הוספה (ושכפול) | הוספת אובייקטים חדשים (לפעמים על סמך אובייקטים ישנים, כמו בבקשות כפולות). |
עדכון (והגדרה) | עדכון מאפיינים מסוימים של אובייקט, בדרך כלל בלי לשנות את המאפיינים הישנים (בעוד שבקשת Set מחליפה את הנתונים הקודמים). |
מחיקה | הסרת אובייקטים. |
הקטגוריות האלה משמשות בקטע הבא לתיאור ההתנהגות של פעולות ספציפיות.
פעולות של עדכון באצווה
כדי להשתמש בשיטה spreadsheets.batchUpdate
, צריך להעביר אובייקט Request אחד או יותר, שבו מצוין סוג בקשה יחיד שרוצים לבצע. יש הרבה סוגים שונים של בקשות. לפניכם פירוט של סוגי הבקשות, שמקובצים בקטגוריות שונות.
יש גם בקשות נוספות שמחקות פעולות של משתמשים כדי לבצע מניפולציות על נתונים:
- AutoFillRequest
- CutPasteRequest
- CopyPasteRequest
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
מגבלות
מידע נוסף על מגבלות של תאים ושורות ב-Google Sheets זמין במאמר קבצים שאפשר לאחסן ב-Google Drive.
מסכות שדות
בחלק גדול מהבקשות מסוג 'עדכון' נדרשות מסכות שדות. זוהי רשימה של שדות מופרדים בפסיקים, שבה מעדכנים רק שדות מסוימים באובייקט בלי לשנות את השדות האחרים. מסכת שדה עם הערך *
מטופלת כתו כללי ביטוי, והיא קיצור דרך לציון כל השדות בהודעה (כלומר, שדה עשוי לחזור למצב ברירת המחדל אם לא מציינים לו ערך בבקשה).
מידע נוסף על מסכות שדות זמין במאמר שימוש במסכות שדות.
בדוגמה הבאה משתמשים בפקודה UpdateSpreadsheetPropertiesRequest
כדי לעדכן רק את השם של גיליון אלקטרוני:
בקשה:
POST .../v4/spreadsheets/spreadsheetId:batchUpdate
גוף הבקשה:
{
"requests": [{
"updateSpreadsheetProperties": {
"properties": {"title": "TITLE"},
"fields": "title"
}
}]
}
מחליפים את TITLE בשם החדש של הגיליון האלקטרוני.
תשובות
כשמעדכנים גיליון אלקטרוני, יכול להיות שחלק מסוגי הבקשות יחזירו תשובות. התשובות מוחזרות במערך, וכל תשובה תופסת את אותו אינדקס כמו הבקשה המתאימה. לחלק מהבקשות אין תשובות, והתשובה שלהן ריקה.
בדרך כלל, לבקשות 'הוספה' יש תשובות שמחזירות מידע כמו המזהה של האובייקט שנוסף. ברשימת התשובות הנתמכות מפורטות התשובות שאפשר לשלוח. תוכלו למצוא אותה בקטע תשובות.
דוגמה
דוגמת הקוד הבאה מבצעת את הפעולות הבאות:
- עדכון השם של הגיליון האלקטרוני באמצעות המשתנה
title
. - הפונקציה מחפשת ומחליפה ערכים של תאים בגיליון האלקטרוני באמצעות המשתנים
find
ו-replacement
.