Mit der Google Sheets API können Sie Zeilen und Spalten in Tabellen. Die Beispiele auf dieser Seite veranschaulichen, wie einige gängige Zeilen und Spalten Operationen können mit der Sheets API realisiert werden.
Diese Beispiele werden in Form von HTTP-Anfragen neutral sein. Um zu erfahren, wie Sie eine Batch-Aktualisierung in verschiedenen Sprachen mithilfe der Google API-Clientbibliotheken, siehe Aktualisieren Tabellen.
In diesen Beispielen haben die Platzhalter SPREADSHEET_ID und SHEET_ID
gibt an, wo Sie diese IDs angeben würden. Sie finden die Tabelle
ID in der Tabellen-URL. Sie erhalten
Tabellenblatt-ID mithilfe des
spreadsheets.get-Methode. Die
Bereiche werden in der A1-Notation angegeben. Eine
Beispielbereich ist Sheet1!A1:D5.
Spaltenbreite oder Zeilenhöhe anpassen
Die folgenden
spreadsheets.batchUpdate
wird in einem Codebeispiel gezeigt, wie Sie
UpdateDimensionPropertiesRequest
um die Eigenschaft für die Breite der Spalte A auf 160 Pixel zu aktualisieren. Eine zweite Anforderung wird aktualisiert.
Zeilenhöhe der ersten drei Zeilen auf 40 Pixel fest. Das dimension
bestimmt, ob der Vorgang auf die Spalten oder Zeilen eines
Tabellenblatt.
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
Die folgenden
spreadsheets.batchUpdate
wird in einem Codebeispiel gezeigt, wie Sie
AppendDimensionRequest
um Zeilen und Spalten anzuhängen. Die erste Anfrage hängt drei leere Zeilen an den
am Ende eines Blattes und das zweite hängt eine einzelne leere Spalte an. Das dimension
bestimmt, ob der Vorgang auf die Spalten oder Zeilen eines
Tabellenblatt.
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
Die folgenden
spreadsheets.batchUpdate
wird in einem Codebeispiel gezeigt, wie Sie
AutoResizeDimensionsRequest
um die Größe der Spalten A:C an die Größe des Spalteninhalts anzupassen. Das 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
Die folgenden
spreadsheets.batchUpdate
wird in einem Codebeispiel gezeigt, wie Sie
AutoResizeDimensionsRequest
um die Zeilenhöhen der ersten drei Zeilen zu löschen. Die Zeilenhöhen steigen dann,
basierend auf dem Inhalt der Zellen in jeder Zeile. Das 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
Die folgenden
spreadsheets.batchUpdate
wird in einem Codebeispiel gezeigt, wie Sie
DeleteDimensionRequest
um die ersten drei Zeilen in einem Blatt zu löschen. Eine zweite Anfrage löscht die Spalten B:D.
Das Feld dimension bestimmt, ob der Vorgang auf die Spalten oder
Zeilen eines Tabellenblatts.
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
Die folgenden
spreadsheets.batchUpdate
wird in einem Codebeispiel gezeigt, wie Sie
InsertDimensionRequest
um Spalten oder Zeilen in einen bestimmten Index einzufügen (z. B. leeren Zeilen voranzustellen)
am Anfang eines Tabellenblatts). 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.
Das Feld dimension bestimmt, ob der Vorgang auf die Spalten oder
Zeilen eines Tabellenblatts.
Bei "true" weist das Feld inheritFromBefore die Sheets API an,
haben die neuen Spalten oder Zeilen dieselben Eigenschaften wie die vorherige Zeile oder Spalte.
false, um die Werte aus den Dimensionen nach den neuen Spalten oder Zeilen zu übernehmen.
inheritFromBefore kann nicht „true“ sein, wenn eine Zeile bei Zeile 1 oder eine Spalte bei
Spalte A.
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
Die folgenden
spreadsheets.batchUpdate
wird in einem Codebeispiel gezeigt, wie Sie
MoveDimensionRequest
um Spalte A an Position
D der Spalte D zu verschieben. Bei einer zweiten Anfrage werden Zeilen verschoben
5–10 auf Zeile 20 an.
Das Feld dimension bestimmt, ob der Vorgang auf die Spalten oder
Zeilen eines Tabellenblatts. Über das Feld destinationIndex wird festgelegt, wohin die
Quelldaten mit einem nullbasierten Startindex.
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
}
},
],
}