הגדרת ערכים בטווח אחד או יותר של גיליון אלקטרוני. מבצע הקריאה החוזרת חייב לציין את מזהה הגיליון האלקטרוני, valueInputOption
ו-ValueRanges
אחד או יותר.
בקשת HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdate
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
spreadsheetId |
מזהה הגיליון האלקטרוני שיש לעדכן. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "valueInputOption": enum ( |
שדות | |
---|---|
valueInputOption |
האופן שבו יש לפרש את נתוני הקלט. |
data[] |
הערכים החדשים שיחולו על הגיליון האלקטרוני. |
includeValuesInResponse |
המדיניות הזו קובעת אם התגובה לעדכון צריכה לכלול את הערכים של התאים שעודכנו. כברירת מחדל, התשובות לא כוללות את הערכים המעודכנים. השדה |
responseValueRenderOption |
קביעת אופן העיבוד של הערכים בתשובה. אפשרות ברירת המחדל לעיבוד היא |
responseDateTimeRenderOption |
קובע את אופן העיבוד של תאריכים, שעות ומשכי זמן בתגובה. המערכת תתעלם מהמאפיין הזה אם הערך של |
גוף התשובה
התגובה כשמעדכנים טווח ערכים בגיליון אלקטרוני.
אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"spreadsheetId": string,
"totalUpdatedRows": integer,
"totalUpdatedColumns": integer,
"totalUpdatedCells": integer,
"totalUpdatedSheets": integer,
"responses": [
{
object ( |
שדות | |
---|---|
spreadsheetId |
הגיליון האלקטרוני שעליו בוצעו העדכונים. |
totalUpdatedRows |
המספר הכולל של השורות שבהן עודכן לפחות תא אחד בשורה. |
totalUpdatedColumns |
המספר הכולל של העמודות שבהן עודכן לפחות תא אחד בעמודה. |
totalUpdatedCells |
המספר הכולל של התאים שעודכנו. |
totalUpdatedSheets |
המספר הכולל של גיליונות שבהם עודכן לפחות תא אחד בגיליון. |
responses[] |
עדכון UpdateValuesResponse אחד לכל טווח מבוקש, באותו סדר שבו הופיעו הבקשות. |
היקפי הרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
למידע נוסף, עיינו במדריך ההרשאות.