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