Mit der Google Tabellen API können Sie Zeilen und Spalten in Tabellen hinzufügen, entfernen und bearbeiten. Die Beispiele auf dieser Seite veranschaulichen, wie einige gängige Zeilen- und Spaltenvorgänge mit der Google Tabellen API ausgeführt werden können.
Diese Beispiele werden in Form von HTTP-Anfragen dargestellt, um sprachenunabhängig zu sein. Informationen zum Implementieren eines Batch-Updates in verschiedenen Sprachen mit den Clientbibliotheken der Google API finden Sie unter Listen aktualisieren.
In diesen Beispielen geben die Platzhalter SPREADSHEET_ID und SHEET_ID an, wo Sie diese IDs angeben würden. Sie finden die Tabellen-ID in der Tabellen-URL. Sie können die Tabellen-ID mit der Methode spreadsheets.get abrufen. Die Bereiche werden in A1-Notation angegeben. Ein Beispiel für einen Bereich ist Tabelle1!A1:D5.
Spaltenbreite oder Zeilenhöhe anpassen
Im folgenden Codebeispiel für spreadsheets.batchUpdate wird gezeigt, wie Sie mit UpdateDimensionPropertiesRequest die Breite von Spalte A auf 160 Pixel aktualisieren. Mit einer zweiten Anfrage wird die Eigenschaft „Zeilenhöhe“ der ersten drei Zeilen auf 40 Pixel aktualisiert. Das Feld dimension gibt an, ob der Vorgang auf die Spalten oder Zeilen eines Tabellenblatts angewendet wird.
Das Anfrageprotokoll ist unten dargestellt.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"updateDimensionProperties": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 1
},
"properties": {
"pixelSize": 160
},
"fields": "pixelSize"
}
},
{
"updateDimensionProperties": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
},
"properties": {
"pixelSize": 40
},
"fields": "pixelSize"
}
}
]
}
Leere Zeilen oder Spalten anhängen
Im folgenden Codebeispiel für spreadsheets.batchUpdate wird gezeigt, wie Sie mit AppendDimensionRequest Zeilen und Spalten anhängen. Bei der ersten Anfrage werden am Ende eines Tabellenblatts drei leere Zeilen angehängt, bei der zweiten eine einzelne leere Spalte. Das Feld dimension gibt an, ob der Vorgang auf die Spalten oder Zeilen eines Tabellenblatts angewendet wird.
Das Anfrageprotokoll ist unten dargestellt.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"appendDimension": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"length": 3
}
},
{
"appendDimension": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"length": 1
}
}
]
}
Größe einer Spalte automatisch ändern
Im folgenden Codebeispiel spreadsheets.batchUpdate wird gezeigt, wie Sie mit AutoResizeDimensionsRequest die Größe der Spalten A bis C anhand der Größe des Spalteninhalts ändern. Das Feld dimension gibt an, dass der Vorgang auf die Spalten des Tabellenblatts angewendet wird.
Das Anfrageprotokoll ist unten dargestellt.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}
Größe einer Zeile automatisch ändern
Im folgenden Codebeispiel für spreadsheets.batchUpdate wird gezeigt, wie mit AutoResizeDimensionsRequest die Zeilenhöhen der ersten drei Zeilen gelöscht werden. Die Zeilenhöhen werden dann dynamisch basierend auf dem Inhalt der Zellen in jeder Zeile angepasst. Das Feld dimension gibt an, dass der Vorgang auf die Zeilen des Tabellenblatts angewendet wird.
Das Anfrageprotokoll ist unten dargestellt.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}
Zeilen oder Spalten löschen
Im folgenden Codebeispiel mit spreadsheets.batchUpdate wird gezeigt, wie Sie mit DeleteDimensionRequest die ersten drei Zeilen in einem Tabellenblatt löschen. Mit einer zweiten Anfrage werden die Spalten B:D gelöscht.
Das Feld dimension legt fest, ob der Vorgang auf die Spalten oder Zeilen eines Tabellenblatts angewendet wird.
Das Anfrageprotokoll ist unten dargestellt.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"deleteDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
}
}
},
{
"deleteDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 1,
"endIndex": 4
}
}
},
],
}
Leere Zeile oder Spalte einfügen
Im folgenden Codebeispiel für spreadsheets.batchUpdate wird gezeigt, wie Sie mit InsertDimensionRequest Spalten oder Zeilen an einem bestimmten Index einfügen, z. B. leere Zeilen oben in einem Tabellenblatt. Durch die erste Anfrage werden zwei leere Spalten in Spalte C eingefügt.
Mit einer zweiten Anfrage werden drei leere Zeilen ab Zeile 1 eingefügt.
Das Feld dimension legt fest, ob der Vorgang auf die Spalten oder Zeilen eines Tabellenblatts angewendet wird.
Wenn „wahr“ festgelegt ist, weist das Feld inheritFromBefore der Google Tabellen API an, den neuen Spalten oder Zeilen dieselben Eigenschaften wie der vorherigen Zeile oder Spalte zuzuweisen. Ist „falsch“ festgelegt, werden die Dimensionen nach den neuen Spalten oder Zeilen übernommen.
inheritFromBefore kann nicht wahr sein, wenn Sie eine Zeile in Zeile 1 oder eine Spalte in Spalte A einfügen.
Das Anfrageprotokoll ist unten dargestellt.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"insertDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 2,
"endIndex": 4
},
"inheritFromBefore": true
}
},
{
"insertDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
},
"inheritFromBefore": false
}
},
],
}
Zeile oder Spalte verschieben
Im folgenden Codebeispiel mit spreadsheets.batchUpdate wird gezeigt, wie Sie mit MoveDimensionRequest Spalte A an die Position von Spalte D verschieben. Eine zweite Anfrage verschiebt die Zeilen 5–10 an die Position 20.
Das Feld dimension legt fest, ob der Vorgang auf die Spalten oder Zeilen eines Tabellenblatts angewendet wird. Im Feld destinationIndex wird mithilfe eines nullbasierten Startindexes festgelegt, wohin die Quelldaten verschoben werden sollen.
Das Anfrageprotokoll ist unten dargestellt.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"moveDimension": {
"source": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 1
},
"destinationIndex": 3
}
},
{
"moveDimension": {
"source": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 4,
"endIndex": 10
},
"destinationIndex": 19
}
},
],
}