- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- Anfrage
- UpdateSpreadsheetPropertiesRequest
- UpdateSheetPropertiesRequest
- UpdateDimensionPropertiesRequest
- DataSourceSheetDimensionRange
- UpdateNamedRangeRequest
- RepeatCellRequest
- AddNamedRangeRequest
- DeleteNamedRangeRequest
- AddSheetRequest
- DeleteSheetRequest
- AutoFillRequest
- SourceAndDestination (Quelle und Ziel)
- 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
- Antwort
- AddNamedRangeResponse
- AddSheetResponse (Tabellenantwort hinzufügen)
- 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 (Stornostatus)
- RefreshCancellationState
- RefreshCancellationErrorCode
- Testen!
Wendet eine oder mehrere Aktualisierungen auf die Tabelle an.
Jeder request
wird vor der Anwendung validiert. Wenn eine Anfrage ungültig ist, schlägt die gesamte Anfrage fehl und es wird nichts angewendet.
Einige Anfragen enthalten replies
, damit Sie wissen, wie sie angewendet werden. Die Antworten spiegeln die Anfragen wider. Wenn Sie beispielsweise vier Aktualisierungen angewendet haben und die dritte eine Antwort hatte, enthält die Antwort zwei leere Antworten, die tatsächliche Antwort und eine weitere leere Antwort in dieser Reihenfolge.
Aufgrund der Zusammenarbeit bei Tabellen kann nicht garantiert werden, dass die Tabelle nach Abschluss des Vorgangs exakt Ihre Änderungen wiedergibt. Es ist jedoch garantiert, dass die Aktualisierungen in der Anfrage in kleinstmöglichen Schritten zusammen angewendet werden. Ihre Änderungen können auch von Mitbearbeitern berücksichtigt werden. Wenn es keine Mitbearbeiter gibt, sollten die Änderungen in der Tabelle widergespiegelt werden.
HTTP-Anfrage
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
spreadsheetId |
Tabelle, auf die die Aktualisierungen angewendet werden sollen |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{
"requests": [
{
object ( |
Felder | |
---|---|
requests[] |
Eine Liste der Aktualisierungen, die in der Tabelle angewendet werden sollen. Anfragen werden in der angegebenen Reihenfolge angewendet. Wenn eine Anfrage ungültig ist, werden keine Anfragen angewendet. |
includeSpreadsheetInResponse |
Bestimmt, ob die Updateantwort die Tabellenkalkulationsressource enthalten soll. |
responseRanges[] |
Beschränkt die Bereiche in der Antworttabelle. Nur sinnvoll, wenn |
responseIncludeGridData |
True, wenn Rasterdaten zurückgegeben werden sollen. Nur sinnvoll, wenn |
Antworttext
Die Antwort für die Batch-Aktualisierung einer Tabelle.
Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "spreadsheetId": string, "replies": [ { object ( |
Felder | |
---|---|
spreadsheetId |
Tabelle, auf die die Aktualisierungen angewendet wurden |
replies[] |
Die Antwort auf die Updates. Dies entspricht der 1:1-Beziehung mit den Aktualisierungen, wobei die Antworten auf einige Anfragen möglicherweise leer sein können. |
updatedSpreadsheet |
Die Tabelle, nachdem die Änderungen übernommen wurden. Dieser Wert wird nur festgelegt, wenn |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.