Zeilen- und Spaltenvorgänge

Mit der Google Sheets API können Sie Zeilen und Spalten in Tabellenblättern 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 präsentiert, um sprachneutral zu sein. Informationen zum Implementieren einer Batch-Aktualisierung 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 würden. Die Tabellen-ID finden Sie in der Tabellen-URL. Sie können die Tabellenblatt-ID mit der Methode spreadsheets.get abrufen. Die Bereiche werden mit der A1-Notation angegeben. Ein Beispielbereich ist Tabelle1!A1:D5.

Spaltenbreite oder Zeilenhöhe anpassen

Das folgende spreadsheets.batchUpdate-Codebeispiel zeigt, wie Sie mit UpdateDimensionPropertiesRequest die Breite der Spalte A auf 160 Pixel aktualisieren. Mit einer zweiten Anfrage wird die Zeilenhöheneigenschaft der ersten drei Zeilen auf 40 Pixel aktualisiert. Das Feld dimension bestimmt, ob sich der Vorgang auf die Spalten oder Zeilen eines Tabellenblatts bezieht.

Das Anfrageprotokoll wird unten angezeigt.

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. Beim ersten Aufruf werden drei leere Zeilen an das Ende eines Tabellenblatts angehängt, beim zweiten eine einzelne leere Spalte. Das Feld dimension bestimmt, ob sich der Vorgang auf die Spalten oder Zeilen eines Tabellenblatts bezieht.

Das Anfrageprotokoll wird unten angezeigt.

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 die Spalten A:C mithilfe von AutoResizeDimensionsRequest an die Größe des Spalteninhalts anpassen. Das Feld dimension gibt an, dass sich der Vorgang auf die Spalten des Tabellenblatts bezieht.

Das Anfrageprotokoll wird unten angezeigt.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "autoResizeDimensions": {
        "dimensions": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    }
  ]
}

Zeile 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 an den Inhalt der Zellen in jeder Zeile angepasst. Das Feld dimension gibt an, dass sich der Vorgang auf die Zeilen des Tabellenblatts bezieht.

Das Anfrageprotokoll wird unten angezeigt.

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 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 sich der Vorgang auf die Spalten oder Zeilen eines Tabellenblatts bezieht.

Das Anfrageprotokoll wird unten angezeigt.

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 einem bestimmten Index einfügen, z. B. um leere Zeilen am Anfang eines Tabellenblatts einzufügen. Bei der ersten Anfrage werden in Spalte C zwei leere Spalten eingefügt. Bei einer zweiten Anfrage werden ab Zeile 1 drei leere Zeilen eingefügt.

Das Feld dimension bestimmt, ob sich der Vorgang auf die Spalten oder Zeilen eines Tabellenblatts bezieht.

Wenn „true“ festgelegt ist, wird in der Sheets API für die neuen Spalten oder Zeilen dieselben Eigenschaften wie für die vorherige Zeile oder Spalte verwendet. Wenn „false“ festgelegt ist, werden die Eigenschaften von den Dimensionen nach den neuen Spalten oder Zeilen übernommen.inheritFromBefore inheritFromBefore kann nicht „true“ sein, wenn eine Zeile in Zeile 1 oder eine Spalte in Spalte A eingefügt wird.

Das Anfrageprotokoll wird unten angezeigt.

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 die Spalte A an die Position der Spalte D verschieben. Bei einer zweiten Anfrage werden die Zeilen 5–10 an die Position von Zeile 20 verschoben.

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

Das Anfrageprotokoll wird unten angezeigt.

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