- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- Anfrage
- UpdateTablePropertiesRequest
- UpdateSheetPropertiesRequest
- UpdateDimensionPropertiesRequest
- DataSourceSheetDimensionRange
- UpdateNamedRangeRequest
- RepeatCellRequest
- AddNamedRangeRequest
- DeleteNamedRangeRequest
- AddSheetRequest
- DeleteSheetRequest
- AutofillRequest
- SourceAndDestination
- CutInsertRequest
- Einfügen
- CopyInsertRequest
- Einfügen
- MergeCellsRequest
- Zusammenführungstyp
- UnmergeCellsRequest
- UpdateBordersRequest
- UpdateCellsRequest
- AddFilterViewRequest
- AnhängenderCellsRequest
- ClearBasicFilterRequest
- DeleteDimensionRequest
- DeleteEmbedObjectRequest
- DeleteFilterViewRequest
- DuplicateFilterViewRequest
- DuplicateSheetRequest
- FindReplaceRequest
- InsertDimensionRequest
- InsertRangeRequest
- MoveDimensionRequest
- UpdateEingebettetObjectPositionRequest
- InsertDataRequest
- TextToColumnRequest
- Trennzeichentyp
- UpdateFilterViewRequest
- DeleteRangeRequest
- Anhangsdimension
- AddConditionalFormatRuleRequest
- UpdateConditionalFormatRuleRequest
- DeleteConditionalFormatRuleRequest
- SortRangeRequest
- SetDataValidationRequest
- SetBasicFilterRequest
- AddProtectedRangeRequest
- UpdateProtectedRangeRequest
- DeleteProtectedRangeRequest
- AutoreiseDimensionenAnfrage
- AddChartRequest
- UpdateChartSpecRequest
- UpdateBandingRequest
- AddBandingRequest
- DeleteBandingRequest
- CreateDeveloperMetadataRequest
- UpdateDeveloperMetadataRequest
- DeleteDeveloperMetadataRequest
- RandomizeRangeRequest
- AddDimensionGroupRequest
- DeleteDimensionGroupRequest
- UpdateDimensionGroupRequest
- TrimWhitespaceRequest
- DeleteDuplicatesRequest
- UpdateEingebettetObjectBorderRequest
- AddSlicerRequest
- UpdateSlicerSpecRequest
- AddDataSourceRequest
- UpdateDataSourceRequest
- DeleteDataSourceRequest
- RefreshDataSourceRequest
- DataSourceObjectReferences
- DataSourceObjectReference
- Antwort
- AddNamedRangeResponse
- AddSheetResponse
- AddFilterViewResponse
- DuplicateFilterViewResponse
- DoppelteTabelle
- FindReplaceResponse
- UpdateEingebettetObjectPositionResponse
- UpdateConditionalFormatRuleResponse
- DeleteConditionalFormatRuleResponse
- AddProtectedRangeResponse
- AddChartResponse
- AddBandingResponse
- CreateDeveloperMetadataResponse
- UpdateDeveloperMetadataResponse
- DeleteDeveloperMetadataResponse
- AddDimensionGroupResponse
- DeleteDimensionGroupResponse
- TrimWhitespaceResponse
- DeleteDuplicatesResponse
- AddSlicerResponse
- AddDataSourceResponse
- UpdateDataSourceResponse
- RefreshDataSourceResponse
- RefreshDataSourceObjectExecutionStatus
- Testen!
Wendet eine oder mehrere Aktualisierungen auf die Tabelle an.
Jede request
muss vor der Anwendung validiert werden. Wenn eine Anfrage ungültig ist, schlägt die gesamte Anfrage fehl und es wird nichts angewendet.
Bei einigen Anfragen gibt es replies
, um Ihnen Informationen zur Anwendung zu geben. Die Antworten spiegeln die Anfragen wider. Wenn Sie beispielsweise vier Aktualisierungen angewendet haben und beim dritten eine Antwort gab, wurden in der Antwort zwei leere Antworten, die tatsächliche Antwort und eine weitere leere Antwort in dieser Reihenfolge angezeigt.
Da die Tabellen gemeinsam bearbeitet werden, ist nicht garantiert, dass die Tabelle Ihre Änderungen nach der Fertigstellung enthält. Die Aktualisierungen in der Anfrage werden jedoch atomar angewendet. Ihre Änderungen können im Hinblick auf Änderungen der Mitbearbeiter geändert werden. Wenn keine Mitbearbeiter vorhanden sind, sollten Ihre Änderungen in der Tabelle angezeigt werden.
HTTP-Anfrage
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
spreadsheetId |
Die 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 auf die Tabelle angewendet werden sollen. Anfragen werden in der angegebenen Reihenfolge angewendet. Wenn eine Anfrage ungültig ist, werden keine Anfragen angewendet. |
includeSpreadsheetInResponse |
Legt fest, ob die Updateantwort die Tabellenressource enthalten soll. |
responseRanges[] |
Beschränkt die in der Antworttabelle enthaltenen Bereiche. Dies ist nur sinnvoll, wenn |
responseIncludeGridData |
Dieser Wert ist „true“, wenn Rasterdaten zurückgegeben werden sollen. Dies ist nur sinnvoll, wenn |
Antworttext
Die Antwort auf die Batch-Aktualisierung einer Tabelle.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{ "spreadsheetId": string, "replies": [ { object ( |
Felder | |
---|---|
spreadsheetId |
Die Tabelle, auf die die Aktualisierungen angewendet wurden. |
replies[] |
Die Antwort zu den Updates. Diese Karte wird zu 1:1 zugeordnet und die Antworten können leer sein. |
updatedSpreadsheet |
Die Tabelle, nachdem Aktualisierungen angewendet wurden. Dies ist 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.