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 sprachneutralen HTTP-Anfragen präsentiert. 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 Tabellenblatt-ID können Sie mit der Methode spreadsheets.get
abrufen. Die Bereiche werden in der A1-Schreibweise angegeben. Ein Beispielbereich ist Sheet1!A1:D5.
Spaltenbreite oder Zeilenhöhe anpassen
Das folgende Codebeispiel für spreadsheets.batchUpdate
zeigt, wie Sie mit UpdateDimensionPropertiesRequest
das Attribut für die Breite von Spalte A auf 160 Pixel aktualisieren. Eine zweite Anfrage aktualisiert die Zeilenhöheneigenschaft der ersten drei Zeilen auf 40 Pixel. Das Feld dimension
bestimmt, ob der Vorgang auf die Spalten oder Zeilen eines Tabellenblatts angewendet wird.
Das Anfrageprotokoll ist unten zu sehen.
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. Mit der ersten Anfrage werden drei leere Zeilen an das Ende eines Tabellenblatts angehängt, während in der zweiten eine einzelne leere Spalte angehängt wird. Das Feld dimension
bestimmt, ob der Vorgang auf die Spalten oder Zeilen eines Tabellenblatts angewendet wird.
Das Anfrageprotokoll ist unten zu sehen.
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 } } ] }
Spaltengröße automatisch anpassen
Im folgenden Codebeispiel für spreadsheets.batchUpdate
sehen Sie, wie Sie mit AutoResizeDimensionsRequest
die Größe der Spalten A:C anhand 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 zu sehen.
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
Im folgenden Codebeispiel für spreadsheets.batchUpdate
wird gezeigt, 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 zu sehen.
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 für spreadsheets.batchUpdate
sehen Sie, wie Sie mit DeleteDimensionRequest
die ersten drei Zeilen in einem Tabellenblatt löschen. Eine zweite Anfrage löscht die Spalten B:D.
Mit dem Feld dimension
wird festgelegt, ob der Vorgang auf die Spalten oder Zeilen eines Tabellenblatts angewendet wird.
Das Anfrageprotokoll ist unten zu sehen.
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 für spreadsheets.batchUpdate
zeigt, wie Sie mit InsertDimensionRequest
Spalten oder Zeilen in einem bestimmten Index einfügen (z. B. leere Zeilen am Anfang eines Tabellenblatts voranstellen). Die erste Anfrage fügt zwei leere Spalten in Spalte C ein.
Mit einer zweiten Anfrage werden drei leere Zeilen eingefügt, die bei Zeile 1 beginnen.
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 zu geben wie der vorherigen Zeile oder Spalte. Ist dies falsch, werden die Dimensionen nach den neuen Spalten oder Zeilen übernommen.
inheritFromBefore
kann nicht „true“ sein, wenn eine Zeile in Zeile 1 oder eine Spalte in Spalte A eingefügt wird.
Das Anfrageprotokoll ist unten zu sehen.
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
Im folgenden Codebeispiel für spreadsheets.batchUpdate
sehen Sie, wie Sie mit MoveDimensionRequest
Spalte A an Position von Spalte D verschieben. Durch eine zweite Anfrage werden die Zeilen 5–10 an die Position von Zeile 20 verschoben.
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 Startindexes, wohin die Quelldaten verschoben werden sollen.
Das Anfrageprotokoll ist unten zu sehen.
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 } }, ], }