Sheets

{
  "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)
    }
  ]
}

object (SheetProperties)

Die Eigenschaften des Tabellenblatts.

object (GridData)

Daten im Raster, wenn es sich um eine Rastertabelle 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, haben die ersten GridData startRow (startColumn) von 0 und die zweite hat startRow 14 (nullbasierte Zeile 15) und startColumn 3 (nullbasierte Spalte D).

Bei einem Tabellenblatt vom Typ DATA_SOURCE können Sie keinen bestimmten Bereich anfordern. Die GridData enthält alle Werte.

object (GridRange)

Die Bereiche, die zusammengeführt werden.

object (ConditionalFormatRule)

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

object (FilterView)

Die Filteransichten in diesem Tabellenblatt.

object (ProtectedRange)

Die geschützten Bereiche in diesem Tabellenblatt.

object (BasicFilter)

Der Filter für dieses Tabellenblatt, falls vorhanden.

object (EmbeddedChart)

Die Spezifikationen der einzelnen Diagramme auf diesem Tabellenblatt.

object (BandedRange)

Das Blatt mit abwechselnden Farben auf diesem Blatt.

object (DeveloperMetadata)

Die mit einem Tabellenblatt verknüpften Entwicklermetadaten.

object (DimensionGroup)

Alle Zeilengruppen in diesem Tabellenblatt, geordnet nach steigendem Startindex des Bereichs und dann nach Gruppentiefe.

object (DimensionGroup)

Alle Spaltengruppen in diesem Tabellenblatt, geordnet nach steigendem Startindex des Bereichs und dann nach Gruppentiefe.

object (Slicer)

Die Datenschnitte in diesem Tabellenblatt.

{
  "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)
  }
}

integer

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

string

Der Name des Tabellenblatts.

integer

Der Index des Tabellenblatts innerhalb der Tabelle. Wenn das Feld beim Hinzufügen oder Aktualisieren der Tabellenblatteigenschaften ausgeschlossen wird, wird das Tabellenblatt hinzugefügt oder ans Ende der Tabellenblattliste verschoben. Beim Aktualisieren der Tabellenblattindexe oder beim Einfügen der Tabellenblätter wird die Bewegung als „Vor dem Verschieben“-Index betrachtet. Wenn beispielsweise drei Tabellenblätter (S1, S2, S3) vorhanden waren, um S1 vor S2 zu verschieben, muss der Index auf 2 gesetzt werden. Eine Anfrage zur Aktualisierung des Tabellenblatt-Index wird ignoriert, wenn der angeforderte Index mit dem aktuellen Index des Tabellenblatts identisch ist oder der angeforderte neue Index dem aktuellen Tabellenblattindex + 1 entspricht.

enum (SheetType)

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

object (GridProperties)

Zusätzliche Eigenschaften des Tabellenblatts, wenn es ein Raster ist. Wenn das Tabellenblatt eine Objekttabelle mit einem Diagramm oder Bild ist, fehlt dieses Feld. Beim Schreiben ist es ein Fehler, Rastereigenschaften für Nicht-Raster zu definieren.

Wenn dieses Tabellenblatt ein DATA_SOURCE-Tabellenblatt ist, wird dieses Feld nur ausgegeben, enthält aber die Attribute, die angeben, wie ein Datenquellentabellenblatt in der UI gerendert wird. Beispiel: rowCount.

boolean

"true", wenn das Tabellenblatt in der Benutzeroberfläche ausgeblendet ist, "false", wenn es sichtbar ist.

object (Color)

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

object (ColorStyle)

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

boolean

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

object (DataSourceSheetProperties)

Nur Ausgabe. Falls vorhanden, enthält das Feld tabellenspezifische Attribute DATA_SOURCE.

{
  "rowCount": integer,
  "columnCount": integer,
  "frozenRowCount": integer,
  "frozenColumnCount": integer,
  "hideGridlines": boolean,
  "rowGroupControlAfter": boolean,
  "columnGroupControlAfter": boolean
}

integer

Die Anzahl der Zeilen im Raster.

integer

Die Anzahl der Spalten im Raster.

integer

Die Anzahl der Zeilen, die im Raster fixiert sind.

integer

Die Anzahl der Spalten, die im Raster fixiert sind.

boolean

Dieser Wert ist „True“, wenn das Raster keine Gitterlinien in der Benutzeroberfläche anzeigt.

boolean

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

boolean

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

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

string

ID des DataSource, mit dem das Tabellenblatt verbunden ist.

object (DataSourceColumn)

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

object (DataExecutionStatus)

Der Status der Datenausführung.

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

integer

