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)
    }
  ],
  "commentAnchors": [
    {
      object (CommentAnchor)
    }
  ]
}
Felder
properties

object (SheetProperties)

Die Eigenschaften des Tabellenblatts.

data[]

object (GridData)

Daten im Tabellenblatt, falls es sich um ein Tabellenblatt mit einem Raster handelt.

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

Für ein 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 der einzelnen Diagramme 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 in diesem Tabellenblatt.

tables[]

object (Table)

Die Tabellen auf diesem Tabellenblatt.

commentAnchors[]

object (CommentAnchor)

Die Kommentaranker 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 Tabellenblattattribute hinzufügen oder aktualisieren und dieses Feld ausgeschlossen wird, wird das Tabellenblatt am Ende der Tabellenblattliste 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 dem aktuellen Tabellenblattindex + 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 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 es sich bei diesem Tabellenblatt um ein DATA_SOURCE-Tabellenblatt handelt, wird dieses Feld nur ausgegeben. Es enthält die Eigenschaften, die widerspiegeln, wie ein Datenquellen-Tabellenblatt in der Benutzeroberfläche gerendert wird, z. B. rowCount.

hidden

boolean

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

tabColor
(deprecated)

object (Color)

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

tabColorStyle

object (ColorStyle)

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

rightToLeft

boolean

„Wahr“, 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 Bild.
DATA_SOURCE Das Tabellenblatt wird mit einer externen DataSource verbunden und zeigt die 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 Tabellengitter fixiert sind.

frozenColumnCount

integer

Die Anzahl der Spalten, die im Raster fixiert sind.

hideGridlines

boolean

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

rowGroupControlAfter

boolean

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

columnGroupControlAfter

boolean

„True“, wenn die Ein/Aus-Schaltfläche für die Spaltengruppierung 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 der DataSource, mit der 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 nach dieser 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 Entwicklermetadaten, die einer einzelnen Zeile oder Spalte zugeordnet sind.

dataSourceColumnReference

object (DataSourceColumnReference)

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

ConditionalFormatRule

Eine Regel, die ein bedingtes Format beschreibt.

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

  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
}
Felder
ranges[]

object (GridRange)

Die Bereiche, die formatiert werden, wenn die Bedingung wahr ist. Alle Bereiche müssen sich im selben Raster befinden.

Die Regel, mit der dieses bedingte Format gesteuert wird. Es muss genau eine festgelegt sein. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
booleanRule

object (BooleanRule)

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

gradientRule

object (GradientRule)

Die Formatierung hängt von den Verläufen in der Regel ab.

Ende der sich gegenseitig ausschließenden Felder.

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. Mit 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 der 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 im Bereich des bedingten Formats verwendet.
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. Das entspricht NUMBER, wenn der Wert =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) war (wobei Fehler im Bereich beim Reduzieren ignoriert werden).

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 (wobei Fehler im Bereich beim Reduzieren ignoriert werden).

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, der von dieser Filteransicht abgedeckt wird.

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, auf der diese Filteransicht basiert (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 Zuordnung ist der Spaltenindex und der Wert die Kriterien für diese Spalte.

Dieses Feld wird zugunsten von filterSpecs eingestellt.

filterSpecs[]

object (FilterSpec)

Die Filterkriterien zum Einblenden oder Ausblenden von Werten pro Spalte.

Sowohl criteria als auch filterSpecs werden in Antworten ausgefüllt. 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 er als geschütztes Tabellenblatt.

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

namedRangeId

string

Der Name des benannten Bereichs, der diesem geschützten Bereich zugrunde liegt, falls vorhanden.

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

tableId

string

Die Tabelle, die diesem geschützten Bereich zugrunde liegt, sofern vorhanden.

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

description

string

Die Beschreibung dieses geschützten Bereichs.

warningOnly

boolean

„True“, wenn beim Bearbeiten dieses geschützten Bereichs 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 kann. 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 mit Bearbeitungszugriff auf den geschützten Bereich und das Dokument sichtbar. Editoren werden mit 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

„Wahr“, 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, die diesem Filter zugrunde liegt (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 Zuordnung ist der Spaltenindex und der Wert 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 ausgefüllt. 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 zum Identifizieren 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)

Attribute 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 (entweder Zeile oder Spalte) beziehen. 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. 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) Nicht mehr unterstützt: Verwenden Sie firstBandColorStyle.

firstBandColorStyle

object (ColorStyle)

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

secondBandColor
(deprecated)

object (Color)

Die zweite Farbe, die sich abwechselt. (Erforderlich) Nicht mehr unterstützt: Verwenden Sie secondBandColorStyle.

secondBandColorStyle

object (ColorStyle)

Die zweite Farbe, die sich abwechselt. (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 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 einer geringeren 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 Eigenschaft jedoch aktualisiert wird, werden alle zugehörigen Dimensionen 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 auf vorhandenen Blättern platziert werden. Außerdem können Breite und Höhe des Datenschnitts 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 ist, wird standardmäßig True verwendet.

title

string

Der Titel des Datenschnitts.

textFormat

object (TextFormat)

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

backgroundColor
(deprecated)

object (Color)

Die Hintergrundfarbe des Datenschnitts. Verworfen: Verwenden Sie backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Die Hintergrundfarbe des Datenschnitts. 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. Sie 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 sich abwechselt. Wenn dieses Feld festgelegt ist, wird die zweite Zeile mit Streifen mit der angegebenen Farbe gefüllt. Andernfalls wird die zweite Zeile mit Streifen 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, sodass sie eine Fußzeile erhält, wird der Bereich um eine Zeile erweitert. Wenn Sie eine vorhandene Tabelle mit einer Fußzeile aktualisieren und 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 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 für die 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 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 Daten in der Zelle erfüllen müssen. Nur gültig, wenn [BooleanCondition.type] ONE_OF_LIST ist.

CommentAnchor

Ein Ort in der Tabelle, der mit einem CommentThread mit demselben anchorId verknüpft ist. Hinweis: Mehrere Anker können auf denselben Ort verweisen.

JSON-Darstellung 
{
  "anchorId": string,
  "range": {
    object (GridRange)
  }
}
Felder
anchorId

string

Die eindeutige ID des Kommentarankers. Nur Ausgabe.

range

object (GridRange)

Der Koordinatenbereich im Tabellenblatt, in dem dieser Kommentar verankert ist.