- בקשת HTTP
- פרמטרים של נתיב
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- בקשה
- UpdateSpreadsheetPropertiesRequest
- UpdateSheetPropertiesRequest
- UpdateDimensionPropertiesRequest
- DataSourceSheetDimensionRange
- UpdateNamedRangeRequest
- RepeatCellRequest
- AddNamedRangeRequest
- DeleteNamedRangeRequest
- AddSheetRequest
- DeleteSheetRequest
- AutoFillRequest
- SourceAndDestination
- CutPasteRequest
- PasteType
- CopyPasteRequest
- PasteOrientation
- MergeCellsRequest
- MergeType
- UnmergeCellsRequest
- UpdateBordersRequest
- UpdateCellsRequest
- AddFilterViewRequest
- AppendCellsRequest
- ClearBasicFilterRequest
- DeleteDimensionRequest
- DeleteEmbeddedObjectRequest
- DeleteFilterViewRequest
- DuplicateFilterViewRequest
- DuplicateSheetRequest
- FindReplaceRequest
- InsertDimensionRequest
- InsertRangeRequest
- MoveDimensionRequest
- UpdateEmbeddedObjectPositionRequest
- PasteDataRequest
- TextToColumnsRequest
- DelimiterType
- UpdateFilterViewRequest
- DeleteRangeRequest
- AppendDimensionRequest
- AddConditionalFormatRuleRequest
- UpdateConditionalFormatRuleRequest
- DeleteConditionalFormatRuleRequest
- SortRangeRequest
- SetDataValidationRequest
- SetBasicFilterRequest
- AddProtectedRangeRequest
- UpdateProtectedRangeRequest
- DeleteProtectedRangeRequest
- AutoResizeDimensionsRequest
- AddChartRequest
- UpdateChartSpecRequest
- UpdateBandingRequest
- AddBandingRequest
- DeleteBandingRequest
- CreateDeveloperMetadataRequest
- UpdateDeveloperMetadataRequest
- DeleteDeveloperMetadataRequest
- RandomizeRangeRequest
- AddDimensionGroupRequest
- DeleteDimensionGroupRequest
- UpdateDimensionGroupRequest
- TrimWhitespaceRequest
- DeleteDuplicatesRequest
- UpdateEmbeddedObjectBorderRequest
- AddSlicerRequest
- UpdateSlicerSpecRequest
- AddDataSourceRequest (הוספה של DataSourceRequest)
- UpdateDataSourceRequest
- DeleteDataSourceRequest
- RefreshDataSourceRequest
- DataSourceObjectReferences
- DataSourceObjectReference
- CancelDataSourceRefreshRequest
- תשובה
- AddNamedRangeResponse
- AddSheetResponse
- AddFilterViewResponse
- DuplicateFilterViewResponse
- DuplicateSheetResponse
- FindReplaceResponse
- UpdateEmbeddedObjectPositionResponse
- UpdateConditionalFormatRuleResponse
- DeleteConditionalFormatRuleResponse
- AddProtectedRangeResponse
- AddChartResponse
- AddBandingResponse
- CreateDeveloperMetadataResponse
- UpdateDeveloperMetadataResponse
- DeleteDeveloperMetadataResponse
- AddDimensionGroupResponse
- DeleteDimensionGroupResponse
- TrimWhitespaceResponse
- DeleteDuplicatesResponse
- AddSlicerResponse
- AddDataSourceResponse
- UpdateDataSourceResponse
- RefreshDataSourceResponse
- RefreshDataSourceObjectExecutionStatus
- CancelDataSourceRefreshResponse
- CancelDataSourceRefreshStatus
- RefreshCancellationStatus
- RefreshCancellationState
- RefreshCancellationErrorCode
- רוצים לנסות?
מחיל עדכון אחד או יותר על הגיליון האלקטרוני.
כל request
עובר אימות לפני היישום שלו. אם בקשה כלשהי לא תקפה, הבקשה כולה תיכשל ולא מיושמת שום דבר.
בחלק מהבקשות יש replies
כדי לספק לך מידע מסוים על אופן היישום שלהן. התשובות ישקפו את הבקשות. לדוגמה, אם הזנתם 4 עדכונים ובתגובה השלישית הייתה תשובה, התשובה תכלול 2 תשובות ריקות, את התשובה עצמה ותשובה ריקה נוספת, בסדר הזה.
בגלל האופי של הגיליונות האלקטרוניים, לא בטוח שהגיליון האלקטרוני ישקף בדיוק את השינויים שערכת לאחר השלמתם. עם זאת, ניתן להבטיח שכל העדכונים בבקשה יבוצעו יחד באופן אטומי. ייתכן שהשינויים שלך ישתנו בהתאם לשינויים של שותפי עריכה. אם אין שותפי עריכה, הגיליון האלקטרוני אמור לשקף את השינויים שביצעתם.
בקשת HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
spreadsheetId |
הגיליון האלקטרוני שעליו רוצים להחיל את העדכונים. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"requests": [
{
object ( |
שדות | |
---|---|
requests[] |
רשימת עדכונים להחלה על הגיליון האלקטרוני. הבקשות יוחלו לפי הסדר שבו הן מפורטות. אם בקשה כלשהי אינה חוקית, לא יוגשו בקשות כלשהן. |
includeSpreadsheetInResponse |
המדיניות הזו קובעת אם התשובה לעדכון תכלול את המשאב של הגיליון האלקטרוני. |
responseRanges[] |
הגבלת הטווחים הכלולים בגיליון האלקטרוני של התגובות. המשמעותי רק אם הערך של |
responseIncludeGridData |
True אם רוצים להחזיר נתוני רשת. המשמעותי רק אם הערך של |
גוף התשובה
התשובה לגבי עדכון בכמות גדולה של גיליון אלקטרוני.
אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "spreadsheetId": string, "replies": [ { object ( |
שדות | |
---|---|
spreadsheetId |
הגיליון האלקטרוני שעליו בוצעו העדכונים. |
replies[] |
התשובה לגבי העדכונים. זהו מיפוי אחד על אחד עם העדכונים, אף על פי שתשובות לחלק מהבקשות עשויות להיות ריקות. |
updatedSpreadsheet |
הגיליון האלקטרוני לאחר החלת העדכונים. המדיניות הזו מוגדרת רק אם הערך של |
היקפי הרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
למידע נוסף, עיינו במדריך ההרשאות.