Sheets

Google-Tabelle

Ein Tabellenblatt in einer Tabelle.

JSON-Darstellung 
{
  "properties": {
    object (SheetProperties)
  },
  "data": [
    {
      object (GridData)
    }
  ],
  "merges": [
    {
      object (GridRange)
    }
  ],
  "conditionalFormats": [
    {
      object (ConditionalFormatRule)
    }
  ],
  "filterViews": [
    {
      object (FilterView)
    }
  ],
  "protectedRanges": [
    {
      object (ProtectedRange)
    }
  ],
  "basicFilter": {
    object (BasicFilter)
  },
  "charts": [
    {
      object (EmbeddedChart)
    }
  ],
  "bandedRanges": [
    {
      object (BandedRange)
    }
  ],
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "rowGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "columnGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "slicers": [
    {
      object (Slicer)
    }
  ],
  "tables": [
    {
      object (Table)
    }
  ]
}
Felder
properties

object (SheetProperties)

Die Eigenschaften des Tabellenblatts.

data[]

object (GridData)

Daten im Raster, wenn es sich um ein Rastertabellenblatt handelt.

Die Anzahl der zurückgegebenen GridData-Objekte hängt von der Anzahl der Bereiche ab, die in diesem Tabellenblatt angefordert werden. Wenn dies beispielsweise Sheet1 darstellt und die Tabelle mit den Bereichen Sheet1!A1:C10 und Sheet1!D15:E20 angefordert wurde, hat der erste GridData-Wert einen startRow / startColumn von 0, während der zweite startRow 14 (nullbasierte Zeile 15) und startColumn 3 (nullbasierte Spalte D) hat.

Bei einem DATA_SOURCE-Tabellenblatt können Sie keinen bestimmten Bereich anfordern. Die GridData-Objekte enthalten alle Werte.

merges[]

object (GridRange)

Die Bereiche, die zusammengeführt werden.

conditionalFormats[]

object (ConditionalFormatRule)

Die Regeln für die bedingte Formatierung in diesem Tabellenblatt.

filterViews[]

object (FilterView)

Die Filteransichten in diesem Tabellenblatt.

protectedRanges[]

object (ProtectedRange)

Die geschützten Bereiche in diesem Tabellenblatt.

basicFilter

object (BasicFilter)

Der Filter für dieses Tabellenblatt, falls vorhanden.

charts[]

object (EmbeddedChart)

Die Spezifikationen für jedes Diagramm auf diesem Tabellenblatt.

bandedRanges[]

object (BandedRange)

Die Bereiche mit abwechselnden Farben in diesem Tabellenblatt.

developerMetadata[]

object (DeveloperMetadata)

Die mit einem Tabellenblatt verknüpften Entwicklermetadaten.

rowGroups[]

object (DimensionGroup)

Alle Zeilengruppen auf diesem Tabellenblatt, sortiert nach aufsteigendem Bereichsstartindex und dann nach Gruppentiefe.

columnGroups[]

object (DimensionGroup)

Alle Spaltengruppen auf diesem Tabellenblatt, sortiert nach aufsteigendem Bereichsstartindex und dann nach Gruppentiefe.

slicers[]

object (Slicer)

Die Slicer auf diesem Tabellenblatt.

tables[]

object (Table)

Die Tabellen auf diesem Tabellenblatt.

SheetProperties

Eigenschaften eines Tabellenblatts.

JSON-Darstellung 
{
  "sheetId": integer,
  "title": string,
  "index": integer,
  "sheetType": enum (SheetType),
  "gridProperties": {
    object (GridProperties)
  },
  "hidden": boolean,
  "tabColor": {
    object (Color)
  },
  "tabColorStyle": {
    object (ColorStyle)
  },
  "rightToLeft": boolean,
  "dataSourceSheetProperties": {
    object (DataSourceSheetProperties)
  }
}
Felder
sheetId

integer

Die ID des Tabellenblatts. Darf nicht negativ sein. Dieses Feld kann nach der Festlegung nicht mehr geändert werden.

