- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- Yêu cầu
- UpdateSpreadsheetPropertiesRequest
- UpdateSheetPropertiesRequest
- UpdateDimensionPropertiesRequest
- DataSourceSheetDimensionRange
- UpdateNamedRangeRequest
- RepeatCellRequest
- AddNamedRangeRequest
- DeleteNamedRangeRequest
- AddSheetRequest
- DeleteSheetRequest
- AutoFillRequest (Tự động điền)
- 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
- Phản hồi
- 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 (Trạng thái của việc làm mới bị huỷ)
- RefreshCancellationState
- RefreshCancellationErrorCode
- Hãy làm thử!
Áp dụng một hoặc nhiều nội dung cập nhật cho bảng tính.
Mỗi request
sẽ được xác thực trước khi áp dụng. Nếu có yêu cầu không hợp lệ, thì toàn bộ yêu cầu sẽ không thành công và không có yêu cầu nào được áp dụng.
Một số yêu cầu có replies
để cung cấp cho bạn một số thông tin về cách áp dụng các yêu cầu đó. Thư trả lời sẽ đồng bộ hoá nội dung yêu cầu. Ví dụ: nếu bạn đã áp dụng 4 nội dung cập nhật và nội dung cập nhật thứ 3 có thư trả lời, thì phản hồi sẽ có 2 thư trả lời trống, đó là thư trả lời thực tế và một thư trả lời khác trống theo thứ tự đó.
Do tính chất cộng tác của bảng tính, chúng tôi không đảm bảo rằng bảng tính sẽ phản ánh chính xác các thay đổi của bạn sau khi quá trình này hoàn tất, nhưng chúng tôi đảm bảo rằng các cập nhật trong yêu cầu sẽ được áp dụng cùng nhau một cách tỉ mỉ. Nội dung thay đổi của bạn có thể được điều chỉnh tương ứng với những thay đổi của cộng tác viên. Nếu không có cộng tác viên, bảng tính sẽ phản ánh các thay đổi của bạn.
Yêu cầu HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số | |
---|---|
spreadsheetId |
Bảng tính để áp dụng nội dung cập nhật. |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"requests": [
{
object ( |
Trường | |
---|---|
requests[] |
Danh sách nội dung cập nhật để áp dụng cho bảng tính. Các yêu cầu sẽ được áp dụng theo thứ tự đã chỉ định. Nếu có bất kỳ yêu cầu nào không hợp lệ, sẽ không có yêu cầu nào được áp dụng. |
includeSpreadsheetInResponse |
Xác định xem phản hồi cập nhật có cần bao gồm tài nguyên bảng tính hay không. |
responseRanges[] |
Giới hạn các phạm vi trong bảng tính câu trả lời. Chỉ có ý nghĩa khi giá trị |
responseIncludeGridData |
Đúng nếu dữ liệu lưới sẽ được trả về. Chỉ có ý nghĩa khi giá trị |
Nội dung phản hồi
Câu trả lời cho việc cập nhật hàng loạt một bảng tính.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "spreadsheetId": string, "replies": [ { object ( |
Trường | |
---|---|
spreadsheetId |
Bảng tính áp dụng nội dung cập nhật. |
replies[] |
Nội dung trả lời của nội dung cập nhật. Bản đồ này sẽ liên kết 1:1 với các bản cập nhật, mặc dù thư trả lời cho một số yêu cầu có thể trống. |
updatedSpreadsheet |
Bảng tính sau khi áp dụng cập nhật. Giá trị này chỉ được thiết lập nếu |
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau đây:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Để biết thêm thông tin, hãy xem bài viết Hướng dẫn uỷ quyền.