- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Prośba
- 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
- Odpowiedź
- 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
- Wypróbuj
Stosuje co najmniej jedną aktualizację w arkuszu kalkulacyjnym.
Każdy element request
jest weryfikowany przed zastosowaniem. Jeśli któreś żądanie jest nieprawidłowe, całe żądanie zakończy się niepowodzeniem i nic nie zostanie zastosowane.
W przypadku niektórych próśb opcja replies
zawiera informacje o sposobie ich stosowania. Odpowiedzi będą odzwierciedlały żądania. Jeśli na przykład zastosujesz 4 aktualizacje, a trzecia ma odpowiedź, to będzie ona mieć 2 puste odpowiedzi – faktyczną i drugą pustą odpowiedź (w tej kolejności).
Ze względu na możliwość współpracy w arkuszach kalkulacyjnych nie można zagwarantować, że po zakończeniu operacji wprowadzone zmiany zostaną dokładnie odzwierciedlone w zmianach. Gwarantujemy jednak, że aktualizacje w żądaniu zostaną zastosowane atomowo. Twoje zmiany mogą zostać zmienione w zależności od zmian wprowadzonych przez współpracowników. Jeśli nie masz współpracowników, arkusz kalkulacyjny powinien zawierać wprowadzone zmiany.
Żądanie HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
spreadsheetId |
Arkusz kalkulacyjny, do którego chcesz zastosować aktualizacje. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"requests": [
{
object ( |
Pola | |
---|---|
requests[] |
Lista aktualizacji, które mają zostać zastosowane do arkusza kalkulacyjnego. Żądania będą stosowane w kolejności, w jakiej zostały podane. Jeśli jakieś żądanie jest nieprawidłowe, nie zostaną zastosowane żadne żądania. |
includeSpreadsheetInResponse |
Określa, czy odpowiedź dotycząca aktualizacji powinna zawierać zasób arkusza kalkulacyjnego. |
responseRanges[] |
Ogranicza zakresy uwzględnione w arkuszu kalkulacyjnym odpowiedzi. Istotne tylko wtedy, gdy |
responseIncludeGridData |
Prawda, jeśli powinny zostać zwrócone dane siatki. Istotne tylko wtedy, gdy |
Treść odpowiedzi
Odpowiedź dotycząca zbiorczego zaktualizowania arkusza kalkulacyjnego.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "spreadsheetId": string, "replies": [ { object ( |
Pola | |
---|---|
spreadsheetId |
Arkusz kalkulacyjny, do którego zastosowano zmiany. |
replies[] |
Odpowiedź na aktualizacje. Aktualizacje są mapowane indywidualnie, chociaż odpowiedzi na niektóre prośby mogą być puste. |
updatedSpreadsheet |
Arkusz kalkulacyjny po zastosowaniu aktualizacji. Tę wartość należy ustawić tylko wtedy, gdy |
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Więcej informacji znajdziesz w przewodniku po autoryzacji.