Tabellenvorgänge

Mit der Google Sheets API können Sie Tabellen erstellen, löschen, kopieren und löschen sowie ihre Eigenschaften zu steuern. Die Beispiele auf dieser Seite veranschaulichen, wie Sie gemeinsame Vorgänge mit der Sheets API

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.

Tabellenblatt hinzufügen

Die folgenden spreadsheets.batchUpdate wird gezeigt, wie Sie mit der AddSheetRequest um ein Tabellenblatt hinzuzufügen und gleichzeitig den Titel, die Rastergröße Tab-Farbe.

Die Antwort besteht aus einem AddSheetResponse, enthält ein -Objekt mit den Eigenschaften des erstellten Tabellenblatts (z. B. SHEET_ID.

Das Anfrageprotokoll ist unten zu sehen.

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

{
  "requests": [
    {
      "addSheet": {
        "properties": {
          "title": "Deposits",
          "gridProperties": {
            "rowCount": 20,
            "columnCount": 12
          },
          "tabColor": {
            "red": 1.0,
            "green": 0.3,
            "blue": 0.4
          }
        }
      }
    }
  ]
}

Alle Werte aus einem Tabellenblatt löschen und die Formate beibehalten

Die folgenden spreadsheets.batchUpdate wird gezeigt, wie Sie mit der UpdateCellsRequest , um alle Werte aus einem Tabellenblatt zu entfernen und die Formatierung beizubehalten.

Angabe des Feld userEnteredValue ohne entsprechenden Wert wird als Anweisung zum Löschen von Werten interpretiert im Bereich. Diese Einstellung kann auch mit anderen Feldern verwendet werden. Beispiel: Ändern des Werts fields zu Von userEnteredFormat entfernt alle von der Sheets API unterstützten Formatierungen aus dem Tabellenblatt entfernt, aber die Zellenwerte bleiben unverändert.

Das Anfrageprotokoll ist unten zu sehen.

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

{
  "requests": [
    {
      "updateCells": {
        "range": {
          "sheetId": SHEET_ID
        },
        "fields": "userEnteredValue"
      }
    }
  ]
}

Tabellenblatt aus einer Tabelle in eine andere kopieren

Die folgenden spreadsheet.sheets.copyTo Codebeispiel zeigt, wie ein einzelnes Tabellenblatt kopiert wird, das durch SHEET_ID angegeben wurde von einer Tabellenkalkulation in eine andere.

Die Variable TARGET_SPREADSHEET_ID im Anfragetext gibt die Zieltabelle. Die Kopie behält alle Werte, Formatierungen, Formeln und anderen Eigenschaften des Originals. Der Titel des kopierten Tabellenblatts lautet von [Titel der Originaltabelle]".

Die Antwort besteht aus einem SheetProperties -Objekt, das die Eigenschaften des erstellten Tabellenblatts beschreibt.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/sheets/SHEET_ID:copyTo

{
  "destinationSpreadsheetId": "TARGET_SPREADSHEET_ID"
}

Tabellenblätter löschen

Die folgenden spreadsheets.batchUpdate wird gezeigt, wie Sie mit der DeleteSheetRequest , um ein durch SHEET_ID angegebenes Tabellenblatt zu löschen.

Das Anfrageprotokoll ist unten zu sehen.

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

{
  "requests": [
    {
      "deleteSheet": {
        "sheetId": SHEET_ID
      }
    }
  ]
}

Tabellenblattdaten lesen

Die folgenden spreadsheets.get-Codebeispiel zeigt, wie Informationen zu Eigenschaften von Tabellenblatt abgerufen werden aus einer Tabelle gemäß SHEET_ID und SPREADSHEET_ID. Diese Methode wird häufig verwendet, um die Metadaten von Tabellenblättern in einer bestimmten Tabellenkalkulation, sodass zusätzliche Vorgänge die Ausrichtung auf diese Tabellenblätter. Der Abfrageparameter fields gibt nur die Tabelleneigenschaft an. Daten zurückgegeben werden sollen (im Gegensatz zu Zellenwertdaten oder Daten, die sich auf gesamte Tabelle).

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID?&fields=sheets.properties

Die Antwort besteht aus einem Spreadsheet Ressource mit einem Sheet-Objekt mit SheetProperties Elemente. Wenn ein bestimmtes Antwortfeld auf den Standardwert festgelegt ist, wird es ausgelassen, aus der Antwort.

{
  "sheets": [
    {
      "properties": {
        "sheetId": SHEET_ID,
        "title": "Sheet1",
        "index": 0,
        "sheetType": "GRID",
        "gridProperties": {
          "rowCount": 100,
          "columnCount": 20,
          "frozenRowCount": 1
        }
        "tabColor": {
          "blue": 1.0
        }
      },
      ...
  ],
}