- Permintaan HTTP
- Parameter lokasi
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- Permintaan
- 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
- Respons
- 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
- Cobalah!
Menerapkan satu atau beberapa pembaruan ke spreadsheet.
Setiap request
divalidasi sebelum diterapkan. Jika ada permintaan yang tidak valid, seluruh permintaan akan gagal dan tidak ada yang akan diterapkan.
Beberapa permintaan memiliki replies
untuk memberi Anda beberapa informasi tentang cara penerapannya. Balasan akan mencerminkan permintaan. Misalnya, jika Anda menerapkan 4 pembaruan dan balasan ketiga memiliki balasan, maka respons akan memiliki 2 balasan kosong, balasan sebenarnya, dan balasan kosong lainnya, dalam urutan tersebut.
Karena spreadsheet bersifat kolaboratif, tidak ada jaminan bahwa spreadsheet akan mencerminkan perubahan Anda dengan tepat setelah ini selesai, namun dijamin bahwa pembaruan dalam permintaan akan diterapkan bersama-sama secara atomik. Perubahan Anda mungkin akan diubah sehubungan dengan perubahan kolaborator. Jika tidak ada kolaborator, {i>spreadsheet<i} harus menunjukkan perubahan yang Anda buat.
Permintaan HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
spreadsheetId |
Spreadsheet yang akan menerapkan pembaruan. |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"requests": [
{
object ( |
Kolom | |
---|---|
requests[] |
Daftar pembaruan untuk diterapkan ke spreadsheet. Permintaan akan diterapkan sesuai urutan yang ditentukan. Jika ada permintaan yang tidak valid, tidak ada permintaan yang akan diterapkan. |
includeSpreadsheetInResponse |
Menentukan apakah respons pembaruan harus menyertakan resource spreadsheet. |
responseRanges[] |
Membatasi rentang yang disertakan dalam spreadsheet respons. Bermanfaat hanya jika |
responseIncludeGridData |
Benar jika data petak akan ditampilkan. Bermanfaat hanya jika |
Isi respons
Balasan untuk pembaruan spreadsheet dalam jumlah banyak.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "spreadsheetId": string, "replies": [ { object ( |
Kolom | |
---|---|
spreadsheetId |
Spreadsheet tempat pembaruan diterapkan. |
replies[] |
Balasan update. Pemetaan ini 1:1 dengan pembaruan, meskipun balasan untuk beberapa permintaan mungkin kosong. |
updatedSpreadsheet |
Spreadsheet setelah pembaruan diterapkan. Ini hanya disetel jika |
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Untuk informasi selengkapnya, lihat Panduan otorisasi.