Sheets

Google-Tabelle

Ein Tabellenblatt in einer Tabellenkalkulation.

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 Rasterblatt handelt.

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

Bei einer DATA_SOURCE-Liste können Sie keinen bestimmten Bereich anfordern, da die GridData alle Werte enthält.

merges[]

object (GridRange)

Die zusammengeführten Bereiche.

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 auf diesem Tabellenblatt, falls vorhanden.

charts[]

object (EmbeddedChart)

Die Spezifikationen für jedes Diagramm auf diesem Tabellenblatt.

bandedRanges[]

object (BandedRange)

Die Bereiche mit Streifen (abwechselnde Farben) in dieser Tabelle.

developerMetadata[]

object (DeveloperMetadata)

Die mit einem Tabellenblatt verknüpften Entwicklermetadaten.

rowGroups[]

object (DimensionGroup)

Alle Zeilengruppen auf diesem Tabellenblatt, sortiert nach steigendem Startindex des Bereichs und dann nach Gruppentiefe.

columnGroups[]

object (DimensionGroup)

Alle Spaltengruppen auf diesem Blatt, sortiert nach steigendem Startindex des Bereichs und dann nach Gruppentiefe.

slicers[]

object (Slicer)

Die Segmentierungsoptionen 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 Tabelleneigenschaften hinzufügen oder aktualisieren und dieses Feld ausschließen, wird das Tabellenblatt ans Ende der Tabellenliste verschoben oder hinzugefügt. Wenn Sie Tabellenindexe aktualisieren oder Tabellen einfügen, wird die Verschiebung in den Indexen „vor dem Verschieben“ berücksichtigt. 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

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 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 DATA_SOURCE-Tabelle handelt, wird dieses Feld nur ausgegeben. Es enthält jedoch die Eigenschaften, die festlegen, wie eine Datenquellentabelle 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 in der Benutzeroberfläche. Verworfen: Verwenden Sie stattdessen tabColorStyle.

tabColorStyle

object (ColorStyle)

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

rightToLeft

boolean

„True“, wenn es sich bei dem Tabellenblatt um ein RTL-Tabellenblatt handelt.

dataSourceSheetProperties

object (DataSourceSheetProperties)

Nur Ausgabe. Wenn vorhanden, enthält das Feld DATA_SOURCE-spezifische Eigenschaften.

SheetType

Die Art des Tabellenblatts.

Enums
SHEET_TYPE_UNSPECIFIED Standardwert, nicht verwenden
GRID Das Tabellenblatt ist ein Raster.
OBJECT Die Tabelle enthält 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

integer

Die Anzahl der Zeilen im Raster.

columnCount

integer

Die Anzahl der Spalten im Raster.

frozenRowCount

integer

Die Anzahl der Zeilen, die im Raster fixiert sind.

frozenColumnCount

integer

Die Anzahl der Spalten, die im Raster fixiert sind.

hideGridlines

boolean

„True“, wenn für das Raster keine Rasterlinien in der Benutzeroberfläche angezeigt werden.

rowGroupControlAfter

boolean

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

columnGroupControlAfter

boolean

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

DataSourceSheetProperties

Zusätzliche Eigenschaften eines DATA_SOURCE-Tabellenblatts.

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

string

ID der DataSource, mit der das Tabellenblatt verknüpft ist.

columns[]

object (DataSourceColumn)

Die Spalten auf dem Tabellenblatt, die den Werten in RowData entsprechen.

dataExecutionStatus

object (DataExecutionStatus)

Der Ausführungsstatus der Daten.

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 beziehen, beginnend bei null.

startColumn

integer

Die erste Spalte, auf die sich diese GridData beziehen, beginnend mit null.

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

„Wahr“, 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 Entwicklermetadaten, die mit einer einzelnen Zeile oder Spalte verknüpft sind.

dataSourceColumnReference

object (DataSourceColumnReference)

Nur Ausgabe. Wenn diese Option festgelegt ist, bezieht sich der Wert auf eine Spalte in einem Datenquellenblatt.

ConditionalFormatRule

Eine Regel, die eine bedingte Formatierung beschreibt.

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 wahr ist. Alle Bereiche müssen sich im selben Raster befinden.

