Method: spreadsheets.batchUpdate

הוספת עדכון אחד או יותר לגיליון האלקטרוני.

כל request מאומת לפני שהוא מוחל. אם בקשה כלשהי לא תהיה תקפה, הבקשה כולה תיכשל ולא יבוצעו שינויים.

בחלק מהבקשות מופיע הסמל replies כדי לספק לכם מידע על אופן ההחלה שלהן. התשובות יהיו זהות לבקשות. לדוגמה, אם החלתם 4 עדכונים והעדכון השלישי כלל תגובה, התשובה תכלול 2 תגובות ריקות, את התגובה בפועל ועוד תגובה ריקה, בסדר הזה.

בגלל האופי השיתופי של גיליונות אלקטרוניים, לא מובטח שהגיליון האלקטרוני ישקף בדיוק את השינויים שלכם אחרי שהפעולה הזו תסתיים, אבל מובטח שהעדכונים בבקשה יוחלו יחד באופן אטומי. יכול להיות שהשינויים שלכם ישתנו בהתאם לשינויים ששותפי העריכה יבצעו. אם אין שותפי עריכה, השינויים שלכם יופיעו בגיליון האלקטרוני.

בקשת HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
spreadsheetId

string

הגיליון האלקטרוני שבו רוצים להחיל את העדכונים.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "includeSpreadsheetInResponse": boolean,
  "responseRanges": [
    string
  ],
  "responseIncludeGridData": boolean,
  "commentsViewMode": enum (CommentsViewMode)
}
שדות
requests[]

object (Request)

רשימת העדכונים שרוצים להחיל על הגיליון האלקטרוני. הבקשות יחולו לפי הסדר שבו הן צוינו. אם בקשה כלשהי לא תהיה תקפה, אף בקשה לא תתבצע.
includeSpreadsheetInResponse

boolean

קובע אם תגובת העדכון צריכה לכלול את משאב הגיליון האלקטרוני.
responseRanges[]

string

מגביל את הטווחים שנכללים בגיליון האלקטרוני של התשובה. הפרמטר הזה רלוונטי רק אם הערך של includeSpreadsheetInResponse הוא true.
responseIncludeGridData

boolean

הערך True אם צריך להחזיר נתונים של רשת. הפרמטר הזה רלוונטי רק אם הערך של includeSpreadsheetInResponse הוא true. אם מוגדרת מסכת שדות בבקשה, המערכת מתעלמת מהפרמטר הזה.
commentsViewMode

enum (CommentsViewMode)

מצב התצוגה של התגובות שיוחל על הגיליון האלקטרוני. כך אפשר לראות את הגיליון האלקטרוני בלי התגובות או עם התגובות. אם לא מציינים ערך, המערכת משתמשת בערך COMMENTS_VIEW_MODE_OMITTED. הפרמטר הזה רלוונטי רק אם הערך של includeSpreadsheetInResponse הוא true.

גוף התשובה

התשובה לעדכון באצווה של גיליון אלקטרוני.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "spreadsheetId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "updatedSpreadsheet": {
    object (Spreadsheet)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
שדות
spreadsheetId

string

גיליון אלקטרוני שהעדכונים הוחלו עליו.
replies[]

object (Response)

התשובה לעדכונים. המיפוי הזה הוא 1:1 עם העדכונים, אבל יכול להיות שהתשובות לחלק מהבקשות יהיו ריקות.
updatedSpreadsheet

object (Spreadsheet)

הגיליון האלקטרוני אחרי החלת העדכונים. השדה הזה מוגדר רק אם הערך של BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response הוא true.
commentUpdateState

enum (CommentUpdateState)

האם עדכוני התגובות הוחלו בבקשת Batch.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

מידע נוסף זמין במדריך ההרשאות.

CommentUpdateState

הסטטוס של עדכוני התגובות בבקשת Batch.

טיפוסים בני מנייה (enum)
COMMENT_UPDATE_STATE_UNSPECIFIED לא מצוין סטטוס העדכונים של התגובות.
NO_UPDATES_REQUESTED לא נשלחו בקשות לעדכון תגובות בבקשת Batch.
ALL_SAVED כל העדכונים שביקשתם לתגובות בוצעו בבקשת Batch.
ALL_FAILED_UNKNOWN_REASON כל העדכונים המבוקשים של התגובות נכשלו.