- 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
- 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 項更新,而第 3 人有回覆,則該回應中會有 2 個空白的回覆、實際回覆,以及另一個空白回覆。
由於試算表的協作性質,我們無法保證試算表會在完成之後準確反映變更,但是我們保證,要求中的更新資訊會統一套用。如果協作者變更的內容,你所做的變更可能會跟著改變。如果沒有協作者,試算表會反映您所做的變更。
HTTP 要求
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
spreadsheetId |
要套用更新內容的試算表。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"requests": [
{
object ( |
欄位 | |
---|---|
requests[] |
要套用至試算表的更新清單。系統會按照指定的順序套用要求。如果有任何要求無效,系統就不會套用任何要求。 |
includeSpreadsheetInResponse |
決定更新回應是否應包含試算表資源。 |
responseRanges[] |
限制回應試算表可涵蓋的範圍。只有在 |
responseIncludeGridData |
如果應傳回格線資料,則為 True。只有在 |
回應主體
批次更新試算表的回覆。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{ "spreadsheetId": string, "replies": [ { object ( |
欄位 | |
---|---|
spreadsheetId |
套用更新的試算表。 |
replies[] |
更新的回覆。這會對應更新結果的 1:1,不過部分要求的回覆可能為空白。 |
updatedSpreadsheet |
套用更新後的試算表。只有在 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
詳情請參閱授權指南。