title

string

Der Name des Tabellenblatts.

index

integer

Der Index des Tabellenblatts in der Tabelle. Wenn Sie Blattattribute hinzufügen oder aktualisieren und dieses Feld ausgeschlossen wird, wird das Blatt am Ende der Blattliste hinzugefügt oder dorthin verschoben. Beim Aktualisieren von Tabellenblattindexen oder Einfügen von Tabellenblättern wird die Bewegung in den Indexen „vor dem Verschieben“ berücksichtigt. Wenn es beispielsweise drei Tabellenblätter (T1, T2, T3) gibt und T1 vor T2 verschoben werden soll, muss der Index auf 2 gesetzt werden. Eine Anfrage zur Aktualisierung des Tabellenblattindex wird ignoriert, wenn der angeforderte Index mit dem aktuellen Index des Tabellenblatts identisch ist oder wenn der angeforderte neue Index gleich dem aktuellen Tabellenblattindex + 1 ist.

sheetType

enum (SheetType)

Der Typ des Tabellenblatts. Die Standardeinstellung ist GRID. Dieses Feld kann nach der Festlegung nicht mehr geändert werden.

gridProperties

object (GridProperties)

Zusätzliche Eigenschaften des Blatts, wenn es sich um ein Raster handelt. Wenn das Tabellenblatt ein Objektblatt mit einem Diagramm oder Bild ist, ist dieses Feld nicht vorhanden. Beim Schreiben ist es ein Fehler, Rasterattribute für Blätter festzulegen, die keine Raster sind.

Wenn dieses Tabellenblatt ein DATA_SOURCE-Tabellenblatt ist, wird dieses Feld nur ausgegeben. Es enthält die Eigenschaften, die angeben, wie ein Datenquellen-Tabellenblatt in der Benutzeroberfläche gerendert wird, z. B. rowCount.

hidden

boolean

„True“, wenn das Tabellenblatt in der Benutzeroberfläche ausgeblendet ist, „false“, wenn es sichtbar ist.

tabColor
(deprecated)

object (Color)

Die Farbe des Tabs auf der Benutzeroberfläche. Verworfen: Verwenden Sie tabColorStyle.

tabColorStyle

object (ColorStyle)

Die Farbe des Tabs auf der Benutzeroberfläche. Wenn auch tabColor festgelegt ist, hat dieses Feld Vorrang.

rightToLeft

boolean

„True“, wenn das Tabellenblatt ein RTL-Tabellenblatt anstelle eines LTR-Tabellenblatts ist.

dataSourceSheetProperties

object (DataSourceSheetProperties)

Nur Ausgabe. Falls vorhanden, enthält das Feld DATA_SOURCE blattspezifische Eigenschaften.

SheetType

Die Art des Tabellenblatts.

Enums
SHEET_TYPE_UNSPECIFIED Standardwert, nicht verwenden.
GRID Das Tabellenblatt ist ein Raster.
OBJECT Das Tabellenblatt enthält kein Tabellengitter, sondern ein Objekt wie ein Diagramm oder ein Bild.
DATA_SOURCE Das Tabellenblatt ist mit einer externen DataSource verbunden und zeigt die Datenvorschau.

GridProperties

Eigenschaften eines Rasters.

JSON-Darstellung 
{
  "rowCount": integer,
  "columnCount": integer,
  "frozenRowCount": integer,
  "frozenColumnCount": integer,
  "hideGridlines": boolean,
  "rowGroupControlAfter": boolean,
  "columnGroupControlAfter": boolean
}
Felder
rowCount

integer

Die Anzahl der Zeilen im Raster.

columnCount

integer

Die Anzahl der Spalten im Raster.

frozenRowCount

integer

Die Anzahl der Zeilen, die im Tabellengrid fixiert sind.

frozenColumnCount

integer

Die Anzahl der Spalten, die im Raster fixiert sind.

hideGridlines

boolean

„True“, wenn im Raster in der Benutzeroberfläche keine Rasterlinien angezeigt werden.

