Zeilen- und Spaltenvorgänge

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 ausgeführt werden können.

Diese Beispiele werden in Form von HTTP-Anfragen dargestellt, um sprachneutral zu sein. Informationen zum Implementieren einer Batchaktualisierung in verschiedenen Sprachen mit den 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. Sie finden die Tabellen ID in der Tabellen-URL. Sie können die Tabellenblatt-ID mit der spreadsheets.get Methode abrufen. Die Bereiche werden in der A1-Notation angegeben. Ein Beispielbereich ist Sheet1!A1:D5.

Spaltenbreite oder Zeilenhöhe anpassen

Das folgende spreadsheets.batchUpdate Codebeispiel zeigt, wie Sie mit dem UpdateDimensionPropertiesRequest die Breite von Spalte A auf 160 Pixel aktualisieren. Mit einer zweiten Anfrage wird die Zeilenhöhe der ersten drei Zeilen auf 40 Pixel aktualisiert. Das Feld dimension bestimmt, 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 spreadsheets.batchUpdate Codebeispiel zeigt, wie Sie mit AppendDimensionRequest Zeilen und Spalten anhängen. Mit der ersten Anfrage werden drei leere Zeilen an das Ende eines Tabellenblatts angehängt, mit der zweiten eine einzelne leere Spalte. Das Feld dimension bestimmt, 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
      }
    }
  ]
}

Spaltengröße automatisch anpassen

Das folgende spreadsheets.batchUpdate Codebeispiel 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
        }
      }
    }
  ]
}

Zeilengröße automatisch anpassen

Das folgende spreadsheets.batchUpdate Codebeispiel zeigt, wie Sie mit AutoResizeDimensionsRequest die Zeilenhöhen der ersten drei Zeilen löschen. 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

Das folgende spreadsheets.batchUpdate Codebeispiel zeigt, wie Sie mit dem DeleteDimensionRequest die ersten drei Zeilen in einem Tabellenblatt löschen. Mit einer zweiten Anfrage werden die Spalten B:D gelöscht. Das Feld dimension bestimmt, 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 spreadsheets.batchUpdate -Codebeispiel zeigt, wie Sie mit InsertDimensionRequest Spalten oder Zeilen an einer bestimmten Indexposition einfügen (z. B. leere Zeilen am Anfang eines Tabellenblatts einfügen). Mit der ersten 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 bestimmt, ob der Vorgang auf die Spalten oder Zeilen eines Tabellenblatts angewendet wird.

Wenn „true“, weist das Feld inheritFromBefore die Sheets API an, den neuen Spalten oder Zeilen dieselben Eigenschaften wie der vorherigen Zeile oder Spalte zu geben. Wenn „false“, werden die Eigenschaften von den 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 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

Das folgende spreadsheets.batchUpdate Codebeispiel zeigt, wie Sie mit MoveDimensionRequest Spalte A an die Position von Spalte D verschieben. Mit einer zweiten Anfrage werden die Zeilen 5 bis 10 an die Position von Zeile 20 verschoben.

Das Feld dimension bestimmt, ob der Vorgang auf die Spalten oder Zeilen eines Tabellenblatts angewendet wird. Das Feld destinationIndex bestimmt, wohin die Quelldaten verschoben werden sollen. Dabei wird ein nullbasierter Startindex verwendet.

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
      }
    },
  ],
}