Google-Tabelle
Ein Tabellenblatt in einer Tabellenkalkulation.
JSON-Darstellung |
---|
{ "properties": { object ( |
Felder | |
---|---|
properties
|
Die Eigenschaften des Tabellenblatts. |
data[]
|
Daten im Raster, wenn es sich um ein Rasterblatt handelt.
Die Anzahl der zurückgegebenen GridData-Objekte hängt von der Anzahl der auf diesem Tabellenblatt angeforderten Bereiche ab. Wenn dies beispielsweise
Bei einer |
merges[]
|
Die Bereiche, die zusammengeführt werden. |
conditionalFormats[]
|
Die Regeln für die bedingte Formatierung in diesem Tabellenblatt. |
filterViews[]
|
Die Filteransichten in diesem Tabellenblatt. |
protectedRanges[]
|
Die geschützten Bereiche in diesem Tabellenblatt. |
basicFilter
|
Der Filter auf diesem Tabellenblatt, falls vorhanden. |
charts[]
|
Die Spezifikationen für jedes Diagramm auf diesem Tabellenblatt. |
bandedRanges[]
|
Die Bereiche mit Streifen (abwechselnde Farben) in dieser Tabelle. |
developerMetadata[]
|
Die mit einem Tabellenblatt verknüpften Entwicklermetadaten. |
rowGroups[]
|
Alle Zeilengruppen auf diesem Tabellenblatt, sortiert nach Erhöhen des Bereichsstartindex und dann nach Gruppentiefe. |
columnGroups[]
|
Alle Spaltengruppen auf diesem Tabellenblatt, sortiert nach Erhöhen des Bereichsstartindex und dann nach Gruppentiefe. |
slicers[]
|
Die Segmentierungstools auf diesem Tabellenblatt. |
SheetProperties
Eigenschaften eines Tabellenblatts
JSON-Darstellung |
---|
{ "sheetId": integer, "title": string, "index": integer, "sheetType": enum ( |
Felder | |
---|---|
sheetId
|
Die ID des Tabellenblatts. Darf nicht negativ sein. Dieses Feld kann nach der Festlegung nicht mehr geändert werden. |
title
|
Der Name des Tabellenblatts. |
index
|
Der Index des Tabellenblatts in der Tabelle. Wenn Sie Tabelleneigenschaften hinzufügen oder aktualisieren und dieses Feld ausschließen, wird das Tabellenblatt ans Ende der Tabellenliste verschoben oder hinzugefügt. Bei der Aktualisierung von Blattindizes oder beim Einfügen von Tabellenblättern wird Bewegung als "vor dem Verschieben"-Index betrachtet. Wenn es beispielsweise drei Tabellen (Tabelle 1, Tabelle 2, Tabelle 3) gibt, muss der Index auf 2 gesetzt werden, um Tabelle 1 vor Tabelle 2 zu verschieben. Eine Anfrage zum Aktualisieren des Tabellenindexes wird ignoriert, wenn der angeforderte Index mit dem aktuellen Index der Tabelle identisch ist oder wenn der angeforderte neue Index dem aktuellen Tabellenindex + 1 entspricht. |
sheetType
|
Der Typ des Tabellenblatts. Die Standardeinstellung ist |
gridProperties
|
Zusätzliche Eigenschaften des Tabellenblatts, wenn es sich um ein Raster handelt. Wenn es sich bei dem Tabellenblatt um ein Objektblatt mit einem Diagramm oder Bild handelt, ist dieses Feld nicht vorhanden. Beim Schreiben ist es ein Fehler, Rastereigenschaften auf Blättern ohne Raster festzulegen.
Wenn es sich bei dieser Tabelle um eine |
tabColor
|
Die Farbe des Tabs in der Benutzeroberfläche. Verworfen: Verwende |
tabColorStyle
|
Die Farbe des Tabs auf der Benutzeroberfläche. Wenn auch |
rightToLeft
|
Wahr, wenn das Blatt ein RTL- statt eines LTR-Blatts ist. |
dataSourceSheetProperties
|
Nur Ausgabe. Wenn vorhanden, enthält das Feld |
SheetType
Die Art des Tabellenblatts.
Enums | |
---|---|
SHEET_TYPE_UNSPECIFIED
|
Standardwert, nicht verwenden |
GRID
|
Das Blatt ist ein Raster. |
OBJECT
|
Das Tabellenblatt hat kein Raster, sondern ein Objekt wie ein Diagramm oder ein Bild. |
DATA_SOURCE
|
Das Tabellenblatt wird mit einer externen DataSource verbunden und zeigt eine Datenvorschau an.
|
GridProperties
Eigenschaften eines Rasters.
JSON-Darstellung |
---|
{ "rowCount": integer, "columnCount": integer, "frozenRowCount": integer, "frozenColumnCount": integer, "hideGridlines": boolean, "rowGroupControlAfter": boolean, "columnGroupControlAfter": boolean } |
Felder | |
---|---|
rowCount
|
Die Anzahl der Zeilen im Raster. |
columnCount
|
Die Anzahl der Spalten im Raster. |
frozenRowCount
|
Die Anzahl der Zeilen, die im Raster fixiert sind. |
frozenColumnCount
|
Die Anzahl der Spalten, die im Raster fixiert sind. |
hideGridlines
|
„True“, wenn für das Raster keine Rasterlinien in der Benutzeroberfläche angezeigt werden. |
rowGroupControlAfter
|
„Wahr“, wenn die Ein/Aus-Schaltfläche für die Zeilengruppierung nach der Gruppe angezeigt wird. |
columnGroupControlAfter
|
Dieser Wert ist „True“, wenn die Ein/Aus-Schaltfläche für die Steuerung der Spaltengruppierung nach der Gruppe angezeigt wird. |
DataSourceSheetProperties
Zusätzliche Eigenschaften eines DATA_SOURCE
-Tabellenblatts.
JSON-Darstellung |
---|
{ "dataSourceId": string, "columns": [ { object ( |
Felder | |
---|---|
dataSourceId
|
ID der |
columns[]
|
Die Spalten auf dem Tabellenblatt, die den Werten in |
dataExecutionStatus
|
Der Status der Datenausführung. |
GridData
Daten im Raster sowie Metadaten zu den Dimensionen.
JSON-Darstellung |
---|
{ "startRow": integer, "startColumn": integer, "rowData": [ { object ( |
Felder | |
---|---|
startRow
|
Die erste Zeile, auf die sich diese GridData beziehen, beginnend mit null. |
startColumn
|
Die erste Spalte, auf die sich diese GridData beziehen, beginnend mit null. |
rowData[]
|
Die Daten im Raster, ein Eintrag pro Zeile, beginnend mit der Zeile in startRow. Die Werte in „RowData“ entsprechen den Spalten ab |
rowMetadata[]
|
Metadaten zu den angeforderten Zeilen im Raster, beginnend mit der Zeile in |
columnMetadata[]
|
Metadaten zu den angeforderten Spalten im Raster, beginnend mit der Spalte in |
RowData
Daten zu jeder Zelle in einer Zeile.
JSON-Darstellung |
---|
{
"values": [
{
object ( |
Felder | |
---|---|
values[]
|
Die Werte in der Zeile, einer pro Spalte. |
DimensionProperties
Eigenschaften einer Dimension.
JSON-Darstellung |
---|
{ "hiddenByFilter": boolean, "hiddenByUser": boolean, "pixelSize": integer, "developerMetadata": [ { object ( |
Felder | |
---|---|
pixelSize
|
Die Höhe (bei einer Zeile) oder Breite (bei einer Spalte) der Dimension in Pixeln. |
developerMetadata[]
|
Die Entwicklermetadaten, die mit einer einzelnen Zeile oder Spalte verknüpft sind. |
dataSourceColumnReference
|
Nur Ausgabe. Wenn festgelegt, ist dies eine Spalte in einem Datenquellentabellenblatt. |
ConditionalFormatRule
Eine Regel, die eine bedingte Formatierung beschreibt.
JSON-Darstellung |
---|
{ "ranges": [ { object ( |
Felder | |
---|---|
ranges[]
|
Die Bereiche, die formatiert werden, wenn die Bedingung erfüllt ist. Alle Bereiche müssen sich im selben Raster befinden. |
Union-Feld
rule . Für die Regel, die diese bedingte Formatierung steuert, muss genau eine festgelegt werden.
Für rule ist nur einer der folgenden Werte zulässig:
|
|
booleanRule
|
Die Formatierung ist gemäß der Regel entweder „an“ oder „aus“. |
gradientRule
|
Die Formatierung variiert je nach Farbverlauf in der Regel. |
BooleanRule
Eine Regel, die je nach Bedingung übereinstimmen kann oder nicht.
JSON-Darstellung |
---|
{ "condition": { object ( |
Felder | |
---|---|
condition
|
Die Bedingung der Regel. Wenn die Bedingung als wahr ausgewertet wird, wird das Format angewendet. |
format
|
Das anzuwendende Format. Bei der bedingten Formatierung kann nur ein Teil der Formatierung angewendet werden: |
GradientRule
Eine Regel, die ein Farbverlaufsformat auf der Grundlage der aufgeführten Interpolationspunkte anwendet. Das Format einer Zelle hängt vom Inhalt im Vergleich zu den Werten der Interpolationspunkte ab.
JSON-Darstellung |
---|
{ "minpoint": { object ( |
Felder | |
---|---|
minpoint
|
Der Startpunkt der Interpolation. |
midpoint
|
Optionaler Interpolationspunkt in der Mitte |
maxpoint
|
Der letzte Interpolationspunkt. |
InterpolationPoint
Ein einzelner Interpolationspunkt in einem bedingten Farbverlaufsformat. Damit wird die Farbskala des Farbverlaufs entsprechend der ausgewählten Farbe, dem Typ und dem Wert angepinnt.
JSON-Darstellung |
---|
{ "color": { object ( |
Felder | |
---|---|
color
|
Die Farbe, die dieser Interpolationspunkt verwenden soll. Verworfen: Verwende |
colorStyle
|
Die Farbe, die für diesen Interpolationspunkt verwendet werden soll. Wenn auch |
type
|
Wie der Wert interpretiert werden soll. |
value
|
Der Wert, den dieser Interpolationspunkt verwendet. Kann eine Formel sein. Nicht verwendet, wenn |
InterpolationPointType
Die Art des Interpolationspunkts.
Enums | |
---|---|
INTERPOLATION_POINT_TYPE_UNSPECIFIED
|
Der Standardwert, nicht verwenden. |
MIN
|
Für den Interpolationspunkt wird der Mindestwert in den Zellen im Bereich des bedingten Formats verwendet. |
MAX
|
Für den Interpolationspunkt wird der Maximalwert in den Zellen im Bereich des bedingten Formats verwendet. |
NUMBER
|
Für den Interpolationspunkt wird genau der Wert in InterpolationPoint.value verwendet.
|
PERCENT
|
Der Interpolationspunkt ist der angegebene Prozentsatz für alle Zellen im Bereich des bedingten Formats. Das entspricht |
PERCENTILE
|
Der Interpolationspunkt ist das gegebene Perzentil für alle Zellen im Bereich des bedingten Formats. Das entspricht NUMBER , wenn der Wert =PERCENTILE(FLATTEN(range), value / 100) war. Fehler im Bereich werden beim Zusammenführen ignoriert.
|
FilterView
Filteransicht
JSON-Darstellung |
---|
{ "filterViewId": integer, "title": string, "range": { object ( |
Felder | |
---|---|
filterViewId
|
Die ID der Filteransicht. |
title
|
Der Name der Filteransicht. |
range
|
Der Bereich, den diese Filteransicht abdeckt.
Beim Schreiben kann nur entweder |
namedRangeId
|
Der benannte Bereich, unter dem diese Filteransicht basiert, falls vorhanden.
Beim Schreiben kann nur eines von |
sortSpecs[]
|
Die Sortierreihenfolge pro Spalte. Spätere Spezifikationen werden verwendet, wenn die Werte in den früheren Spezifikationen übereinstimmen. |
criteria
|
Die Kriterien zum Ein-/Ausblenden von Werten pro Spalte. Der Schlüssel der Karte ist der Spaltenindex und der Wert ist das Kriterium für diese Spalte.
Dieses Feld wird zugunsten von |
filterSpecs[]
|
Die Filterkriterien für das Ein-/Ausblenden von Werten pro Spalte.
Sowohl |
ProtectedRange
Ein geschützter Bereich.
JSON-Darstellung |
---|
{ "protectedRangeId": integer, "range": { object ( |
Felder | |
---|---|
protectedRangeId
|
Die ID des geschützten Bereichs. Dieses Feld ist schreibgeschützt. |
range
|
Der geschützte Bereich. Der Bereich kann auch vollständig unbegrenzt sein. In diesem Fall wird das Tabellenblatt als geschützt betrachtet.
Beim Schreiben kann nur eines von |
namedRangeId
|
Der benannte Bereich, auf dem dieser geschützte Bereich basiert, falls zutreffend.
Beim Schreiben kann nur eines von |
description
|
Die Beschreibung dieses geschützten Bereichs. |
warningOnly
|
„Wahr“, wenn bei der Bearbeitung dieses geschützten Bereichs eine Warnung angezeigt wird. Der warnungsbasierte Schutz bedeutet, dass jeder Nutzer Daten im geschützten Bereich bearbeiten kann. Beim Bearbeiten wird jedoch eine Warnung angezeigt, in der der Nutzer aufgefordert wird, die Änderung zu bestätigen.
Beim Schreiben: Wenn dieses Feld wahr ist, werden |
requestingUserCanEdit
|
„True“, wenn der Nutzer, der diesen geschützten Bereich angefordert hat, ihn bearbeiten kann. Dieses Feld ist schreibgeschützt. |
unprotectedRanges[]
|
Die Liste der nicht geschützten Bereiche in einem geschützten Tabellenblatt. Nicht geschützte Bereiche werden nur in geschützten Tabellenblättern unterstützt. |
editors
|
Die Nutzer und Gruppen mit Bearbeitungszugriff auf den geschützten Bereich. Dieses Feld ist nur für Nutzer mit Bearbeitungszugriff auf den geschützten Bereich und das Dokument sichtbar. Bearbeiter werden bei |
Bearbeiter
Die Mitbearbeiter eines geschützten Bereichs.
JSON-Darstellung |
---|
{ "users": [ string ], "groups": [ string ], "domainUsersCanEdit": boolean } |
Felder | |
---|---|
users[]
|
Die E-Mail-Adressen der Nutzer mit Bearbeitungszugriff auf den geschützten Bereich. |
groups[]
|
Die E-Mail-Adressen von Gruppen mit Bearbeitungszugriff auf den geschützten Bereich. |
domainUsersCanEdit
|
„Wahr“, wenn alle Nutzer in der Domain des Dokuments Bearbeitungszugriff auf den geschützten Bereich haben. Der Domainschutz wird nur für Dokumente innerhalb einer Domain unterstützt. |
BasicFilter
Der Standardfilter, der mit einem Tabellenblatt verknüpft ist.
JSON-Darstellung |
---|
{ "range": { object ( |
Felder | |
---|---|
range
|
Der Bereich, den der Filter abdeckt. |
sortSpecs[]
|
Die Sortierreihenfolge pro Spalte. Spätere Spezifikationen werden verwendet, wenn die Werte in den früheren Spezifikationen übereinstimmen. |
criteria
|
Die Kriterien zum Ein-/Ausblenden von Werten pro Spalte. Der Schlüssel der Karte ist der Spaltenindex und der Wert ist das Kriterium für diese Spalte.
Dieses Feld wird zugunsten von |
filterSpecs[]
|
Die Filterkriterien pro Spalte.
Sowohl |
BandedRange
Ein Bereich in einem Tabellenblatt mit abwechselnden Farben
JSON-Darstellung |
---|
{ "bandedRangeId": integer, "range": { object ( |
Felder | |
---|---|
bandedRangeId
|
Die ID des Bereichs mit Farbbändern. |
range
|
Der Bereich, auf den diese Eigenschaften angewendet werden. |
rowProperties
|
Eigenschaften für Zeilenbänder. Diese Eigenschaften werden zeilenweise auf alle Zeilen im Bereich angewendet. Es muss mindestens |
columnProperties
|
Eigenschaften für Spaltenbänder. Diese Eigenschaften werden spaltenweise auf alle Spalten im Bereich angewendet. Es muss entweder |
BandingProperties
Eigenschaften, die sich auf eine einzelne Dimension beziehen (entweder Zeile oder Spalte) Wenn sowohl BandedRange.row_properties
als auch BandedRange.column_properties
festgelegt sind, werden die Füllfarben gemäß den folgenden Regeln auf Zellen angewendet:
-
headerColor
undfooterColor
haben Vorrang vor Bandfarben. -
firstBandColor
hat Vorrang vorsecondBandColor
. -
rowProperties
hat Vorrang vorcolumnProperties
.
Die Farbe der ersten Zeile hat beispielsweise Vorrang vor der Farbe der ersten Spalte, die Farbe der ersten Spalte hat jedoch Vorrang vor der Farbe der zweiten Zeile. Ebenso hat die Zeilenüberschrift Vorrang vor der Spaltenüberschrift in der linken oberen Zelle, aber die Spaltenüberschrift hat Vorrang vor der Farbe der ersten Zeile, wenn keine Zeilenüberschrift festgelegt ist.
JSON-Darstellung |
---|
{ "headerColor": { object ( |
Felder | |
---|---|
headerColor
|
Die Farbe der ersten Zeile oder Spalte. Wenn dieses Feld festgelegt ist, wird die erste Zeile oder Spalte mit dieser Farbe ausgefüllt. Ab der zweiten Zeile oder Spalte wechseln die Farben zwischen |
headerColorStyle
|
Die Farbe der ersten Zeile oder Spalte. Wenn dieses Feld festgelegt ist, wird die erste Zeile oder Spalte mit dieser Farbe gefüllt. Ab der zweiten Zeile oder Spalte wechseln die Farben zwischen |
firstBandColor
|
Die erste Farbe, die abwechselnd verwendet wird. (Erforderlich) Verworfen: Verwenden Sie stattdessen |
firstBandColorStyle
|
Die erste Farbe, die abwechselnd verwendet wird. (Erforderlich) Wenn |
secondBandColor
|
Die zweite abwechselnde Farbe. (Erforderlich) Verworfen: Verwenden Sie stattdessen |
secondBandColorStyle
|
Die zweite abwechselnde Farbe. (Erforderlich) Wenn |
footerColor
|
Die Farbe der letzten Zeile oder Spalte. Wenn dieses Feld nicht festgelegt ist, wird die letzte Zeile oder Spalte je nach Farbe der vorherigen Zeile oder Spalte mit |
footerColorStyle
|
Die Farbe der letzten Zeile oder Spalte. Wenn dieses Feld nicht festgelegt ist, wird die letzte Zeile oder Spalte je nach Farbe der vorherigen Zeile oder Spalte mit |
DimensionGroup
Eine Gruppe über ein Zeilen- oder Spaltenintervall auf einem Tabellenblatt, die andere Gruppen enthalten kann oder von anderen Gruppen enthalten wird. Eine Gruppe kann auf dem Tabellenblatt als Einheit minimiert oder maximiert werden.
JSON-Darstellung |
---|
{
"range": {
object ( |
Felder | |
---|---|
range
|
Der Bereich, in dem diese Gruppe vorhanden ist. |
depth
|
Die Tiefe der Gruppe, d. h. wie viele Gruppen einen Bereich haben, der den Bereich dieser Gruppe vollständig enthält. |
collapsed
|
Dieses Feld ist auf „true“ gesetzt, wenn diese Gruppe minimiert ist. Eine minimierte Gruppe bleibt minimiert, wenn eine überlappende Gruppe mit geringerer Tiefe maximiert wird. Ein wahrer Wert bedeutet nicht, dass alle Dimensionen innerhalb der Gruppe ausgeblendet sind, da sich die Sichtbarkeit einer Dimension unabhängig von dieser Gruppeneigenschaft ändern kann. Wenn diese Property jedoch aktualisiert wird, werden alle darin enthaltenen Dimensionen ausgeblendet, wenn dieses Feld den Wert „wahr“ hat, oder sichtbar, wenn es den Wert „falsch“ hat. |
Datenschnitt
Ein Datenschnitt in einem Tabellenblatt.
JSON-Darstellung |
---|
{ "slicerId": integer, "spec": { object ( |
Felder | |
---|---|
slicerId
|
Die ID des Sprengschnitts. |
spec
|
Die Spezifikation des Datenschnitts. |
position
|
Die Position des Slicings. Der Datenschnitt kann nur auf einem vorhandenen Tabellenblatt positioniert werden. Außerdem können Breite und Höhe des Slicings automatisch angepasst werden, damit sie innerhalb der zulässigen Limits bleiben. |
SlicerSpec
Die Spezifikationen eines Datenschnitts.
JSON-Darstellung |
---|
{ "dataRange": { object ( |
Felder | |
---|---|
dataRange
|
Der Datenbereich des Datenschnitts. |
filterCriteria
|
Die Filterkriterien des Sprengschnitts. |
columnIndex
|
Der nullbasierte Spaltenindex in der Datentabelle, auf die der Filter angewendet wird. |
applyToPivotTables
|
„True“, wenn der Filter auf Pivot-Tabellen angewendet werden soll. Wenn nicht festgelegt, wird standardmäßig |
title
|
Der Titel des Sliziers. |
textFormat
|
Das Textformat des Titels im Datenschnitt. Das Link-Feld wird nicht unterstützt. |
backgroundColor
|
Die Hintergrundfarbe des Sprengschnitts. Verworfen: Verwende |
backgroundColorStyle
|
Die Hintergrundfarbe des Sprengschnitts. Wenn |
horizontalAlignment
|
Die horizontale Ausrichtung des Titels im Sliver. Wenn keine Angabe gemacht wird, wird standardmäßig |