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 in einem Codebeispiel gezeigt, wie Sie
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 in einem Codebeispiel gezeigt, wie Sie
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 in einem Codebeispiel gezeigt, wie Sie
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 den
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
}
},
...
],
}