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