Union-Feld rule. Für diese bedingte Formatierung muss genau eine Regel festgelegt werden. rule darf nur einen der folgenden Werte haben:
booleanRule

object (BooleanRule)

Die Formatierung ist gemäß der Regel entweder „an“ oder „aus“.

gradientRule

object (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 (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}
Felder
condition

object (BooleanCondition)

Die Bedingung der Regel. Wenn die Bedingung als wahr ausgewertet wird, wird das Format angewendet.

format

object (CellFormat)

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

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 (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
Felder
minpoint

object (InterpolationPoint)

Der Startpunkt der Interpolation.

midpoint

object (InterpolationPoint)

Optionaler Interpolationspunkt in der Mitte.

maxpoint

object (InterpolationPoint)

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 (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 stattdessen 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. 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 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 NUMBER, wenn der Wert =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) war. Fehler im Bereich werden beim Zusammenführen ignoriert.

PERCENTILE Der Interpolationspunkt ist das angegebene Perzentil aller 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 (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 eines von range, namedRangeId oder tableId festgelegt werden.

namedRangeId

string

Der benannte Bereich, auf dem diese Filteransicht basiert, falls zutreffend.

Beim Schreiben kann nur eines von range, namedRangeId oder tableId festgelegt werden.

tableId

string

Die Tabelle, auf der diese Filteransicht basiert (falls vorhanden).

Beim Schreiben kann nur eines von range, namedRangeId oder tableId festgelegt werden.

sortSpecs[]

object (SortSpec)

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

criteria
(deprecated)

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

Die Kriterien für das Ein-/Ausblenden von Werten pro Spalte. Der Schlüssel der Zuordnung ist der Spaltenindex und der Wert sind die Kriterien für diese Spalte.

Dieses Feld wird zugunsten von filterSpecs eingestellt.

filterSpecs[]

object (FilterSpec)

Die Filterkriterien für das Ein-/Ausblenden von Werten pro Spalte.

Sowohl criteria als auch filterSpecs werden in Antworten eingefügt. 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 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 range, namedRangeId oder tableId festgelegt werden.

namedRangeId

string

Der benannte Bereich, auf dem dieser geschützte Bereich basiert, falls zutreffend.

Beim Schreiben kann nur eines von range, namedRangeId oder tableId festgelegt werden.

tableId

string

Die Tabelle, auf der dieser geschützte Bereich basiert, falls zutreffend.

Beim Schreiben kann nur eines von range, namedRangeId oder tableId festgelegt werden.

description

string

Die Beschreibung dieses geschützten Bereichs.

warningOnly

boolean

„Wahr“, wenn bei der Bearbeitung dieses geschützten Bereichs eine Warnung angezeigt wird. Beim warnungsbasierten Schutz können alle Nutzer Daten im geschützten Bereich bearbeiten. Bei der Bearbeitung wird jedoch eine Warnung angezeigt, in der der Nutzer aufgefordert wird, die Änderung zu bestätigen.

Beim Schreiben: Wenn dieses Feld wahr ist, werden editors ignoriert. Wenn dieses Feld von „wahr“ zu „falsch“ geändert wird und das Feld editors nicht festgelegt oder in der Feldmaske nicht enthalten ist, werden alle Bearbeiter im Dokument als Bearbeiter festgelegt.

requestingUserCanEdit

boolean

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

unprotectedRanges[]

object (GridRange)

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 mit Bearbeitungszugriff auf den geschützten Bereich und das Dokument sichtbar. Bearbeiter werden bei warningOnly-geschützten Inhalten 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

„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 (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 zutreffend. Beim Schreiben kann nur eines von 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 übereinstimmen.

criteria
(deprecated)

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

Die Kriterien für das Ein-/Ausblenden von Werten pro Spalte. Der Schlüssel der Zuordnung ist der Spaltenindex und der Wert sind die Kriterien für diese Spalte.

Dieses Feld wird zugunsten von filterSpecs eingestellt.

filterSpecs[]

object (FilterSpec)

Die Filterkriterien pro Spalte.

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

BandedRange

Ein Streifenbereich (mit abwechselnden Farben) in einem Tabellenblatt.

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

integer

Die ID des Bereichs mit Farbbändern.

range

object (GridRange)

Der Bereich, in dem diese Properties angewendet werden.

rowProperties

object (BandingProperties)

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

columnProperties

object (BandingProperties)

Eigenschaften für Spaltenbänder. 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 jedoch Vorrang vor der Farbe der zweiten Zeile. Ebenso hat die Zeilenüberschrift Vorrang vor der Spaltenüberschrift in der Zelle links oben. 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. Ab der zweiten Zeile oder Spalte wechseln die Farben zwischen firstBandColor und secondBandColor. Andernfalls wird die erste Zeile oder Spalte mit firstBandColor gefüllt und die Farben wechseln wie gewohnt. Verworfen: Verwenden Sie stattdessen 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. Ab der zweiten Zeile oder Spalte wechseln die Farben zwischen firstBandColor und secondBandColor. Andernfalls wird die erste Zeile oder Spalte mit firstBandColor gefüllt und die Farben wechseln wie gewohnt. Wenn auch headerColor festgelegt ist, hat dieses Feld Vorrang.

firstBandColor
(deprecated)

object (Color)

Die erste abwechselnde Farbe. (Erforderlich) Verworfen: Verwenden Sie stattdessen firstBandColorStyle.

firstBandColorStyle

object (ColorStyle)

Die erste abwechselnde Farbe. (Erforderlich) Wenn auch firstBandColor festgelegt ist, hat dieses Feld Vorrang.

secondBandColor
(deprecated)

object (Color)

Die zweite abwechselnde Farbe. (Erforderlich) Verworfen: Verwenden Sie stattdessen secondBandColorStyle.

secondBandColorStyle

object (ColorStyle)

Die zweite abwechselnde Farbe. (Erforderlich) Wenn auch secondBandColor 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 stattdessen 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 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 (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
Felder
range

object (DimensionRange)

Der Bereich, in dem diese Gruppe vorhanden ist.

depth

integer

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

collapsed

boolean

Dieses Feld ist „wahr“, 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

In einer Tabelle

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

integer

Die ID des Sprengschnitts.

spec

object (SlicerSpec)

Die Spezifikation des Slicers.

position

object (EmbeddedObjectPosition)

Die Position des Slicings. Hinweis: Der Sliver kann nur auf einer vorhandenen Tabelle platziert 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 Slicing-Tools.

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 Sliciers.

filterCriteria

object (FilterCriteria)

Die Filterkriterien des Sprengschnitts.

columnIndex

integer

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

applyToPivotTables

boolean

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

title

string

Der Titel des Sliciers.

textFormat

object (TextFormat)

Das Textformat des Titels im Sliver. Das Link-Feld wird nicht unterstützt.

backgroundColor
(deprecated)

object (Color)

Die Hintergrundfarbe des Sprengschnitts. Verworfen: Verwenden Sie stattdessen backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

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

horizontalAlignment

enum (HorizontalAlign)

Die horizontale Ausrichtung des Titels im Sliver. Wenn nicht angegeben, lautet der Standardwert LEFT.

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 Tabellenname. 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 Tabellenspalten.

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 ausgefüllt. Andernfalls wird die Kopfzeile mit einer Standardfarbe gefüllt.

firstBandColorStyle

object (ColorStyle)

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

secondBandColorStyle

object (ColorStyle)

Die zweite abwechselnde Farbe. Wenn dieses Feld festgelegt ist, wird die zweite Streifenzeile mit der angegebenen Farbe ausgefüllt. Andernfalls wird die zweite farblich hervorgehobene 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 mit einer Fußzeile aktualisieren, wird der Bereich um eine Zeile erweitert. Wenn Sie eine vorhandene Tabelle mit einer Fußzeile aktualisieren oder eine 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 ist relativ zu seiner Position in der Tabelle und muss nicht mit dem Spaltenindex im Tabellenblatt übereinstimmen.

columnName

string

Der Name der Spalte,

columnType

enum (ColumnType)

Der Spaltentyp.

dataValidationRule

object (TableColumnDataValidationRule)

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

ColumnType

Der Spaltentyp einer bestimmten 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 Typ der Drop-down-Liste.
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 Der 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 die Daten in der Zelle erfüllen müssen. Nur gültig, wenn [BooleanCondition.type] ONE_OF_LIST ist.