rowGroupControlAfter

boolean

„True“, wenn die Ein/Aus-Schaltfläche für die Zeilengruppierung nach der Gruppe angezeigt wird.

columnGroupControlAfter

boolean

„True“, wenn der Schalter für die Spaltengruppensteuerung nach der Gruppe angezeigt wird.

DataSourceSheetProperties

Zusätzliche Attribute eines DATA_SOURCE-Arbeitsblatts.

JSON-Darstellung 
{
  "dataSourceId": string,
  "columns": [
    {
      object (DataSourceColumn)
    }
  ],
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Felder
dataSourceId

string

ID des DataSource, mit dem das Tabellenblatt verknüpft ist.

columns[]

object (DataSourceColumn)

Die Spalten, die im Tabellenblatt angezeigt werden und den Werten in RowData entsprechen.

dataExecutionStatus

object (DataExecutionStatus)

Der Status der Datenausführung.

GridData

Daten im Raster sowie Metadaten zu den Dimensionen.

JSON-Darstellung 
{
  "startRow": integer,
  "startColumn": integer,
  "rowData": [
    {
      object (RowData)
    }
  ],
  "rowMetadata": [
    {
      object (DimensionProperties)
    }
  ],
  "columnMetadata": [
    {
      object (DimensionProperties)
    }
  ]
}
Felder
startRow

integer

Die erste Zeile, auf die sich diese GridData bezieht (nullbasiert).

startColumn

integer

Die erste Spalte, auf die sich diese GridData bezieht (nullbasiert).

rowData[]

object (RowData)

Die Daten im Raster, ein Eintrag pro Zeile, beginnend mit der Zeile in „startRow“. Die Werte in RowData entsprechen den Spalten ab startColumn.

rowMetadata[]

object (DimensionProperties)

Metadaten zu den angeforderten Zeilen im Raster, beginnend mit der Zeile in startRow.

columnMetadata[]

object (DimensionProperties)

Metadaten zu den angeforderten Spalten im Raster, beginnend mit der Spalte in startColumn.

RowData

Daten zu jeder Zelle in einer Zeile.

JSON-Darstellung 
{
  "values": [
    {
      object (CellData)
    }
  ]
}
Felder
values[]

object (CellData)

Die Werte in der Zeile, einer pro Spalte.

DimensionProperties

Eigenschaften einer Dimension.

JSON-Darstellung 
{
  "hiddenByFilter": boolean,
  "hiddenByUser": boolean,
  "pixelSize": integer,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
}
Felder
hiddenByFilter

boolean

„True“, wenn diese Dimension gefiltert wird. Dieses Feld ist schreibgeschützt.

hiddenByUser

boolean

„True“, wenn diese Dimension explizit ausgeblendet ist.

pixelSize

integer

Die Höhe (bei einer Zeile) oder Breite (bei einer Spalte) der Dimension in Pixeln.

developerMetadata[]

object (DeveloperMetadata)

Die mit einer einzelnen Zeile oder Spalte verknüpften Entwicklermetadaten.

dataSourceColumnReference

object (DataSourceColumnReference)

Nur Ausgabe. Falls festgelegt, ist dies eine Spalte in einem Datenquellen-Tabellenblatt.

ConditionalFormatRule

Eine Regel, die ein Format beschreibt, das nur unter bestimmten Bedingungen angewendet wird.

JSON-Darstellung 
{
  "ranges": [
    {
      object (GridRange)
    }
  ],

  // Union field rule can be only one of the following:
  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
  // End of list of possible types for union field rule.
}
Felder
ranges[]

object (GridRange)

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, mit der dieses bedingte Format gesteuert wird. Es muss genau eine festgelegt werden. Für rule ist nur einer der folgenden Werte zulässig:
booleanRule

object (BooleanRule)

Die Formatierung ist je nach Regel entweder „on“ oder „off“.

gradientRule

object (GradientRule)

Die Formatierung variiert je nach den Abstufungen in der Regel.

BooleanRule

Eine Regel, die je nach Bedingung übereinstimmen kann oder nicht.

JSON-Darstellung 
{
  "condition": {
    object (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}
Felder
condition

object (BooleanCondition)

Die Bedingung der Regel. Wenn die Bedingung als „true“ ausgewertet wird, wird das Format angewendet.

format

object (CellFormat)

Das anzuwendende Format. Bei der bedingten Formatierung kann nur eine Teilmenge der Formatierung angewendet werden: bold, italic, strikethrough, foreground color und background color.

GradientRule

Eine Regel, die ein Farbverlaufsformat auf Grundlage der aufgeführten Interpolationspunkte anwendet. Das Format einer Zelle hängt von ihrem Inhalt im Vergleich zu den Werten der Interpolationspunkte ab.

JSON-Darstellung 
{
  "minpoint": {
    object (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
Felder
minpoint

object (InterpolationPoint)

Der Startpunkt für die Interpolation.

midpoint

object (InterpolationPoint)

Ein optionaler Interpolationspunkt in der Mitte.

maxpoint

object (InterpolationPoint)

Der letzte Interpolationspunkt.

InterpolationPoint

Ein einzelner Interpolationspunkt in einem bedingten Format mit Farbverlauf. Damit wird die Farbverlaufsskala entsprechend der ausgewählten Farbe, des ausgewählten Typs und des ausgewählten Werts fixiert.

JSON-Darstellung 
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}
Felder
color
(deprecated)

object (Color)

Die Farbe, die für diesen Interpolationspunkt verwendet werden soll. Verworfen: Verwenden Sie colorStyle.

colorStyle

object (ColorStyle)

Die Farbe, die für diesen Interpolationspunkt verwendet werden soll. Wenn auch color festgelegt ist, hat dieses Feld Vorrang.

type

enum (InterpolationPointType)

Wie der Wert interpretiert werden soll.

value

string

Der Wert, der für diesen Interpolationspunkt verwendet wird. Kann eine Formel sein. Wird nicht verwendet, wenn type MIN oder MAX ist.

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 der bedingten Formatierung verwendet.
MAX Für den Interpolationspunkt wird der Maximalwert in den Zellen des Bereichs 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 NUMBER, wenn der Wert =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) war. Fehler im Bereich werden beim Reduzieren ignoriert.

PERCENTILE Der Interpolationspunkt ist das angegebene 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 Reduzieren ignoriert.

FilterView

Eine Filteransicht. Weitere Informationen finden Sie unter Datensichtbarkeit mit Filtern verwalten.

JSON-Darstellung 
{
  "filterViewId": integer,
  "title": string,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Felder
filterViewId

integer

Die ID der Filteransicht.

title

string

Der Name der Filteransicht.

range

object (GridRange)

Der Bereich, den diese Filteransicht abdeckt.

Beim Schreiben kann nur einer der folgenden Werte festgelegt werden: range, namedRangeId oder tableId.

namedRangeId

string

Der benannte Bereich, der dieser Filteransicht zugrunde liegt, falls vorhanden.

Beim Schreiben kann nur einer der folgenden Werte festgelegt werden: range, namedRangeId oder tableId.

tableId

string

Die Tabelle, die dieser Filteransicht zugrunde liegt (falls vorhanden).

Beim Schreiben kann nur einer der folgenden Werte festgelegt werden: range, namedRangeId oder tableId.

sortSpecs[]

object (SortSpec)

Die Sortierreihenfolge pro Spalte. Spätere Spezifikationen werden verwendet, wenn die Werte in den früheren Spezifikationen gleich sind.

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

Die Kriterien zum Einblenden/Ausblenden von Werten pro Spalte. Der Schlüssel der Map ist der Spaltenindex und der Wert die Kriterien für diese Spalte.

Dieses Feld wurde zugunsten von filterSpecs eingestellt.

filterSpecs[]

object (FilterSpec)

Die Filterkriterien zum Ein- oder Ausblenden von Werten pro Spalte.

Sowohl criteria als auch filterSpecs werden in Antworten ausgegeben. Wenn beide Felder in einer Aktualisierungsanfrage angegeben sind, hat dieses Feld Vorrang.

ProtectedRange

Ein geschützter Bereich.

JSON-Darstellung 
{
  "protectedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
Felder
protectedRangeId

integer

Die ID des geschützten Bereichs. Dieses Feld ist schreibgeschützt.

range

object (GridRange)

Der Bereich, der geschützt wird. Der Bereich kann vollständig unbegrenzt sein. In diesem Fall gilt das als geschütztes Tabellenblatt.

Beim Schreiben darf nur eine der folgenden Optionen festgelegt werden: range oder namedRangeId oder tableId.

namedRangeId

string

Der benannte Bereich, der diesem geschützten Bereich zugrunde liegt, falls vorhanden.

Beim Schreiben darf nur eine der folgenden Optionen festgelegt werden: range oder namedRangeId oder tableId.

tableId

string

Die Tabelle, auf der dieser geschützte Bereich basiert, sofern vorhanden.

Beim Schreiben darf nur eine der folgenden Optionen festgelegt werden: range oder namedRangeId oder tableId.

description

string

Die Beschreibung dieses geschützten Bereichs.

warningOnly

boolean

„True“, wenn für diesen geschützten Bereich beim Bearbeiten eine Warnung angezeigt wird. Beim warnungsbasierten Schutz kann jeder Nutzer Daten im geschützten Bereich bearbeiten. Allerdings wird eine Warnung angezeigt, in der der Nutzer aufgefordert wird, die Bearbeitung zu bestätigen.

Beim Schreiben: Wenn dieses Feld „true“ ist, werden editors ignoriert. Wenn dieses Feld von „true“ in „false“ geändert wird und das Feld editors nicht festgelegt (oder in der Feldmaske enthalten) ist, werden die Mitbearbeiter auf alle Mitbearbeiter im Dokument festgelegt.

requestingUserCanEdit

boolean

„True“, wenn der Nutzer, der diesen geschützten Bereich angefordert hat, den geschützten Bereich bearbeiten darf. Dieses Feld ist schreibgeschützt.

unprotectedRanges[]

object (GridRange)

Die Liste der ungeschützten Bereiche in einem geschützten Tabellenblatt. Ungeschützte Bereiche werden nur in geschützten Tabellenblättern unterstützt.

editors

object (Editors)

Die Nutzer und Gruppen mit Bearbeitungszugriff auf den geschützten Bereich. Dieses Feld ist nur für Nutzer sichtbar, die Bearbeitungszugriff auf den geschützten Bereich und das Dokument haben. Editoren werden bei warningOnly-Schutz nicht unterstützt.

Bearbeiter

Die Mitbearbeiter eines geschützten Bereichs.

JSON-Darstellung 
{
  "users": [
    string
  ],
  "groups": [
    string
  ],
  "domainUsersCanEdit": boolean
}
Felder
users[]

string

Die E-Mail-Adressen der Nutzer mit Bearbeitungszugriff auf den geschützten Bereich.

groups[]

string

Die E‑Mail-Adressen von Gruppen mit Bearbeitungszugriff auf den geschützten Bereich.

domainUsersCanEdit

boolean

„True“, wenn jeder in der Domain des Dokuments Bearbeitungszugriff auf den geschützten Bereich hat. Der Schutz von Domains wird nur für Dokumente innerhalb einer Domain unterstützt.

BasicFilter

Der Standardfilter, der einem Tabellenblatt zugeordnet ist. Weitere Informationen finden Sie unter Datensichtbarkeit mit Filtern verwalten.

JSON-Darstellung 
{
  "range": {
    object (GridRange)
  },
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Felder
range

object (GridRange)

Der Bereich, den der Filter abdeckt.

tableId

string

Die Tabelle, auf der dieser Filter basiert (falls vorhanden). Beim Schreiben kann nur entweder range oder tableId festgelegt werden.

sortSpecs[]

object (SortSpec)

Die Sortierreihenfolge pro Spalte. Spätere Spezifikationen werden verwendet, wenn die Werte in den früheren Spezifikationen gleich sind.

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

Die Kriterien zum Einblenden/Ausblenden von Werten pro Spalte. Der Schlüssel der Map ist der Spaltenindex und der Wert die Kriterien für diese Spalte.

Dieses Feld wurde zugunsten von filterSpecs eingestellt.

filterSpecs[]

object (FilterSpec)

Die Filterkriterien pro Spalte.

Sowohl criteria als auch filterSpecs werden in Antworten ausgegeben. Wenn beide Felder in einer Aktualisierungsanfrage angegeben sind, hat dieses Feld Vorrang.

BandedRange

Ein Bereich mit abwechselnden Farben in einem Tabellenblatt.

JSON-Darstellung 
{
  "bandedRangeId": integer,
  "bandedRangeReference": string,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
Felder
bandedRangeId

integer

Die ID des Bereichs. Wenn nicht festgelegt, siehe bandedRangeReference.

bandedRangeReference

string

Nur Ausgabe. Die Referenz des Bereichs, der zur Identifizierung der ID verwendet wird, die von bandedRangeId nicht unterstützt wird.

range

object (GridRange)

Der Bereich, auf den diese Eigenschaften angewendet werden.

rowProperties

object (BandingProperties)

Eigenschaften für Zeilenbereiche. Diese Eigenschaften werden zeilenweise auf alle Zeilen im Bereich angewendet. Es muss mindestens rowProperties oder columnProperties angegeben werden.

columnProperties

object (BandingProperties)

Eigenschaften für Spaltenbereiche. Diese Eigenschaften werden spaltenweise auf alle Spalten im Bereich angewendet. Es muss mindestens rowProperties oder columnProperties angegeben werden.

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:

Die Farbe der ersten Zeile hat beispielsweise Vorrang vor der Farbe der ersten Spalte, die Farbe der ersten Spalte hat aber Vorrang vor der Farbe der zweiten Zeile. Entsprechend hat die Zeilenüberschrift in der Zelle oben links Vorrang vor der Spaltenüberschrift. Die Spaltenüberschrift hat jedoch Vorrang vor der Farbe der ersten Zeile, wenn die Zeilenüberschrift nicht festgelegt ist.

JSON-Darstellung 
{
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Felder
headerColor
(deprecated)

object (Color)

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 ab der zweiten Zeile oder Spalte zwischen firstBandColor und secondBandColor. Andernfalls wird die erste Zeile oder Spalte mit firstBandColor gefüllt und die Farben wechseln sich wie gewohnt ab. Verworfen: Verwenden Sie headerColorStyle.

headerColorStyle

object (ColorStyle)

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 ab der zweiten Zeile oder Spalte zwischen firstBandColor und secondBandColor. Andernfalls wird die erste Zeile oder Spalte mit firstBandColor gefüllt und die Farben wechseln sich wie gewohnt ab. Wenn auch headerColor festgelegt ist, hat dieses Feld Vorrang.

firstBandColor
(deprecated)

object (Color)

Die erste Farbe, die abwechselnd verwendet wird. (Erforderlich) Verworfen: Verwenden Sie firstBandColorStyle.

firstBandColorStyle

object (ColorStyle)

Die erste Farbe, die abwechselnd verwendet wird. Erforderlich. Wenn firstBandColor ebenfalls festgelegt ist, hat dieses Feld Vorrang.

secondBandColor
(deprecated)

object (Color)

Die zweite Farbe, die abwechselnd verwendet wird. (Erforderlich) Verworfen: Verwenden Sie secondBandColorStyle.

secondBandColorStyle

object (ColorStyle)

Die zweite Farbe, die abwechselnd verwendet wird. Erforderlich. Wenn secondBandColor ebenfalls festgelegt ist, hat dieses Feld Vorrang.

footerColor
(deprecated)

object (Color)

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 firstBandColor oder secondBandColor gefüllt. Verworfen: Verwenden Sie footerColorStyle.

footerColorStyle

object (ColorStyle)

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 firstBandColor oder secondBandColor gefüllt. Wenn auch footerColor festgelegt ist, hat dieses Feld Vorrang.

DimensionGroup

Eine Gruppe über einem Intervall von Zeilen oder Spalten in einem Tabellenblatt, die andere Gruppen enthalten kann oder in anderen Gruppen enthalten sein kann. Eine Gruppe kann im Tabellenblatt als Einheit minimiert oder maximiert werden.

JSON-Darstellung 
{
  "range": {
    object (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
Felder
range

object (DimensionRange)

Der Bereich, in dem diese Gruppe vorhanden ist.

depth

integer

Die Tiefe der Gruppe, die angibt, wie viele Gruppen einen Bereich haben, der den Bereich dieser Gruppe vollständig enthält.

collapsed

boolean

Dieses Feld ist „true“, wenn die Gruppe minimiert ist. Eine minimierte Gruppe bleibt minimiert, wenn eine überlappende Gruppe mit geringerer Tiefe maximiert wird.

Ein „true“-Wert bedeutet nicht, dass alle Dimensionen in 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 Dimensionen darin auf „hidden“ gesetzt, wenn dieses Feld „true“ ist, oder auf „visible“, wenn dieses Feld „false“ ist.

Datenschnitt

Ein Slicer in einem Tabellenblatt.

JSON-Darstellung 
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}
Felder
slicerId

integer

Die ID des Slicers.

spec

object (SlicerSpec)

Die Spezifikation des Slicers.

position

object (EmbeddedObjectPosition)

Die Position des Slicers. Slicer können nur in vorhandenen Tabellenblättern platziert werden. Außerdem können Breite und Höhe des Slicers automatisch angepasst werden, damit er innerhalb der zulässigen Grenzwerte bleibt.

SlicerSpec

Die Spezifikationen eines Slicers.

JSON-Darstellung 
{
  "dataRange": {
    object (GridRange)
  },
  "filterCriteria": {
    object (FilterCriteria)
  },
  "columnIndex": integer,
  "applyToPivotTables": boolean,
  "title": string,
  "textFormat": {
    object (TextFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "horizontalAlignment": enum (HorizontalAlign)
}
Felder
dataRange

object (GridRange)

Der Datenbereich des Slicers.

filterCriteria

object (FilterCriteria)

Die Filterkriterien des Slicers.

columnIndex

integer

Der nullbasierte Spaltenindex in der Datentabelle, auf die der Filter angewendet wird.

applyToPivotTables

boolean

„True“, wenn der Filter auf Pivot-Tabellen angewendet werden soll. Wenn nichts anderes festgelegt wird, wird standardmäßig True verwendet.

title

string

Der Titel des Slicers.

textFormat

object (TextFormat)

Das Textformat des Titels im Slicer. Das Linkfeld wird nicht unterstützt.

backgroundColor
(deprecated)

object (Color)

Die Hintergrundfarbe des Slicers. Verworfen: Verwenden Sie backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Die Hintergrundfarbe des Slicers. Wenn auch backgroundColor festgelegt ist, hat dieses Feld Vorrang.

horizontalAlignment

enum (HorizontalAlign)

Die horizontale Ausrichtung des Titels im Slicer. Wenn nicht angegeben, wird standardmäßig LEFT verwendet.

Tabelle

Eine Tabelle.

JSON-Darstellung 
{
  "tableId": string,
  "name": string,
  "range": {
    object (GridRange)
  },
  "rowsProperties": {
    object (TableRowsProperties)
  },
  "columnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
Felder
tableId

string

Die ID der Tabelle.

name

string

Der Name der Tabelle. Dieser Wert ist für alle Tabellen in derselben Tabelle eindeutig.

range

object (GridRange)

Der Tabellenbereich.

rowsProperties

object (TableRowsProperties)

Die Eigenschaften der Tabellenzeilen.

columnProperties[]

object (TableColumnProperties)

Die Eigenschaften der Tabellenspalte.

TableRowsProperties

Die Eigenschaften der Tabellenzeile.

JSON-Darstellung 
{
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Felder
headerColorStyle

object (ColorStyle)

Die Farbe der Kopfzeile. Wenn dieses Feld festgelegt ist, wird die Kopfzeile mit der angegebenen Farbe gefüllt. Andernfalls wird die Kopfzeile mit einer Standardfarbe gefüllt.

firstBandColorStyle

object (ColorStyle)

Die erste Farbe, die abwechselnd verwendet wird. Wenn dieses Feld festgelegt ist, wird die erste Zeile mit Streifen mit der angegebenen Farbe gefüllt. Andernfalls wird die erste Zeile mit Streifen mit einer Standardfarbe gefüllt.

secondBandColorStyle

object (ColorStyle)

Die zweite Farbe, die abwechselnd verwendet wird. Wenn dieses Feld festgelegt ist, wird die zweite Zeile mit Streifen mit der angegebenen Farbe gefüllt. Andernfalls wird die zweite Zeile mit einer Standardfarbe gefüllt.

footerColorStyle

object (ColorStyle)

Die Farbe der letzten Zeile. Wenn dieses Feld nicht festgelegt ist, wird keine Fußzeile hinzugefügt. Die letzte Zeile wird je nach Farbe der vorherigen Zeile mit firstBandColorStyle oder secondBandColorStyle gefüllt. Wenn Sie eine vorhandene Tabelle ohne Fußzeile aktualisieren, um eine Fußzeile hinzuzufügen, wird der Bereich um eine Zeile erweitert. Wenn Sie eine vorhandene Tabelle mit einer Fußzeile aktualisieren und die Fußzeile entfernen, wird der Bereich um eine Zeile verkleinert.

TableColumnProperties

Die Tabellenspalte.

JSON-Darstellung 
{
  "columnIndex": integer,
  "columnName": string,
  "columnType": enum (ColumnType),
  "dataValidationRule": {
    object (TableColumnDataValidationRule)
  }
}
Felder
columnIndex

integer

Der nullbasierte Spaltenindex. Dieser Index bezieht sich auf die Position in der Tabelle und ist nicht unbedingt mit dem Spaltenindex im Tabellenblatt identisch.

columnName

string

Der Name der Spalte,

columnType

enum (ColumnType)

Der Spaltentyp.

dataValidationRule

object (TableColumnDataValidationRule)

Die Regel zur Datenvalidierung für die Spalte. Nur für den Spaltentyp „Drop-down-Menü“ festgelegt.

ColumnType

Der Spaltentyp für eine bestimmte Spalte in einer Tabelle.

Enums
COLUMN_TYPE_UNSPECIFIED Ein nicht angegebener Spaltentyp.
DOUBLE Der Spaltentyp „Zahl“.
CURRENCY Der Spaltentyp „Währung“.
PERCENT Der Spaltentyp „Prozent“.
DATE Der Spaltentyp „Datum“.
TIME Der Typ der Zeitspalte.
DATE_TIME Der Spaltentyp „Datum/Uhrzeit“.
TEXT Der Typ der Textspalte.
BOOLEAN Der boolesche Spaltentyp.
DROPDOWN Der Spaltentyp „Drop-down-Menü“.
FILES_CHIP Der Spaltentyp „Datei-Chip“
PEOPLE_CHIP Der Spaltentyp „Personen-Chip“
FINANCE_CHIP Der Spaltentyp „Finanzen-Chip“
PLACE_CHIP Der Spaltentyp „Orts-Chip“
RATINGS_CHIP Spaltentyp „Bewertungs-Chip“

TableColumnDataValidationRule

Eine Regel zur Datenvalidierung für eine Spalte in einer Tabelle.

JSON-Darstellung 
{
  "condition": {
    object (BooleanCondition)
  }
}
Felder
condition

object (BooleanCondition)

Die Bedingung, die Daten in der Zelle erfüllen müssen. Nur gültig, wenn [BooleanCondition.type] ONE_OF_LIST ist.