Cells

CellData

Daten zu einer bestimmten Zelle.

JSON-Darstellung
{
  "userEnteredValue": {
    object (ExtendedValue)
  },
  "effectiveValue": {
    object (ExtendedValue)
  },
  "formattedValue": string,
  "userEnteredFormat": {
    object (CellFormat)
  },
  "effectiveFormat": {
    object (CellFormat)
  },
  "hyperlink": string,
  "note": string,
  "textFormatRuns": [
    {
      object (TextFormatRun)
    }
  ],
  "dataValidation": {
    object (DataValidationRule)
  },
  "pivotTable": {
    object (PivotTable)
  },
  "dataSourceTable": {
    object (DataSourceTable)
  },
  "dataSourceFormula": {
    object (DataSourceFormula)
  }
}
Felder
userEnteredValue

object (ExtendedValue)

Der Wert, den der Nutzer in die Zelle eingegeben hat. z.B. 1234, 'Hello' oder =NOW() Hinweis: Datum, Uhrzeit und Datum/Uhrzeit werden in serial number Format.

effectiveValue

object (ExtendedValue)

Der Effektivwert der Zelle. Bei Zellen mit Formeln ist dies der berechnete Wert. Bei Zellen mit Literalen entspricht dies dem userEnteredValue. Dieses Feld ist schreibgeschützt.

formattedValue

string

Der formatierte Wert der Zelle. Dies ist der Wert, wie er dem Nutzer angezeigt wird. Dieses Feld ist schreibgeschützt.

userEnteredFormat

object (CellFormat)

Das Format, das der Nutzer für die Zelle eingegeben hat.

Beim Schreiben wird das neue Format mit dem vorhandenen Format zusammengeführt.

effectiveFormat

object (CellFormat)

Das effektive Format, das von der Zelle verwendet wird. Dazu gehören die Ergebnisse der bedingten Formatierung und das berechnete Zahlenformat, sofern die Zelle eine Formel enthält. Wenn das geltende Format das Standardformat ist, wird kein effektives Format geschrieben. Dieses Feld ist schreibgeschützt.

note

string

Notiz in der Zelle.

textFormatRuns[]

object (TextFormatRun)

Rich-Text-Ausführungen, die auf Unterabschnitte der Zelle angewendet werden. Ausführungen sind nur für vom Nutzer eingegebene Strings gültig, nicht für Formeln, boolesche oder Zahlen. Die Eigenschaften einer Ausführung beginnen bei einem bestimmten Index im Text und dauern bis zur nächsten Ausführung an. Durch Ausführungen werden die Eigenschaften der Zelle übernommen, sofern sie nicht ausdrücklich geändert werden.

Beim Schreiben überschreiben die neuen Ausführungen alle vorherigen Ausführungen. Wenn Sie eine neue userEnteredValue, vorherige Ausführungen werden gelöscht.

dataValidation

object (DataValidationRule)

Eine Datenvalidierungsregel für die Zelle, falls vorhanden.

Beim Schreiben überschreibt die neue Datenvalidierungsregel alle vorherigen Regeln.

pivotTable

object (PivotTable)

Eine Pivot-Tabelle, die in dieser Zelle verankert ist. Die Größe der Pivot-Tabelle selbst wird dynamisch basierend auf den Daten, der Gruppierung, den Filtern, den Werten usw. berechnet. Nur die linke obere Zelle der Pivot-Tabelle enthält die Definition der Pivot-Tabelle. Die anderen Zellen enthalten die berechneten Werte der Pivot-Ergebnisse in ihrer effectiveValue .

dataSourceTable

object (DataSourceTable)

Eine Datenquellentabelle, die bei dieser Zelle verankert ist. Die Größe der Datenquellentabelle selbst wird basierend auf ihrer Konfiguration dynamisch berechnet. Nur die erste Zelle der Datenquellentabelle enthält die Definition der Datenquellentabelle. Die anderen Zellen enthalten die Anzeigewerte des Datenquellentabellenergebnisses effectiveValue .

dataSourceFormula

object (DataSourceFormula)

Nur Ausgabe. Informationen zu einer Datenquellenformel in der Zelle. Das Feld ist festgelegt, wenn userEnteredValue ist eine Formel, die auf einige DATA_SOURCE Tabellenblatt, z.B. =SUM(DataSheet!Column)

CellFormat

Das Format einer Zelle.

