- Ressource: Tabelle
- SpreadsheetProperties
- RecalculationInterval
- CellFormat
- NumberFormat
- NumberFormatType
- Color
- ColorStyle
- ThemeColorType
- Rahmen
- Rahmen
- Design
- Abstand
- HorizontalAlign
- VerticalAlign
- WrapStrategy
- TextDirection
- TextFormat
- Link
- HyperlinkDisplayType
- TextRotation
- IterativeCalculationSettings
- SpreadsheetTheme
- ThemeColorPair
- Sheet
- SheetProperties
- SheetType
- GridProperties
- DataSourceSheetProperties
- DataSourceColumn
- DataSourceColumnReference
- DataExecutionStatus
- DataExecutionState
- DataExecutionErrorCode
- GridData
- RowData
- CellData
- ExtendedValue
- ErrorValue
- ErrorType
- TextFormatRun
- DataValidationRule
- BooleanCondition
- ConditionType
- ConditionValue
- RelativeDate
- PivotTable
- GridRange
- PivotGroup
- PivotGroupValueMetadata
- SortOrder
- PivotGroupSortValueBucket
- PivotGroupRule
- ManualRule
- ManualRuleGroup
- HistogramRule
- DateTimeRule
- DateTimeRuleType
- PivotGroupLimit
- PivotFilterCriteria
- PivotFilterSpec
- PivotValue
- PivotValueSummarizeFunction
- PivotValueCalculatedDisplayType
- PivotValueLayout
- DataSourceTable
- DataSourceTableColumnSelectionType
- FilterSpec
- FilterCriteria
- SortSpec
- DataSourceFormula
- ChipRun
- Chip
- PersonProperties
- DisplayFormat
- RichLinkProperties
- DimensionProperties
- ConditionalFormatRule
- BooleanRule
- GradientRule
- InterpolationPoint
- InterpolationPointType
- FilterView
- ProtectedRange
- Bearbeiter
- BasicFilter
- EmbeddedChart
- ChartSpec
- TextPosition
- DataSourceChartProperties
- BasicChartSpec
- BasicChartType
- BasicChartLegendPosition
- BasicChartAxis
- BasicChartAxisPosition
- ChartAxisViewWindowOptions
- ViewWindowMode
- BasicChartDomain
- ChartData
- ChartSourceRange
- ChartGroupRule
- ChartDateTimeRule
- ChartDateTimeRuleType
- ChartHistogramRule
- ChartAggregateType
- BasicChartSeries
- LineStyle
- LineDashType
- DataLabel
- DataLabelType
- DataLabelPlacement
- PointStyle
- PointShape
- BasicSeriesDataPointStyleOverride
- BasicChartStackedType
- BasicChartCompareMode
- PieChartSpec
- PieChartLegendPosition
- BubbleChartSpec
- BubbleChartLegendPosition
- CandlestickChartSpec
- CandlestickDomain
- CandlestickData
- CandlestickSeries
- OrgChartSpec
- OrgChartNodeSize
- HistogramChartSpec
- HistogramSeries
- HistogramChartLegendPosition
- WaterfallChartSpec
- WaterfallChartDomain
- WaterfallChartSeries
- WaterfallChartColumnStyle
- WaterfallChartCustomSubtotal
- WaterfallChartStackedType
- TreemapChartSpec
- TreemapChartColorScale
- ScorecardChartSpec
- KeyValueFormat
- BaselineValueFormat
- ComparisonType
- ChartNumberFormatSource
- ChartCustomNumberFormatOptions
- ChartHiddenDimensionStrategy
- EmbeddedObjectPosition
- OverlayPosition
- GridCoordinate
- EmbeddedObjectBorder
- BandedRange
- BandingProperties
- DimensionGroup
- Slicer
- SlicerSpec
- Table
- TableRowsProperties
- TableColumnProperties
- ColumnType
- TableColumnDataValidationRule
- CommentAnchor
- NamedRange
- DataSource
- DataSourceSpec
- BigQueryDataSourceSpec
- BigQueryQuerySpec
- BigQueryTableSpec
- LookerDataSourceSpec
- DataSourceParameter
- DataSourceRefreshSchedule
- DataSourceRefreshScope
- DataSourceRefreshDailySchedule
- TimeOfDay
- DataSourceRefreshWeeklySchedule
- DayOfWeek
- DataSourceRefreshMonthlySchedule
- Intervall
- CommentThread
- Beitrag
- PostAuthor
- CommentActionType
- Status
- CommentsViewMode
- Methoden
Ressource: Tabellenkalkulation
Ressource, die eine Tabelle darstellt.
| JSON-Darstellung |
|---|
{ "spreadsheetId": string, "properties": { object ( |
| Felder | |
|---|---|
spreadsheetId |
Die ID der Tabelle. Dieses Feld ist schreibgeschützt. |
properties |
Allgemeine Eigenschaften einer Tabelle. |
sheets[] |
Die Tabellenblätter, die Teil einer Tabelle sind. |
namedRanges[] |
Die in einer Tabelle definierten benannten Bereiche. |
spreadsheetUrl |
Die URL der Tabelle. Dieses Feld ist schreibgeschützt. |
developerMetadata[] |
Die mit einer Tabelle verknüpften Entwicklermetadaten. |
dataSources[] |
Eine Liste der externen Datenquellen, die mit der Tabelle verbunden sind. |
dataSourceSchedules[] |
Nur Ausgabe. Eine Liste der Zeitpläne für die Aktualisierung von Datenquellen. |
comments[] |
Die mit der Tabelle verknüpften Kommentarthreads. |
commentsViewMode |
Nur Ausgabe. Der auf die Tabelle angewendete Ansichtsmodus für Kommentare. |
SpreadsheetProperties
Eigenschaften einer Tabelle.
| JSON-Darstellung |
|---|
{ "title": string, "locale": string, "autoRecalc": enum ( |
| Felder | |
|---|---|
title |
Der Titel der Tabelle. |
locale |
Die Sprache der Tabelle in einem der folgenden Formate:
Hinweis: Beim Aktualisieren dieses Felds werden nicht alle Gebietsschemas/Sprachen unterstützt. |
autoRecalc |
Die Zeit, die gewartet werden soll, bevor volatile Funktionen neu berechnet werden. |
timeZone |
Die Zeitzone der Tabelle im CLDR-Format, z. B. |
defaultFormat |
Das Standardformat aller Zellen in der Tabelle. |
iterativeCalculationSettings |
Legt fest, ob und wie Zirkelbezüge durch iterative Berechnung aufgelöst werden. Wenn dieses Feld fehlt, führen zirkuläre Verweise zu Berechnungsfehlern. |
spreadsheetTheme |
Auf die Tabelle angewendetes Design. |
importFunctionsExternalUrlAccessAllowed |
Gibt an, ob der Zugriff auf externe URLs für Bild- und Importfunktionen zulässig sein soll. Nur Lesezugriff, wenn „true“. Wenn der Wert „false“ ist, können Sie ihn auf „true“ setzen. Dieser Wert wird umgangen und gibt immer „true“ zurück, wenn der Administrator die Zulassungslistenfunktion aktiviert hat. |
RecalculationInterval
Eine Aufzählung der möglichen Optionen für das Neuberechnungsintervall.
| Enums | |
|---|---|
RECALCULATION_INTERVAL_UNSPECIFIED |
Standardwert. Dieser Wert darf nicht verwendet werden. |
ON_CHANGE |
Veränderliche Funktionen werden bei jeder Änderung aktualisiert. |
MINUTE |
Veränderliche Funktionen werden bei jeder Änderung und jede Minute aktualisiert. |
HOUR |
Veränderliche Funktionen werden bei jeder Änderung und stündlich aktualisiert. |
IterativeCalculationSettings
Einstellungen, mit denen gesteuert wird, wie Zirkelbezüge durch iterative Berechnung aufgelöst werden.
| JSON-Darstellung |
|---|
{ "maxIterations": integer, "convergenceThreshold": number } |
| Felder | |
|---|---|
maxIterations |
Wenn die iterative Berechnung aktiviert ist, die maximale Anzahl der Berechnungsrunden, die ausgeführt werden sollen. |
convergenceThreshold |
Wenn die iterative Berechnung aktiviert ist und sich aufeinanderfolgende Ergebnisse um weniger als diesen Grenzwert unterscheiden, werden die Berechnungsrunden beendet. |
SpreadsheetTheme
Stellt ein Tabellendesign dar.
| JSON-Darstellung |
|---|
{
"primaryFontFamily": string,
"themeColors": [
{
object ( |
| Felder | |
|---|---|
primaryFontFamily |
Name der primären Schriftfamilie. |
themeColors[] |
Die Farbpaare des Tabellendesigns. Für die Aktualisierung müssen Sie alle Farbpaare des Designs angeben. |
ThemeColorPair
Ein Paar, das einen Tabellen-Designfarbtyp der konkreten Farbe zuordnet, die er darstellt.
| JSON-Darstellung |
|---|
{ "colorType": enum ( |
| Felder | |
|---|---|
colorType |
Der Typ der Tabellen-Designfarbe. |
color |
Die konkrete Farbe, die dem Designfarbtyp entspricht. |
NamedRange
Ein benannter Bereich.
| JSON-Darstellung |
|---|
{
"namedRangeId": string,
"name": string,
"range": {
object ( |
| Felder | |
|---|---|
namedRangeId |
Die ID des benannten Bereichs. |
name |
Der Name des benannten Bereichs. |
range |
Der Bereich, den dieser Wert darstellt. |
DataSource
Informationen zu einer externen Datenquelle in der Tabelle.
| JSON-Darstellung |
|---|
{ "dataSourceId": string, "spec": { object ( |
| Felder | |
|---|---|
dataSourceId |
Die eindeutige ID der Datenquelle, die auf die Tabelle beschränkt ist. Beispiel: 1080547365. |
spec |
Die |
calculatedColumns[] |
Alle berechneten Spalten in der Datenquelle. |
sheetId |
Die ID des Wenn Sie eine Datenquelle erstellen, wird auch ein zugehöriges |
DataSourceSpec
Hier werden die Details der Datenquelle angegeben. Für BigQuery werden hier beispielsweise Informationen zur BigQuery-Quelle angegeben.
| JSON-Darstellung |
|---|
{ "parameters": [ { object ( |
| Felder | |
|---|---|
parameters[] |
Die Parameter der Datenquelle, die beim Abfragen der Datenquelle verwendet werden. |
Union-Feld spec. Die tatsächliche Spezifikation pro Datenquellentyp. Für spec ist nur einer der folgenden Werte zulässig: |
|
bigQuery |
|
looker |
Ein [LookerDatasourceSpec][]. |
BigQueryDataSourceSpec
Die Spezifikation einer BigQuery-Datenquelle, die mit einem Tabellenblatt verbunden ist.
| JSON-Darstellung |
|---|
{ "projectId": string, "querySpec": { object ( |
| Felder | |
|---|---|
projectId |
Die ID eines Google Cloud-Projekts mit aktivierter BigQuery-Funktion und einem verknüpften Abrechnungskonto. Für alle Abfragen, die für die Datenquelle ausgeführt werden, wird das Projekt in Rechnung gestellt. |
Union-Feld spec. Die tatsächliche Spezifikation. Für spec ist nur einer der folgenden Werte zulässig: |
|
querySpec |
|
tableSpec |
|
BigQueryQuerySpec
Gibt eine benutzerdefinierte BigQuery-Abfrage an.
| JSON-Darstellung |
|---|
{ "rawQuery": string } |
| Felder | |
|---|---|
rawQuery |
Der Rohabfragestring. |
BigQueryTableSpec
Gibt eine BigQuery-Tabellendefinition an. Es sind nur native Tabellen zulässig.
| JSON-Darstellung |
|---|
{ "tableProjectId": string, "tableId": string, "datasetId": string } |
| Felder | |
|---|---|
tableProjectId |
Die ID eines BigQuery-Projekts, zu dem die Tabelle gehört. Wenn nichts angegeben wurde, wird von einem |
tableId |
Die BigQuery-Tabellen-ID. |
datasetId |
Die BigQuery-Dataset-ID. |
LookerDataSourceSpec
Die Spezifikation einer Looker-Datenquelle.
| JSON-Darstellung |
|---|
{ "instanceUri": string, "model": string, "explore": string } |
| Felder | |
|---|---|
instanceUri |
Eine Looker-Instanz-URL. |
model |
Name eines Looker-Modells. |
explore |
Name eines Looker-Modell-Explores. |
DataSourceParameter
Ein Parameter in der Abfrage einer Datenquelle. Mit dem Parameter kann der Nutzer Werte aus der Tabelle in eine Abfrage einfügen.
| JSON-Darstellung |
|---|
{
"name": string
"namedRangeId": string,
"range": {
object ( |
| Felder | |
|---|---|
Union-Feld identifier. Die Parameter-ID. Für identifier ist nur einer der folgenden Werte zulässig: |
|
name |
Benannter Parameter. Muss eine gültige Kennzeichnung für die |
Union-Feld value. Der Parameterwert. Für value ist nur einer der folgenden Werte zulässig: |
|
namedRangeId |
ID eines |
range |
Ein Bereich, der den Wert des Parameters enthält. Die Größe muss 1 × 1 sein. |
DataSourceRefreshSchedule
Zeitplan für die Aktualisierung der Datenquelle.
Datenquellen in der Tabelle werden innerhalb eines Zeitintervalls aktualisiert. Sie können die Startzeit festlegen, indem Sie im Sheets-Editor auf die Schaltfläche „Geplante Aktualisierung“ klicken. Das Intervall ist jedoch auf 4 Stunden festgelegt. Wenn Sie beispielsweise eine Startzeit von 8:00 Uhr angeben, erfolgt die Aktualisierung täglich zwischen 8:00 und 12:00 Uhr.
| JSON-Darstellung |
|---|
{ "enabled": boolean, "refreshScope": enum ( |
| Felder | |
|---|---|
enabled |
„True“, wenn der Aktualisierungszeitplan aktiviert ist, andernfalls „false“. |
refreshScope |
Der Umfang der Aktualisierung. Muss |
nextRun |
Nur Ausgabe. Das Zeitintervall des nächsten Laufs. |
Union-Feld schedule_config. Für die Zeitplankonfigurationen schedule_config ist nur einer der folgenden Werte zulässig: |
|
dailySchedule |
Täglicher Aktualisierungszeitplan. |
weeklySchedule |
Wöchentlicher Aktualisierungszeitplan. |
monthlySchedule |
Zeitplan für die monatliche Aktualisierung. |
DataSourceRefreshScope
Die Aktualisierungsbereiche der Datenquelle.
| Enums | |
|---|---|
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED |
Standardwert, nicht verwenden. |
ALL_DATA_SOURCES |
Aktualisiert alle Datenquellen und die zugehörigen Datenquellenobjekte in der Tabelle. |
DataSourceRefreshDailySchedule
Ein Zeitplan, nach dem Daten jeden Tag in einem bestimmten Zeitintervall aktualisiert werden.
| JSON-Darstellung |
|---|
{
"startTime": {
object ( |
| Felder | |
|---|---|
startTime |
Die Startzeit eines Zeitintervalls, in dem eine Aktualisierung der Datenquelle geplant ist. Nur der |
TimeOfDay
Stellt eine Tageszeit dar. Das Datum und die Zeitzone sind entweder nicht relevant oder werden an anderer Stelle angegeben. Eine API kann Schaltsekunden zulassen. Vergleichbare Typen sind google.type.Date und google.protobuf.Timestamp.
| JSON-Darstellung |
|---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
| Felder | |
|---|---|
hours |
Stunden eines Tages im 24-Stunden-Format. Muss größer oder gleich 0 und in der Regel kleiner oder gleich 23 sein. Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen. |
minutes |
Minuten einer Stunde. Muss größer oder gleich 0 und kleiner oder gleich 59 sein. |
seconds |
Sekunden einer Minute. Muss größer oder gleich 0 und in der Regel kleiner oder gleich 59 sein. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt. |
nanos |
Sekundenbruchteile in Nanosekunden. Muss größer oder gleich 0 und kleiner oder gleich 999.999.999 sein. |
DataSourceRefreshWeeklySchedule
Ein wöchentlicher Zeitplan für die Aktualisierung von Daten an bestimmten Tagen in einem bestimmten Zeitintervall.
| JSON-Darstellung |
|---|
{ "startTime": { object ( |
| Felder | |
|---|---|
startTime |
Die Startzeit eines Zeitintervalls, in dem eine Aktualisierung der Datenquelle geplant ist. Nur der |
daysOfWeek[] |
Wochentage, an denen die Daten aktualisiert werden sollen. Es muss mindestens ein Tag angegeben werden. |
DayOfWeek
Steht für einen Wochentag.
| Enums | |
|---|---|
DAY_OF_WEEK_UNSPECIFIED |
Der Wochentag ist nicht angegeben. |
MONDAY |
Montag |
TUESDAY |
Dienstag |
WEDNESDAY |
Mittwoch |
THURSDAY |
Donnerstag |
FRIDAY |
Freitag |
SATURDAY |
Samstag |
SUNDAY |
Sonntag |
DataSourceRefreshMonthlySchedule
Ein monatlicher Zeitplan für die Aktualisierung von Daten an bestimmten Tagen im Monat in einem bestimmten Zeitintervall.
| JSON-Darstellung |
|---|
{
"startTime": {
object ( |
| Felder | |
|---|---|
startTime |
Die Startzeit eines Zeitintervalls, in dem eine Aktualisierung der Datenquelle geplant ist. Nur der |
daysOfMonth[] |
Tage des Monats, an denen die Daten aktualisiert werden sollen. Es werden nur die Werte 1 bis 28 unterstützt, die dem 1. bis zum 28. Tag entsprechen. Es muss mindestens ein Tag angegeben werden. |
Intervall
Stellt ein Zeitintervall dar, das als Zeitstempelstart (einschließlich) und Zeitstempelende (ausschließlich) codiert ist.
Der Start muss kleiner oder gleich dem Ende sein. Wenn der Start dem Ende entspricht, ist das Intervall leer (die Zeit ist null). Wenn sowohl der Start als auch das Ende nicht angegeben sind, entspricht das Intervall einer beliebigen Zeit.
| JSON-Darstellung |
|---|
{ "startTime": string, "endTime": string } |
| Felder | |
|---|---|
startTime |
Optional. Eingeschlossener Start des Intervalls. Wenn angegeben, muss ein Zeitstempel, der diesem Intervall entspricht, gleich dem Start sein oder darauf folgen. |
endTime |
Optional. Ausgeschlossenes Ende des Intervalls. Wenn angegeben, muss ein Zeitstempel, der diesem Intervall entspricht, vor dem Ende liegen. |
CommentThread
Stellt einen einzelnen Kommentarthread in einer Tabelle dar.
| JSON-Darstellung |
|---|
{ "commentId": string, "anchorId": string, "headPost": { object ( |
| Felder | |
|---|---|
commentId |
Die eindeutige ID des Kommentar-Threads. |
anchorId |
Die ID des |
headPost |
Der erste Beitrag im Thread. |
replies[] |
Antworten auf den Hauptbeitrag. |
status |
Gibt an, ob die Konversation offen oder geschlossen ist. |
Union-Feld quote. Der zitierte Text aus dem Dokument, als der Kommentar erstellt wurde. Für quote ist nur einer der folgenden Werte zulässig: |
|
plainTextQuote |
Der zitierte Text aus der Tabelle, als der Kommentar erstellt wurde, formatiert als Nur-Text. |
Posten
Stellt einen einzelnen Beitrag in einem Kommentarthread dar.
| JSON-Darstellung |
|---|
{ "postId": string, "content": string, "contentHtml": string, "author": { object ( |
| Felder | |
|---|---|
postId |
Nur Ausgabe. Die eindeutige ID des Beitrags. |
content |
Der Inhalt des Beitrags. Darf nicht leer sein, wenn Diese Textinhalte werden ähnlich wie Kommentare behandelt, die im Sheets-Editor erstellt wurden. Die Formatierung und Benachrichtigungen sind ähnlich. Darf nicht mehr als 2.048 UTF‑8-Codeeinheiten enthalten. |
contentHtml |
Nur Ausgabe. Der Inhalt des Beitrags als HTML-Code. |
author |
Nur Ausgabe. Der Nutzer, der den Beitrag erstellt hat. |
createTime |
Nur Ausgabe. Der Zeitpunkt, zu dem der Beitrag erstellt wurde. |
updateTime |
Nur Ausgabe. Der Zeitpunkt, zu dem der Beitrag zuletzt aktualisiert wurde. |
deleted |
Nur Ausgabe. Gibt an, ob der Beitrag gelöscht wurde. Wenn |
fromImportedSpreadsheet |
Nur Ausgabe. Gibt an, ob der Beitrag aus einer importierten Tabelle stammt. Dieses Feld kann nicht direkt von Anrufern festgelegt werden. |
fromCopiedSpreadsheet |
Nur Ausgabe. Gibt an, ob der Beitrag aus einer kopierten Tabelle stammt. Dieses Feld kann nicht direkt von Anrufern festgelegt werden. |
assigneeEmail |
Optional. Die E-Mail-Adresse des Nutzers, der dem Thread im Rahmen dieses Beitrags neu zugewiesen wird. Gibt einen 400-Fehler (ungültige Anfrage) zurück, wenn:
|
commentAction |
Im Rahmen der Erstellung des Beitrags ergriffene Maßnahme. |
PostAuthor
Stellt einen Nutzer dar, der einen Kommentarbeitrag verfasst hat.
| JSON-Darstellung |
|---|
{ "displayName": string, "me": boolean, "anonymous": boolean, "user": string } |
| Felder | |
|---|---|
displayName |
Der Anzeigename des Nutzers. Kann fehlen, wenn der Autor anonym ist. |
me |
Gibt an, ob der Nutzer der authentifizierte Nutzer ist, der die Anfrage stellt. |
anonymous |
Gibt an, ob der Nutzer anonym ist. |
user |
Der Ressourcenname des Nutzers, der den Beitrag verfasst hat. Er kann auch verwendet werden, um den Nutzer in der Google People API zu identifizieren. Format: |
CommentActionType
Die Aktion, die mit dieser Antwort auf einen Kommentar-Thread ausgeführt wurde.
| Enums | |
|---|---|
COMMENT_ACTION_TYPE_UNSPECIFIED |
Standardwert. Dieser Wert wird nicht verwendet. |
NO_COMMENT_ACTION_CHANGE |
In diesem Beitrag gibt es keine Änderungen an den Maßnahmen. |
RESOLVE |
Dieser Beitrag schließt den Thread. |
REOPEN |
Mit diesem Beitrag wird die Konversation wieder geöffnet. |
Status
Die Statusoptionen des Kommentarbereichs.
| Enums | |
|---|---|
STATUS_UNSPECIFIED |
Standardwert. Dieser Wert wird nicht verwendet. |
OPEN |
Der Kommentar-Thread ist geöffnet. |
RESOLVED |
Der Kommentar-Thread wurde geklärt. |
CommentsViewMode
Der auf die Tabelle angewendete Kommentarmodus, der angibt, ob Kommentare enthalten sind. Sie können die Tabelle mit oder ohne Kommentare und Kommentaranker lesen.
| Enums | |
|---|---|
COMMENTS_VIEW_MODE_UNSPECIFIED |
Der CommentsViewMode ist nicht angegeben. COMMENTS_VIEW_MODE_OMITTED wird angewendet. |
COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS |
Der auf die zurückgegebene Tabelle angewendete CommentsViewMode hängt von der aktuellen Zugriffsebene des Nutzers ab. Wenn der Nutzer nur Lesezugriff hat, wird COMMENTS_VIEW_MODE_OMITTED angewendet. Andernfalls wird COMMENTS_VIEW_MODE_INCLUDED angewendet. |
COMMENTS_VIEW_MODE_OMITTED |
In der zurückgegebenen Tabelle fehlen Kommentare. |
COMMENTS_VIEW_MODE_INCLUDED |
Die zurückgegebene Tabelle enthält Kommentare. Bei Anfragen zum Abrufen einer Tabelle in diesem Modus wird der Fehler „403“ zurückgegeben, wenn der Nutzer keine Berechtigung zum Ansehen von Kommentaren hat. |
Methoden |
|
|---|---|
|
Wendet ein oder mehrere Updates auf die Tabelle an. |
|
Erstellt eine Tabelle und gibt die neu erstellte Tabelle zurück. |
|
Gibt die Tabelle mit der angegebenen ID zurück. |
|
Gibt die Tabelle mit der angegebenen ID zurück. |