Zeilen- und Spaltenvorgänge

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 gezeigt, wie Sie mit der 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 gezeigt, wie Sie mit der 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 gezeigt, wie Sie mit der 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 Blattes.

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 gezeigt, wie Sie mit der 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 Blattes.

Bei "true" weist das Feld inheritFromBefore die Sheets API an, haben die neuen Spalten oder Zeilen dieselben Eigenschaften wie die vorherige Zeile oder Spalte. falsch, 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
      }
    },
  ],
}