JSON-Darstellung
{
  "numberFormat": {
    object (NumberFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "borders": {
    object (Borders)
  },
  "padding": {
    object (Padding)
  },
  "horizontalAlignment": enum (HorizontalAlign),
  "verticalAlignment": enum (VerticalAlign),
  "wrapStrategy": enum (WrapStrategy),
  "textDirection": enum (TextDirection),
  "textFormat": {
    object (TextFormat)
  },
  "hyperlinkDisplayType": enum (HyperlinkDisplayType),
  "textRotation": {
    object (TextRotation)
  }
}
Felder
numberFormat

object (NumberFormat)

Ein Format, das beschreibt, wie Zahlenwerte für den Nutzer dargestellt werden sollen.

backgroundColor
(deprecated)

object (Color)

Die Hintergrundfarbe der Zelle. Eingestellt: Verwenden backgroundColorStyle

backgroundColorStyle

object (ColorStyle)

Die Hintergrundfarbe der Zelle. Wenn backgroundColor festgelegt ist, hat dieses Feld Vorrang.

borders

object (Borders)

Die Ränder der Zelle.

padding

object (Padding)

Der Innenrand der Zelle.

horizontalAlignment

enum (HorizontalAlign)

Die horizontale Ausrichtung des Werts in der Zelle.

verticalAlignment

enum (VerticalAlign)

Vertikale Ausrichtung des Werts in der Zelle.

wrapStrategy

enum (WrapStrategy)

Die Wrapping-Strategie für den Wert in der Zelle.

textDirection

enum (TextDirection)

Die Textrichtung in der Zelle.

textFormat

object (TextFormat)

Das Format des Textes in der Zelle (sofern nicht durch eine Formatausführung überschrieben). Wenn Sie hier einen Link auf Zellenebene festlegen, werden die bestehenden Links der Zelle gelöscht. Das Link-Feld in einem TextFormatRun hat Vorrang vor dem Link auf Zellenebene.

textRotation

object (TextRotation)

Die Drehung, die auf den Text in der Zelle angewendet wird.

NumberFormat

Das Zahlenformat einer Zelle.

JSON-Darstellung
{
  "type": enum (NumberFormatType),
  "pattern": string
}
Felder
type

enum (NumberFormatType)

Der Typ des Zahlenformats. Beim Schreiben muss dieses Feld festgelegt werden.

pattern

string

Für die Formatierung verwendete Musterzeichenfolge. Wenn nichts festgelegt ist, wird bei Bedarf für den jeweiligen Typ ein auf dem Gebietsschema des Nutzers basierendes Standardmuster verwendet. Weitere Informationen finden Sie in der Leitfaden zu Datums- und Zahlenformaten finden Sie weitere Informationen zu den unterstützten Mustern.

NumberFormatType

Das Zahlenformat der Zelle. In dieser Dokumentation wird als Sprache en_US angenommen. Das tatsächliche Format hängt jedoch vom Gebietsschema der Tabelle ab.

Enums
NUMBER_FORMAT_TYPE_UNSPECIFIED Das Zahlenformat ist nicht angegeben und basiert auf dem Inhalt der Zelle. Verwenden Sie diese Option nicht explizit.
TEXT Textformatierung, z. B. 1000.12
NUMBER Zahlenformatierung, z. B. 1,000.12
PERCENT Prozentuale Formatierung, z. B. 10.12%
CURRENCY Währungsformatierung, z. B. $1,000.12
DATE Datumsformatierung, z. B. 9/26/2008
TIME Zeitformatierung, z. B. 3:59:00 PM
DATE_TIME Formatierung von Datum und Uhrzeit, z. B. 9/26/08 15:59:00
SCIENTIFIC Wissenschaftliche Zahlenformatierung, z. B. 1.01E+03

Rahmen

Die Ränder der Zelle.

JSON-Darstellung
{
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  }
}
Felder
top

object (Border)

Oberer Rahmen der Zelle

bottom

object (Border)

Der untere Rahmen der Zelle.

left

object (Border)

Der linke Rand der Zelle.

right

object (Border)

Den rechten Rand der Zelle.

Rahmen

Ein Rahmen entlang einer Zelle.

JSON-Darstellung
{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Felder
style

enum (Style)

Der Stil des Rahmens.

width
(deprecated)

integer

Die Breite des Rahmens in Pixeln. Verworfen; wird die Breite durch den Stil ein.

color
(deprecated)

object (Color)

Die Farbe des Rahmens. Eingestellt: Verwenden colorStyle

colorStyle

object (ColorStyle)

Die Farbe des Rahmens. Wenn color festgelegt ist, hat dieses Feld Vorrang.

Stil

Der Stil eines Rahmens.

Enums
STYLE_UNSPECIFIED Der Stil ist nicht angegeben. Nicht verwenden.
DOTTED Der Rahmen ist gepunktet.
DASHED Der Rahmen ist gestrichelt.
SOLID Der Rahmen ist eine dünne durchgehende Linie.
SOLID_MEDIUM Der Rahmen ist eine mittellange durchgehende Linie.
SOLID_THICK Der Rahmen ist eine dicke durchgehende Linie.
NONE Kein Rahmen. Wird nur zum Aktualisieren eines Rahmens verwendet, um ihn zu löschen.
DOUBLE Der Rahmen besteht aus zwei durchgehenden Linien.

Abstand

Der Abstand um die Zelle in Pixeln. Beim Aktualisieren des Paddings muss jedes Feld angegeben werden.

JSON-Darstellung
{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}
Felder
top

integer

Oberer Abstand der Zelle.

right

integer

Den rechten Rand der Zelle.

bottom

integer

Der untere Abstand der Zelle.

left

integer

Der linke Abstand der Zelle.

VerticalAlign

Vertikale Ausrichtung von Text in einer Zelle.

Enums
VERTICAL_ALIGN_UNSPECIFIED Die vertikale Ausrichtung ist nicht angegeben. Nicht verwenden.
TOP Der Text ist explizit am oberen Rand der Zelle ausgerichtet.
MIDDLE Der Text ist explizit an der Mitte der Zelle ausgerichtet.
BOTTOM Der Text ist explizit am unteren Rand der Zelle ausgerichtet.

WrapStrategy

So funktioniert ein Zeilenumbruch in einer Zelle.

Enums
WRAP_STRATEGY_UNSPECIFIED Standardwert, nicht verwenden.
OVERFLOW_CELL

Zeilen, die länger als die Zellenbreite sind, werden in die nächste Zelle geschrieben, solange diese Zelle leer ist. Ist die nächste Zelle über nicht leer, verhält sich das wie folgt: CLIP Der Text wird niemals umgebrochen, es sei denn, der Nutzer fügt manuell eine neue Zeile ein. Beispiel:

| First sentence. |
| Manual newline that is very long. <- Text continues into next cell
| Next newline.   |
LEGACY_WRAP

Diese Umbruchstrategie entspricht der alten Google Tabellen-Umbruchstrategie, bei der Wörter, die länger als eine Zeile sind, abgeschnitten werden, statt unterbrochen zu werden. Diese Strategie wird nicht auf allen Plattformen unterstützt und ist bald nicht mehr verfügbar. Beispiel:

| Cell has a |
| loooooooooo| <- Word is clipped.
| word.      |
CLIP

Linien, die länger als die Zellenbreite sind, werden abgeschnitten. Der Text wird niemals umgebrochen, es sei denn, der Nutzer fügt manuell eine neue Zeile ein. Beispiel:

| First sentence. |
| Manual newline t| <- Text is clipped
| Next newline.   |
WRAP

Wörter, die länger als eine Zeile sind, werden auf Zeichenebene umgebrochen und nicht abgeschnitten. Beispiel:

| Cell has a |
| loooooooooo| <- Word is broken.
| ong word.  |

TextDirection

Die Textrichtung in einer Zelle.

Enums
TEXT_DIRECTION_UNSPECIFIED Die Textrichtung ist nicht angegeben. Nicht verwenden.
LEFT_TO_RIGHT Die Textrichtung von links nach rechts wurde vom Nutzer festgelegt.
RIGHT_TO_LEFT Die Textrichtung von rechts nach links wurde vom Nutzer festgelegt.

HyperlinkDisplayType

Gibt an, ob ein Hyperlink explizit gerendert werden soll. Wenn keine Angabe erfolgt, wird der Hyperlink verknüpft.

Enums
LINKED Ein Hyperlink sollte explizit gerendert werden.
PLAIN_TEXT Ein Hyperlink sollte nicht gerendert werden.

TextRotation

Die Drehung, die auf den Text in einer Zelle angewendet wird.

JSON-Darstellung
{

  // Union field type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}
Felder
Union-Feld type Die Art der Drehung, vertikal oder schräg. type kann nur einer der folgenden Werte sein:
angle

integer

Der Winkel zwischen der Standardausrichtung und der gewünschten Ausrichtung. In Grad gemessen. Gültige Werte liegen zwischen -90 und 90. Positive Winkel sind nach oben, negative nach unten.

Hinweis: Positive Winkel in der Textrichtung „LTR“ entsprechen der Richtung gegen den Uhrzeigersinn, während sie für die Schreibrichtung von rechts nach links liegen.

vertical

boolean

Falls wahr, wird der Text von oben nach unten gelesen, die Ausrichtung einzelner Zeichen bleibt jedoch unverändert. Beispiel:

| V |
| e |
| r |
| t |
| i |
| c |
| a |
| l |

TextFormatRun

Eine Ausführung eines Textformats. Das Format dieser Ausführung wird bis zum Startindex der nächsten Ausführung fortgesetzt. Beim Aktualisieren müssen alle Felder festgelegt werden.

JSON-Darstellung
{
  "startIndex": integer,
  "format": {
    object (TextFormat)
  }
}
Felder
startIndex

integer

Der nullbasierte Zeichenindex, an dem diese Ausführung beginnt, in UTF-16-Codeeinheiten.

format

object (TextFormat)

Das Format dieser Ausführung. Für fehlende Werte wird das Format der Zelle übernommen.

DataValidationRule

Eine Datenvalidierungsregel.

JSON-Darstellung
{
  "condition": {
    object (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}
Felder
condition

object (BooleanCondition)

Die Bedingung, die die Daten in der Zelle erfüllen müssen.

inputMessage

string

Eine Nachricht, die dem Nutzer angezeigt wird, wenn er der Zelle Daten hinzufügt.

strict

boolean

"True", wenn ungültige Daten abgelehnt werden sollen.

showCustomUi

boolean

"True", wenn die Benutzeroberfläche basierend auf der Art der Bedingung angepasst werden soll. Falls wahr, "Liste" wird ein Drop-down-Menü angezeigt.

DataSourceTable

Eine Datenquellentabelle, mit der Nutzer eine statische Tabelle mit Daten aus dem DataSource in Google Tabellen hochladen. Dies wird auch als „Extrahieren“ im Google Tabellen-Editor ein.

JSON-Darstellung
{
  "dataSourceId": string,
  "columnSelectionType": enum (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Felder
dataSourceId

string

Die ID der Datenquelle, mit der die Datenquellentabelle verknüpft ist.

columnSelectionType

enum (DataSourceTableColumnSelectionType)

Der Typ zur Auswahl von Spalten für die Datenquellentabelle. Standardeinstellung: SELECTED

columns[]

object (DataSourceColumnReference)

Für die Datenquellentabelle ausgewählte Spalten. Die columnSelectionType muss SELECTED.

filterSpecs[]

object (FilterSpec)

Filterspezifikationen in der Datenquellentabelle.

sortSpecs[]

object (SortSpec)

Sortierspezifikationen in der Datenquellentabelle. Das Ergebnis der Datenquellentabelle wird basierend auf den Sortierspezifikationen der Reihe nach sortiert.

rowLimit

integer

Das Limit der zurückzugebenden Zeilen. Wenn die Richtlinie nicht konfiguriert ist, wird ein Standardlimit angewendet. Die Standard- und Höchstwerte finden Sie im Google Tabellen-Editor.

dataExecutionStatus

object (DataExecutionStatus)

Nur Ausgabe. Der Status der Datenausführung.

DataSourceTableColumnSelectionType

Die Auswahltypen der Spalten in der Datenquellentabelle.

Enums
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED Der standardmäßige Spaltenauswahltyp, nicht verwenden.
SELECTED Spalten auswählen durch columns ein.
SYNC_ALL

Alle aktuellen und zukünftigen Spalten in der Datenquelle synchronisieren.

Wenn dies festgelegt ist, werden mit der Datenquellentabelle alle Spalten in der Datenquelle zum Zeitpunkt der Aktualisierung abgerufen.

DataSourceFormula

Eine Formel für die Datenquelle.

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

string

Die ID der Datenquelle, mit der die Formel verknüpft ist.

dataExecutionStatus

object (DataExecutionStatus)

Nur Ausgabe. Der Status der Datenausführung.