Tabellen

In dieser Anleitung wird beschrieben, wie und warum Sie mit der Google Sheets API Tabellen in Ihren Tabellen erstellen.

Was ist eine Tabelle?

Mit Tabellen können Sie die Datenerstellung vereinfachen und das wiederholte Formatieren, Eingeben und Aktualisieren von Daten reduzieren, indem Formatierungen und Strukturierungen automatisch auf Datenbereiche angewendet werden.

Tabellen haben viele Funktionen, z. B. Kopf- und Fußzeilen, Spaltentypen, Filter, Ansichten, Tabellenverweise und Tabellennamen. Weitere Informationen finden Sie in der Funktionsankündigung, und unter Tabellen in Google Sheets verwenden.

Sie können Tabellen für Aufgaben wie Projektverfolgung, Veranstaltungsplanung und Bestandsverwaltung verwenden.

Tabellen hinzufügen

Verwenden Sie zum Hinzufügen einer Tabelle die batchUpdate -Methode und geben Sie eine addTable -Anfrage an. Mit dieser Anfrage fügen Sie der Tabelle eine Tabelle hinzu.

Im folgenden Beispiel wird im angegebenen range eine Tabelle mit dem Namen „Project Tracker“ mit zwei festgelegten Spalten erstellt. Eine Prozentangabe in der ersten Spalte und ein Drop-down-Spaltentyp in der zweiten Spalte.

{
  "addTable": {
    "table": {
      "name": "Project Tracker",
      "tableId": "123",
      "range": {
        "sheetId": 0,
        "startColumnIndex": 0,
        "endColumnIndex": 5,
        "startRowIndex": 0,
        "endRowIndex": 5,
      },
      "columnProperties": [
        {
          "columnIndex": 0,
          "columnName": "Column 1",
          "columnType": "PERCENT"
        },
        {
          "columnIndex": 1,
          "columnName": "Column 2",
          "columnType": "DROPDOWN",
          "dataValidationRule": {
            "condition": {
              "type": "ONE_OF_LIST",
              "values": [
                {
                  "userEnteredValue": "Not Started"
                },
                {
                  "userEnteredValue": "In Progress"
                },
                {
                  "userEnteredValue": "Complete"
                }
              ]
            }
          }
        }
      ],
    }
  }
}

Spaltentypen

Tabellen haben Spaltentypen wie „Numerisch“, „Datum“, „Drop-down-Menü“, „Smart-Chip“ und „Kontrollkästchen“. Die Spaltentypen „Bewertung“ und „Kontrollkästchen“ werden mit den Standardwerten 0 bzw. FALSE gefüllt.

Mit dem Spaltentyp „Drop-down-Menü“ wird ein Drop-down-Menü für Chips erstellt. Wenn ein Spaltentyp als Drop-down-Menü festgelegt ist, muss die dataValidationRule für die Spalte mit einer ONE_OF_LIST-Bedingung festgelegt werden. Bei anderen Spaltentypen sollte das Feld `dataValidationRule` nicht festgelegt werden.

Tabellen aktualisieren

Verwenden Sie die spreadsheets.batchUpdate Methode und geben Sie eine UpdateTableRequest an.

Tabellengröße ändern

Verwenden Sie die UpdateTableRequest Methode, um den range zu ändern, in dem die Tabelle neue Zeilen/Spalten hinzufügen muss.

Wenn Sie in der Tabelle eine neue Zeile oder Spalte hinzufügen möchten, verwenden Sie die InsertRangeRequest oder die InsertDimensionRequest

Wenn Sie eine Tabellenzeile löschen möchten, können Sie DeleteRangeRequest verwenden. Andernfalls können Sie mit DeleteDimensionRequest eine ganze Zeile aus der Tabelle löschen.

Wenn Sie eine vorhandene Tabelle ohne Fußzeile aktualisieren, um eine Fußzeile hinzuzufügen, wird der range um eine Zeile erweitert. Wenn Sie eine vorhandene Tabelle mit einer Fußzeile aktualisieren und die Fußzeile entfernen, wird der range um eine Zeile verkleinert.

Werte an eine Tabelle anhängen

Verwenden Sie AppendCellsRequest mit tableId, um Zeilen am Ende einer Tabelle hinzuzufügen. Dadurch werden die Werte an die erste kostenlose Zeile angehängt. Dabei werden vollständige Zeilen und Fußzeilen berücksichtigt. Wenn keine leeren Zeilen vorhanden sind, werden Zeilen am Ende der Tabelle und gegebenenfalls vor einer Fußzeile eingefügt.

Tabellen löschen

Verwenden Sie die spreadsheets.batchUpdate Methode und geben Sie eine DeleteTableRequest an. Mit DeleteTableRequest können Sie die gesamte Tabelle und ihren Inhalt löschen.

Mit DeleteBandingRequest können Sie die Tabellenformatierung entfernen, die Daten aber beibehalten.

Tabellen mit anderen Sheets-Funktionen verwenden

Andere API-Funktionen, die Tabellen als zugrunde liegende Daten unterstützen, sind Filter, Filteransichten und geschützte Bereiche.