Mit der Google Sheets 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 Sheets API realisiert werden können.
Diese Beispiele werden in Form von HTTP-Anfragen präsentiert, um sprachneutral zu sein. Informationen zum Implementieren einer Batch-Aktualisierung in verschiedenen Sprachen mithilfe der Google API-Clientbibliotheken finden Sie unter Tabellen aktualisieren.
In diesen Beispielen geben die Platzhalter SPREADSHEET_ID und SHEET_ID an, wo Sie diese IDs angeben müssen. Die Tabellen-ID finden Sie in der Tabellen-URL. Die Tabellen-ID lässt sich mit der Methode spreadsheets.get abrufen. Die Bereiche werden in der A1-Notation angegeben. Ein Beispielbereich ist Sheet1!A1:D5.
Spaltenbreite oder Zeilenhöhe anpassen
Das folgende Codebeispiel spreadsheets.batchUpdate zeigt, wie Sie mit UpdateDimensionPropertiesRequest die Breiteneigenschaft von Spalte A auf 160 Pixel aktualisieren. In einer zweiten Anfrage wird die Zeilenhöheneigenschaft der ersten drei Zeilen auf 40 Pixel aktualisiert. Mit dem Feld dimension wird festgelegt, 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
Das folgende Codebeispiel spreadsheets.batchUpdate zeigt, wie mit AppendDimensionRequest Zeilen und Spalten angehängt werden. Die erste Anfrage hängt drei leere Zeilen an das Ende eines Tabellenblatts an, während die zweite eine einzelne leere Spalte anhängt. Mit dem Feld dimension wird festgelegt, 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 von Spalten automatisch anpassen
Das folgende Codebeispiel spreadsheets.batchUpdate zeigt, wie Sie mit AutoResizeDimensionsRequest die Größe der Spalten A:C basierend auf der Größe des Spalteninhalts anpassen. 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 anpassen
Das folgende Codebeispiel spreadsheets.batchUpdate zeigt, wie Sie mit AutoResizeDimensionsRequest die Zeilenhöhen der ersten drei Zeilen löschen. Die Zeilenhöhen wachsen dann dynamisch basierend auf dem Inhalt der Zellen in jeder Zeile. 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
Das folgende Codebeispiel spreadsheets.batchUpdate zeigt, wie Sie mit DeleteDimensionRequest die ersten drei Zeilen eines Tabellenblatts löschen. Mit einer zweiten Anfrage werden die Spalten B:D gelöscht.
Mit dem Feld dimension wird festgelegt, 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
Das folgende Codebeispiel spreadsheets.batchUpdate zeigt, wie Sie mit InsertDimensionRequest Spalten oder Zeilen bei einem bestimmten Index einfügen (z. B. zum Voranstellen leerer Zeilen am Anfang eines Tabellenblatts). Die erste Anfrage fügt zwei leere Spalten in Spalte C ein.
Eine zweite Anfrage fügt drei leere Zeilen ein, beginnend bei Zeile 1.
Mit dem Feld dimension wird festgelegt, ob der Vorgang auf die Spalten oder Zeilen eines Tabellenblatts angewendet wird.
Bei „true“ weist das Feld inheritFromBefore die Sheets API an, den neuen Spalten oder Zeilen dieselben Eigenschaften wie in der vorherigen Zeile oder Spalte zuzuweisen. Bei „false“ werden sie aus den Dimensionen nach den neuen Spalten oder Zeilen übernommen.
inheritFromBefore kann nicht wahr sein, wenn eine Zeile bei Zeile 1 oder eine Spalte bei Spalte A eingefügt wird.
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
}
},
],
}
Zeilen oder Spalten verschieben
Das folgende Codebeispiel spreadsheets.batchUpdate zeigt, wie Sie MoveDimensionRequest verwenden, um Spalte A an die Position von Spalte D zu verschieben. Eine zweite Anfrage verschiebt die Zeilen 5–10 an die Position von Zeile 20.
Mit dem Feld dimension wird festgelegt, ob der Vorgang auf die Spalten oder Zeilen eines Tabellenblatts angewendet wird. Das Feld destinationIndex bestimmt mithilfe eines nullbasierten Startindex, 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
}
},
],
}