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