Google-Tabelle
Ein Tabellenblatt in einer Tabellenkalkulation.
JSON-Darstellung |
---|
{ "properties": { object ( |
Felder | |
---|---|
properties
|
Die Eigenschaften des Tabellenblatts. |
data[]
|
Daten im Raster, wenn dies ein Rasterblatt ist.
Die Anzahl der zurückgegebenen GridData-Objekte hängt von der Anzahl der Bereiche ab, die auf diesem Tabellenblatt angefordert werden. Wenn dies z. B. für
Für eine
|
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 aller Diagramme auf diesem Blatt. |
bandedRanges[]
|
Die Bereiche mit Band (abwechselnde Farben) auf diesem Blatt. |
developerMetadata[]
|
Die mit einer Tabelle 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 Datenschnitte auf diesem Blatt. |
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 später nicht mehr geändert werden. |
title
|
Der Name des Tabellenblatts. |
index
|
Index des Tabellenblatts innerhalb der Tabelle. Wenn Sie beim Hinzufügen oder Aktualisieren von Tabellenblatteigenschaften dieses Feld ausschließen, wird das Tabellenblatt in der Liste hinzugefügt oder an das Ende der Tabellenblattliste verschoben. Beim Aktualisieren von Tabellenblattindizes oder beim Einfügen von Tabellenblättern wird Bewegung als "vor dem Verschieben" betrachtet. Indexe. Wenn es beispielsweise drei Tabellenblätter (S1, S2, S3) gäbe, um S1 vor S2 zu verschieben, müsste der Index auf 2 gesetzt werden. Eine Anfrage zur Aktualisierung des Tabellenblattindex wird ignoriert, wenn der angeforderte Index mit dem aktuellen Index der Tabellenblätter identisch ist oder wenn der angeforderte neue Index dem aktuellen Tabellenblattindex + 1 entspricht. |
sheetType
|
Der Typ des Tabellenblatts. Standardeinstellung:
|
gridProperties
|
Zusätzliche Eigenschaften des Tabellenblatts, wenn es sich bei diesem Tabellenblatt um ein Raster handelt. Wenn es sich bei dem Tabellenblatt um ein Objektblatt handelt, das ein Diagramm oder Bild enthält, ist dieses Feld nicht vorhanden. Beim Schreiben ist es ein Fehler, Rastereigenschaften auf rasterfreien Tabellenblättern festzulegen.
Wenn dieses Tabellenblatt
|
tabColor
|
Die Farbe des Tabs auf der Benutzeroberfläche. Eingestellt: Verwenden
|
tabColorStyle
|
Die Farbe des Tabs auf der Benutzeroberfläche. Wenn
|
rightToLeft
|
Wahr, wenn das Blatt ein RTL- statt eines LTR-Blatts ist. |
dataSourceSheetProperties
|
Nur Ausgabe. Falls 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
und zeigt eine Vorschau der Daten 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 im Raster fixierten Spalten. |
hideGridlines
|
"True", wenn das Raster in der Benutzeroberfläche keine Gitternetzlinien anzeigt. |
rowGroupControlAfter
|
„True“, 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
Tabellenblatt.
JSON-Darstellung |
---|
{ "dataSourceId": string, "columns": [ { object ( |
Felder | |
---|---|
dataSourceId
|
ID des
|
columns[]
|
Die auf dem Tabellenblatt angezeigten Spalten, 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 Grid-Daten beziehen, nullbasiert. |
startColumn
|
Die erste Spalte, auf die sich diese Grid-Daten beziehen, nullbasiert. |
rowData[]
|
Die Daten im Raster, ein Eintrag pro Zeile, beginnend mit der Zeile in startRow. Die Werte in RowData entsprechen den Spalten beginnend bei
|
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
Attribute zu einer Dimension.
JSON-Darstellung |
---|
{ "hiddenByFilter": boolean, "hiddenByUser": boolean, "pixelSize": integer, "developerMetadata": [ { object ( |
Felder | |
---|---|
pixelSize
|
Die Höhe (bei einer Zeile) oder die Breite (in einer Spalte) der Abmessung in Pixeln. |
developerMetadata[]
|
Die mit einer einzelnen Zeile oder Spalte verknüpften Entwicklermetadaten. |
dataSourceColumnReference
|
Nur Ausgabe. Wenn festgelegt, ist dies eine Spalte in einem Datenquellentabellenblatt. |
ConditionalFormatRule
Eine Regel, die ein bedingtes Format 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 Die Regel, die dieses bedingte Format steuert; genau eine muss festgelegt werden.
rule
kann nur einer der folgenden Werte sein:
|
|
booleanRule
|
Die Formatierung ist entweder „Ein“ oder „Aus“ entsprechend der Regel. |
gradientRule
|
Die Formatierung hängt von den Farbverläufen in der Regel ab. |
BooleanRule
Eine Regel, die je nach Bedingung möglicherweise erfüllt wird 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 Format, das angewendet werden soll. Bei bedingter Formatierung kann nur ein Teil der Formatierung angewendet werden:
|
GradientRule
Eine Regel, die ein Farbskalaformat für einen Farbverlauf auf Basis der aufgeführten Interpolationspunkte anwendet. Das Format einer Zelle richtet sich nach ihrem Inhalt im Vergleich zu den Werten der Interpolationspunkte.
JSON-Darstellung |
---|
{ "minpoint": { object ( |
Felder | |
---|---|
minpoint
|
Der Startinterpolationspunkt. |
midpoint
|
Ein optionaler Interpolationspunkt auf halber Strecke. |
maxpoint
|
Der letzte Interpolationspunkt. |
InterpolationPoint
Ein einzelner Interpolationspunkt in einem bedingten Gradientenformat. 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. Eingestellt: Verwenden
|
colorStyle
|
Die Farbe, die dieser Interpolationspunkt verwenden soll. Wenn
|
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
|
Standardwert, nicht verwenden. |
MIN
|
Der Interpolationspunkt verwendet den Minimalwert in den Zellen über den Bereich des bedingten Formats. |
MAX
|
Der Interpolationspunkt verwendet den Maximalwert in den Zellen über den Bereich des bedingten Formats. |
NUMBER
|
Der Interpolationspunkt verwendet genau den Wert in
InterpolationPoint.value
|
PERCENT
|
Der Interpolationspunkt ist der angegebene Prozentsatz für alle Zellen im Bereich des bedingten Formats. Dies entspricht
|
PERCENTILE
|
Der Interpolationspunkt ist das gegebene Perzentil für alle Zellen im Bereich des bedingten Formats. Dies entspricht
NUMBER
wenn der Wert:
=PERCENTILE(FLATTEN(range), value / 100)
(wobei Fehler im Bereich bei der Vereinfachung ignoriert werden).
|
FilterView
Eine 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 wird nur eine der
|
namedRangeId
|
Der benannte Bereich, unter dem diese Filteransicht basiert, falls vorhanden.
Beim Schreiben wird nur eine der
|
sortSpecs[]
|
Die Sortierreihenfolge pro Spalte. Spätere Spezifikationen werden verwendet, wenn Werte in den früheren Spezifikationen gleich sind. |
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 zum Ein-/Ausblenden von Werten pro Spalte.
Beide
|
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 Bereich, der geschützt wird. Der Bereich kann vollständig unbegrenzt sein. In diesem Fall gilt das Tabellenblatt als geschütztes Tabellenblatt.
Beim Schreiben wird nur eine der
|
namedRangeId
|
Der benannte Bereich, dem dieser geschützte Bereich zugeordnet ist, falls vorhanden.
Beim Schreiben wird nur eine der
|
description
|
Die Beschreibung dieses geschützten Bereichs. |
warningOnly
|
"True", wenn bei diesem geschützten Bereich beim Bearbeiten 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.
Wenn dieses Feld den Wert „true“ hat,
|
requestingUserCanEdit
|
„True“, wenn der Nutzer, der diesen geschützten Bereich angefordert hat, den geschützten Bereich 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 nicht unterstützt mit
|
Bearbeiter
Die Bearbeiter 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
|
"True", wenn jede Person in der Domain des Dokuments Bearbeitungszugriff auf den geschützten Bereich hat. Der Domainschutz wird nur für Dokumente innerhalb einer Domain unterstützt. |
BasicFilter
Der Standardfilter für ein Tabellenblatt.
JSON-Darstellung |
---|
{ "range": { object ( |
Felder | |
---|---|
range
|
Der Bereich, den der Filter abdeckt. |
sortSpecs[]
|
Die Sortierreihenfolge pro Spalte. Spätere Spezifikationen werden verwendet, wenn Werte in den früheren Spezifikationen gleich sind. |
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.
Beide
|
BandedRange
Ein Bandbereich (abwechselnde Farben) auf einem Blatt.
JSON-Darstellung |
---|
{ "bandedRangeId": integer, "range": { object ( |
Felder | |
---|---|
bandedRangeId
|
Die ID des Bandbereichs. |
range
|
Der Bereich, auf den diese Eigenschaften angewendet werden. |
rowProperties
|
Eigenschaften für Zeilenbereiche. Diese Eigenschaften werden Zeile für Zeile auf alle Zeilen im Bereich angewendet. Mindestens eine der folgenden Optionen
|
columnProperties
|
Eigenschaften für Spaltenbereiche. Diese Eigenschaften werden Spalte für Spalte auf alle Spalten im Bereich angewendet. Mindestens eine der folgenden Optionen
|
BandingProperties
Properties, die sich auf eine einzelne Dimension beziehen (entweder Zeile oder Spalte). Wenn beides
BandedRange.row_properties
und
BandedRange.column_properties
festgelegt sind, werden die Füllfarben nach den folgenden Regeln auf die Zellen angewendet:
-
headerColor
undfooterColor
Vorrang vor Bandfarben. -
firstBandColor
hat Vorrang vorsecondBandColor
. -
rowProperties
hat Vorrang vorcolumnProperties
.
Beispielsweise hat die Farbe der ersten Zeile Vorrang vor der Farbe der ersten Spalte, aber die Farbe der ersten Spalte hat 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 gefüllt und die Farben wechseln
|
headerColorStyle
|
Die Farbe der ersten Zeile oder Spalte. Wenn dieses Feld festgelegt ist, wird die erste Zeile oder Spalte mit dieser Farbe gefüllt und die Farben wechseln
|
firstBandColor
|
Die erste Farbe, die abwechselnd wechselt. (Erforderlich) Eingestellt: Verwenden
|
firstBandColorStyle
|
Die erste Farbe, die abwechselnd wechselt. (Erforderlich) Wenn
|
secondBandColor
|
Die zweite Farbe, die abwechselnd wechselt. (Erforderlich) Eingestellt: Verwenden
|
secondBandColorStyle
|
Die zweite Farbe, die abwechselnd wechselt. (Erforderlich) Wenn
|
footerColor
|
Die Farbe der letzten Zeile oder Spalte. Wenn dieses Feld nicht festgelegt ist, wird die letzte Zeile oder Spalte mit
|
footerColorStyle
|
Die Farbe der letzten Zeile oder Spalte. Wenn dieses Feld nicht festgelegt ist, wird die letzte Zeile oder Spalte mit
|
DimensionGroup
Eine Gruppe über ein Intervall von Zeilen oder Spalten auf einem Tabellenblatt, die andere Gruppen enthalten oder in dieser enthalten sein kann. Eine Gruppe kann als Einheit auf dem Tabellenblatt minimiert oder maximiert werden.
JSON-Darstellung |
---|
{
"range": {
object (
|
Felder | |
---|---|
range
|
Der Bereich, in dem diese Gruppe vorhanden ist. |
depth
|
Die Tiefe der Gruppe. Sie gibt an, wie viele Gruppen einen Bereich haben, der vollständig den Bereich dieser Gruppe enthält. |
collapsed
|
Dieses Feld ist auf "true" gesetzt, wenn diese Gruppe minimiert ist. Eine minimierte Gruppe bleibt minimiert, wenn eine sich überschneidende Gruppe in einer flachen Tiefe maximiert wird. „true“ 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 Eigenschaft jedoch aktualisiert wird, werden alle darin enthaltenen Dimensionen auf „Ausgeblendet“ gesetzt, wenn dieses Feld den Wert „true“ hat, oder auf „sichtbar“, wenn dieses Feld den Wert „false“ hat. |
Datenschnitt
Ein Datenschnitt in einem Tabellenblatt.
JSON-Darstellung |
---|
{ "slicerId": integer, "spec": { object ( |
Felder | |
---|---|
slicerId
|
Die ID des Datenschnitts. |
spec
|
Die Spezifikation des Datenschnitts. |
position
|
Die Position des Datenschnitts. Der Datenschnitt kann nur auf einem vorhandenen Tabellenblatt positioniert werden. Außerdem können Breite und Höhe des Datenschnitts automatisch angepasst werden, um die zulässigen Grenzwerte einzuhalten. |
SlicerSpec
Die Spezifikationen eines Datenschnitts.
JSON-Darstellung |
---|
{ "dataRange": { object ( |
Felder | |
---|---|
dataRange
|
Der Datenbereich des Datenschnitts. |
filterCriteria
|
Die Filterkriterien des Datenschnitts. |
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 die Richtlinie nicht konfiguriert ist, wird standardmäßig Folgendes verwendet:
|
title
|
Der Titel des Datenschnitts. |
textFormat
|
Das Textformat des Titels im Datenschnitt. Das Linkfeld wird nicht unterstützt. |
backgroundColor
|
Die Hintergrundfarbe des Datenschnitts. Eingestellt: Verwenden
|
backgroundColorStyle
|
Die Hintergrundfarbe des Datenschnitts. Wenn
|
horizontalAlignment
|
Horizontale Ausrichtung des Titels im Datenschnitt. Wenn keine Angabe erfolgt, wird standardmäßig
|