Mit der Google Sheets API können Sie die Formatierung von Zellen und Bereichen aktualisieren in Tabellenkalkulationen. Anhand der Beispiele auf dieser Seite wird veranschaulicht, sind mit der Sheets API möglich. Sie können Beispiele für bedingte Formatierungen Rezeptseite.
Beim Aktualisieren einer Tabelle können bei einigen Arten von Anfragen Antworten zurückgegeben werden.
Diese werden in einem Array zurückgegeben, wobei jede Antwort den gleichen Index wie
der entsprechenden Anfrage. Für einige Anfragen gibt es keine Antworten.
Antwort ist leer. Die Antwortstruktur für diese Beispiele finden Sie unter
spreadsheets.batchUpdate
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.
Im obigen Video erfahren Sie, wie Sie Zellen in Tabellenkalkulationen auf verschiedene wie z. B.: Fixierte Zeilen erstellen, Zellen fett formatieren, Währungscode implementieren Formatieren, Validieren und Einschränken von Zellenwerten.
Zellenrahmen bearbeiten
Die folgenden
spreadsheets.batchUpdate
wird gezeigt, wie Sie mit der
UpdateBordersRequest
um jeder Zelle im Bereich A1:F10 einen gestrichelten blauen Rahmen zu geben. Die
Mit dem Feld innerHorizontal
wird der Bereich innerhalb des Bereichs horizontal mit Rahmenlinien versehen.
Wenn Sie das Feld auslassen, werden nur die Rahmen oben und
des gesamten Bereichs.
Das Anfrageprotokoll ist unten zu sehen.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{ "requests": [ { "updateBorders": { "range": { "sheetId": SHEET_ID, "startRowIndex": 0, "endRowIndex": 10, "startColumnIndex": 0, "endColumnIndex": 6 }, "top": { "style": "DASHED", "width": 1, "color": { "blue": 1.0 }, }, "bottom": { "style": "DASHED", "width": 1, "color": { "blue": 1.0 }, }, "innerHorizontal": { "style": "DASHED", "width": 1, "color": { "blue": 1.0 }, }, } } ] }
Kopfzeile formatieren
Die folgenden
spreadsheets.batchUpdate
wird gezeigt, wie Sie mit der
RepeatCellRequest
um eine Kopfzeile in einem Tabellenblatt zu formatieren. Die erste Anforderung aktualisiert die Textfarbe, den
die Hintergrundfarbe, die Schriftgröße und die Ausrichtung.
Text fett. Das Weglassen der Spaltenindexe im Feld range
führt dazu, dass die gesamte
Zeile, die formatiert werden soll. Mit der zweiten Anfrage werden die Blatteigenschaften so angepasst,
Kopfzeile ist fixiert.
Das Anfrageprotokoll ist unten zu sehen.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{ "requests": [ { "repeatCell": { "range": { "sheetId": SHEET_ID, "startRowIndex": 0, "endRowIndex": 1 }, "cell": { "userEnteredFormat": { "backgroundColor": { "red": 0.0, "green": 0.0, "blue": 0.0 }, "horizontalAlignment" : "CENTER", "textFormat": { "foregroundColor": { "red": 1.0, "green": 1.0, "blue": 1.0 }, "fontSize": 12, "bold": true } } }, "fields": "userEnteredFormat(backgroundColor,textFormat,horizontalAlignment)" } }, { "updateSheetProperties": { "properties": { "sheetId": SHEET_ID, "gridProperties": { "frozenRowCount": 1 } }, "fields": "gridProperties.frozenRowCount" } } ] }
Zellen verbinden
Die folgenden
spreadsheets.batchUpdate
wird gezeigt, wie Sie mit der
MergeCellsRequest
um Zellen zu verbinden. In der ersten Anforderung wird der A1:B2-Bereich zu einer einzigen Zelle zusammengeführt. Die
In der zweiten Anfrage werden die Spalten in A3:B6 zusammengeführt, wobei die Zeilen getrennt bleiben.
Das Anfrageprotokoll ist unten zu sehen.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{ "requests": [ { "mergeCells": { "range": { "sheetId": SHEET_ID, "startRowIndex": 0, "endRowIndex": 2, "startColumnIndex": 0, "endColumnIndex": 2 }, "mergeType": "MERGE_ALL" } }, { "mergeCells": { "range": { "sheetId": SHEET_ID, "startRowIndex": 2, "endRowIndex": 6, "startColumnIndex": 0, "endColumnIndex": 2 }, "mergeType": "MERGE_COLUMNS" } }, ] }
Benutzerdefiniertes Datums- oder Dezimalformat für einen Bereich festlegen
Die folgenden
spreadsheets.batchUpdate
wird gezeigt, wie Sie mit der
RepeatCellRequest
, um Zellen mit benutzerdefinierten Datums- und Zahlenformaten zu aktualisieren. Die erste Anfrage
gibt den Zellen im Bereich A1:A10 das benutzerdefinierte Datum/Uhrzeit-Format hh:mm:ss am/pm,
ddd mmm dd yyyy
an. Ein Beispiel für Datum/Uhrzeit in diesem Format ist: "02:05:07 PM, Sun Apr.
03 2016".
In der zweiten Anfrage erhalten die Zellen in B1:B10 das benutzerdefinierte Zahlenformat.
#,##0.0000
, was angibt, dass Zahlen mit einem Komma gruppiert werden sollen
Trennzeichen eingeben, dass nach dem Dezimaltrennzeichen 4 Ziffern stehen und dass nur
dass eine führende Null
entfernt werden sollte. Zum Beispiel die Zahl „3, 14“ wird gerendert
als „3.1400“ und „12345.12345“ wird als „12,345.1235“ gerendert.
Das Anfrageprotokoll ist unten zu sehen.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{ "requests": [ { "repeatCell": { "range": { "sheetId": SHEET_ID, "startRowIndex": 0, "endRowIndex": 10, "startColumnIndex": 0, "endColumnIndex": 1 }, "cell": { "userEnteredFormat": { "numberFormat": { "type": "DATE", "pattern": "hh:mm:ss am/pm, ddd mmm dd yyyy" } } }, "fields": "userEnteredFormat.numberFormat" } }, { "repeatCell": { "range": { "sheetId": SHEET_ID, "startRowIndex": 0, "endRowIndex": 10, "startColumnIndex": 1, "endColumnIndex": 2 }, "cell": { "userEnteredFormat": { "numberFormat": { "type": "NUMBER", "pattern": "#,##0.0000" } } }, "fields": "userEnteredFormat.numberFormat" } } ] }