מגדירה ערכים בטווח אחד או יותר של גיליון אלקטרוני. המתקשר חייב לציין את מזהה הגיליון האלקטרוני, 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[] |
עדכון אחד של ValueValuesResponse לכל טווח מבוקש, באותו הסדר שבו הופיעו הבקשות. |
היקפי הרשאה
מחייב אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
למידע נוסף, ניתן לעיין במדריך ההרשאה.