Die erste Zeile, auf die sich diese GridData bezieht, auf null.

integer

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

object (RowData)

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

object (DimensionProperties)

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

object (DimensionProperties)

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

{
  "values": [
    {
      object (CellData)
    }
  ]
}

object (CellData)

Die Werte in der Zeile, einer pro Spalte.

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

boolean

Dieser Wert ist „true“, wenn die Dimension gefiltert wird. Dieses Feld ist schreibgeschützt.

boolean

Dieser Wert ist „true“, wenn die Dimension explizit ausgeblendet ist.

integer

Höhe (wenn Zeile) oder Breite (Spalte) der Dimension in Pixeln

object (DeveloperMetadata)

Die Entwickler-Metadaten, die mit einer einzelnen Zeile oder Spalte verknüpft sind.

object (DataSourceColumnReference)

Nur Ausgabe. Wenn festgelegt, ist dies eine Spalte in einem Datenquellentabellenblatt.

{
  "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.
}

object (GridRange)

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

object (BooleanRule)

Die Formatierung ist je nach Regel entweder aktiviert oder deaktiviert.

object (GradientRule)

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

{
  "condition": {
    object (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}

object (BooleanCondition)

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

object (CellFormat)

Das Format, das angewendet werden soll. Die bedingte Formatierung kann nur auf einen Teil der Formatierung angewendet werden: bold, italic, strikethrough, foreground color und background color.

{
  "minpoint": {
    object (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}

object (InterpolationPoint)

Der Startpunkt.

object (InterpolationPoint)

Ein optionaler Mittelpunkt der Interpolation.

object (InterpolationPoint)

Der letzte Interpolpunkt.

{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}

object (Color)

Die Farbe, die dieser Interpolpunkt verwenden soll. Eingestellt: Verwenden Sie colorStyle.

object (ColorStyle)

Die Farbe, die dieser Interpolpunkt verwenden soll. Wenn auch color festgelegt wird, hat dieses Feld Vorrang.

enum (InterpolationPointType)

Wie der Wert interpretiert werden soll.

string

Der Wert, den dieser Interpolpunkt verwendet. Kann eine Formel sein. Nicht verwendet, wenn type MIN oder MAX ist.

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

integer

Die ID der Filteransicht.

string

Der Name der Filteransicht.

object (GridRange)

Der Bereich, in dem diese Filteransicht abgedeckt wird.

Beim Schreiben kann nur entweder range oder namedRangeId festgelegt werden.

string

Der benannte Bereich, auf den diese Filteransicht angewendet wird, sofern vorhanden.

Beim Schreiben kann nur entweder range oder namedRangeId festgelegt werden.

object (SortSpec)

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

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

Die Kriterien zum Anzeigen/Ausblenden von Werten pro Spalte. Der Schlüssel der Karte ist der Spaltenindex und der Wert ist das Kriterium für diese Spalte.

Dieses Feld wurde zugunsten von filterSpecs eingestellt.

object (FilterSpec)

Die Filterkriterien zum Anzeigen/Ausblenden von Werten pro Spalte.

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

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

integer

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

object (GridRange)

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

Beim Schreiben kann nur entweder range oder namedRangeId festgelegt werden.

string

Der benannte Bereich, von dem dieser geschützte Bereich unterstützt wird, falls vorhanden.

Beim Schreiben kann nur entweder range oder namedRangeId festgelegt werden.

string

Die Beschreibung dieses geschützten Bereichs.

boolean

Dieser Wert ist „true“, wenn dieser geschützte Bereich beim Bearbeiten angezeigt wird. Eine warnungsbasierte Schutzmaßnahme bedeutet, dass jeder Nutzer Daten im geschützten Bereich bearbeiten kann. Hiervon ausgenommen ist die Bearbeitung, bei der der Nutzer aufgefordert wird, die Änderung zu bestätigen.

Beim Schreiben: Wenn dieses Feld auf „true“ gesetzt ist, wird 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 Bearbeiter auf alle Bearbeiter des Dokuments gesetzt.

boolean

Wahr, wenn der Nutzer, der diesen geschützten Bereich angefordert hat, den geschützten Bereich bearbeiten kann. Dieses Feld ist schreibgeschützt.

object (GridRange)

Die Liste der nicht geschützten Bereiche in einem geschützten Tabellenblatt. Ungeschützte Bereiche werden nur für geschützte Tabellenblätter unterstützt.

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 mit warningOnly-Schutz nicht unterstützt.

{
  "users": [
    string
  ],
  "groups": [
    string
  ],
  "domainUsersCanEdit": boolean
}

string

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

string

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

boolean

Dieser Wert ist „True“, wenn jemand in der Domain des Dokuments Bearbeitungszugriff auf den geschützten Bereich hat. Der Domainschutz wird nur für Dokumente innerhalb einer Domain unterstützt.

{
  "range": {
    object (GridRange)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}

object (GridRange)

Der Bereich, der mit dem Filter abgedeckt wird.

object (SortSpec)

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

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

Die Kriterien zum Anzeigen/Ausblenden von Werten pro Spalte. Der Schlüssel der Karte ist der Spaltenindex und der Wert ist das Kriterium für diese Spalte.

Dieses Feld wurde zugunsten von filterSpecs eingestellt.

object (FilterSpec)

Die Filterkriterien pro Spalte.

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

{
  "bandedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}

integer

Die ID des gebundenen Bereichs.

object (GridRange)

Der Bereich, auf den diese Properties angewendet werden.

object (BandingProperties)

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

object (BandingProperties)

Eigenschaften für Spaltenbänder. Diese Eigenschaften werden spaltenweise auf alle Spalten im Bereich angewendet. Es muss entweder rowProperties oder columnProperties angegeben werden.

{
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}

object (Color)

Die Farbe der ersten Zeile oder Spalte. Wenn dieses Feld festgelegt ist, wird die erste Zeile oder Spalte mit dieser Farbe ausgefüllt und die Farben abwechselnd firstBandColor und secondBandColor ab der zweiten Zeile oder Spalte werden ausgefüllt. Andernfalls wird in der ersten Zeile oder Spalte firstBandColor angezeigt und die Farben wechseln sich wie gewohnt ab. Eingestellt: Verwenden Sie headerColorStyle.

object (ColorStyle)

Die Farbe der ersten Zeile oder Spalte. Wenn dieses Feld festgelegt ist, wird die erste Zeile oder Spalte mit dieser Farbe ausgefüllt und die Farben abwechselnd firstBandColor und secondBandColor ab der zweiten Zeile oder Spalte werden ausgefüllt. Andernfalls wird in der ersten Zeile oder Spalte firstBandColor angezeigt und die Farben wechseln sich wie gewohnt ab. Wenn auch headerColor festgelegt wird, hat dieses Feld Vorrang.

object (Color)

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

object (ColorStyle)

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

object (Color)

Die zweite Farbe, die sich abwechselnd ändert. (Erforderlich) Verworfen: Verwenden Sie secondBandColorStyle.

object (ColorStyle)

Die zweite Farbe, die sich abwechselnd ändert. (Erforderlich) Wenn auch secondBandColor festgelegt ist, hat dieses Feld Vorrang.

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. Eingestellt: Verwenden Sie 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 wird, hat dieses Feld Vorrang.

{
  "range": {
    object (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}

object (DimensionRange)

Der Bereich, in dem diese Gruppe vorhanden ist.

integer

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

boolean

Dieses Feld ist auf „true“ gesetzt, wenn diese Gruppe minimiert ist. Eine minimierte Gruppe bleibt minimiert, wenn eine sich überschneidende Gruppe in einer flachen Tiefe maximiert wird.

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 Eigenschaft jedoch aktualisiert wird, werden alle darin enthaltenen Dimensionen auf „ausgeblendet“ gesetzt, wenn dieses Feld wahr ist, oder auf „sichtbar“, wenn dieses Feld falsch ist.

{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}

integer

Die ID des Datenschnitts.

object (SlicerSpec)

Die Spezifikation des Datenschnitts.

object (EmbeddedObjectPosition)

Die Position des Datenschnitts. Der Datenschnitt kann nur auf vorhandenen Tabellenblättern positioniert werden. Außerdem können Breite und Höhe des Allesschneiders automatisch angepasst werden, um ihn innerhalb der zulässigen Grenzen zu halten.

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

object (GridRange)

Der Datenbereich des Datenschnitts.

object (FilterCriteria)

Die Filterkriterien für den Datenschnitt.

integer

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

boolean

True, wenn der Filter auf Pivot-Tabellen angewendet werden soll. Wenn die Richtlinie nicht konfiguriert ist, wird standardmäßig True verwendet.

string

Der Titel des Datenschnitts.

object (TextFormat)

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

object (Color)

Hintergrundfarbe des Datenschnitts Eingestellt: Verwenden Sie backgroundColorStyle.

object (ColorStyle)

Hintergrundfarbe des Datenschnitts Wenn auch backgroundColor festgelegt wird, hat dieses Feld Vorrang.

enum (HorizontalAlign)

Horizontale Ausrichtung des Titels im Datenschnitt. Wenn keine Angabe erfolgt, wird standardmäßig LEFT verwendet.