Cells

Mobile Daten

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: Datumsangaben, Uhrzeiten und Datum/Uhrzeit werden als Doppelwerte im Format serial number dargestellt.

effectiveValue

object (ExtendedValue)

Effektiver Wert der Zelle. Bei Zellen mit Formeln ist dies der berechnete Wert. Bei Zellen mit Literalen ist dies mit „userEnteredValue“ identisch. Dieses Feld ist schreibgeschützt.

formattedValue

string

Der formatierte Wert der Zelle. Dieser Wert wird dem Nutzer so angezeigt. 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 von der Zelle verwendete effektive Format. Dies beinhaltet die Ergebnisse der Anwendung einer bedingten Formatierung und, sofern die Zelle eine Formel enthält, das berechnete Zahlenformat. Wenn das effektive Format das Standardformat ist, wird es nicht geschrieben. Dieses Feld ist schreibgeschützt.

note

string

Beliebige Notiz in der Zelle.

textFormatRuns[]

object (TextFormatRun)

Ausführungen von RTF, die auf Unterbereiche der Zelle angewendet werden Ausführungen sind nur für vom Nutzer eingegebene Strings und nicht für Formeln, boolesche Werte oder Zahlen gültig. Die Eigenschaften einer Ausführung beginnen an einem bestimmten Indexwert und werden bis zur nächsten Ausführung fortgesetzt. Für Ausführungen werden die Eigenschaften der Zelle übernommen, sofern sie nicht explizit geändert werden.

Beim Schreiben werden alle vorherigen Ausführungen durch die neuen Ausführungen überschrieben. Wenn Sie eine neue userEnteredValue schreiben, werden vorherige Ausführungen 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 anhand der Daten, der Gruppierung, der Filter, der Werte usw. dynamisch berechnet. Nur die linke obere Zelle der Pivot-Tabelle enthält die Definition für die Pivot-Tabelle. Die anderen Zellen enthalten die berechneten Werte der Ergebnisse der Pivot-Tabelle in ihren effectiveValue-Feldern.

dataSourceTable

object (DataSourceTable)

Eine Datenquellentabelle, die in dieser Zelle verankert ist. Die Größe der Datenquellentabelle selbst wird dynamisch anhand ihrer Konfiguration berechnet. Nur die erste Zelle der Datenquellentabelle enthält die Definition der Datenquellentabelle. Die anderen Zellen enthalten die Anzeigewerte der Datenquellentabelle in den effectiveValue-Feldern.

dataSourceFormula

object (DataSourceFormula)

Nur Ausgabe. Informationen zu einer Datenquellenformel für die Zelle. Das Feld wird festgelegt, wenn userEnteredValue eine Formel ist, die auf ein DATA_SOURCE-Tabellenblatt verweist, z.B. =SUM(DataSheet!Column).

Zellformat

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 Sie backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

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

borders

object (Borders)

Rahmenlinien der Zelle.

padding

object (Padding)

Abstand der Zelle

horizontalAlignment

enum (HorizontalAlign)

Die horizontale Ausrichtung des Werts in der Zelle.

verticalAlignment

enum (VerticalAlign)

Die 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 er nicht durch eine Formatausführung überschrieben wurde. Wenn Sie hier einen Link auf Zellenebene festlegen, werden die vorhandenen Links der Zelle gelöscht. Das Festlegen des Linkfelds in einem TextFormatRun hat Vorrang vor dem Link auf Zellebene.

textRotation

object (TextRotation)

Die Rotation wird auf den Text in der Zelle angewendet.

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 verwendeter Musterstring. Wenn die Richtlinie nicht konfiguriert ist, wird gegebenenfalls ein Standardmuster verwendet, das auf dem Gebietsschema des Nutzers basiert. Weitere Informationen zu den unterstützten Mustern finden Sie unter Datums- und Zahlenformate.

ZahlenformatTyp

Das Zahlenformat der Zelle. In dieser Dokumentation wird davon ausgegangen, dass die Sprache „en_US“ ist. Das tatsächliche Format hängt jedoch von der Sprache der Tabelle ab.

Enums
NUMBER_FORMAT_TYPE_UNSPECIFIED Das Zahlenformat ist nicht angegeben und basiert auf dem Inhalt der Zelle. Verwenden Sie dies nicht explizit.
TEXT Textformatierung, z. B. 1000.12
NUMBER Zahlenformatierung, z. B. 1,000.12
PERCENT Formatierung in Prozent, 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 Format der wissenschaftlichen Nummer, z. B. 1.01E+03

Rahmen

Rahmenlinien der Zelle.

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

object (Border)

Der obere Rand der Zelle.

bottom

object (Border)

Unterer Rahmen der Zelle

left

object (Border)

Linker Rand der Zelle

right

object (Border)

Der rechte Rand der Zelle.

Rahmenlinie

Rahmenlinien entlang einer Zelle

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

enum (Style)

Der Stil der Rahmenlinie.

width
(deprecated)

integer

Breite des Rahmens in Pixeln Verworfen; die Breite wird vom Feld "style" bestimmt.

color
(deprecated)

object (Color)

Die Farbe des Rahmens. Eingestellt: Verwenden Sie colorStyle.

colorStyle

object (ColorStyle)

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

Stil

Der Stil eines Rahmens

Enums
STYLE_UNSPECIFIED Der Stil ist nicht angegeben. Verwende dieses Attribut nicht.
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 mittlere 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 ist zwei durchgehende Linien.

Abstand

Der Abstand zwischen den Zellen in Pixeln. Beim Aktualisieren des Abstands muss jedes Feld angegeben werden.

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

integer

Abstand zwischen Zellen

right

integer

Der rechte Abstand der Zelle.

bottom

integer

Abstand zwischen den Zellen.

left

integer

Linker Abstand der Zelle.

Vertikal ausrichten

Die vertikale Ausrichtung von Text in einer Zelle.

Enums
VERTICAL_ALIGN_UNSPECIFIED Die vertikale Ausrichtung ist nicht angegeben. Verwende dieses Attribut nicht.
TOP Der Text wird explizit oben in die Zelle ausgerichtet.
MIDDLE Der Text wird explizit auf die Mitte der Zelle ausgerichtet.
BOTTOM Der Text wird explizit unten auf die Zelle ausgerichtet.

WrapStrategy

Text in einer Zelle umbrechen.

Enums
WRAP_STRATEGY_UNSPECIFIED Der Standardwert, nicht verwenden.
OVERFLOW_CELL

Zeilen, die länger als die Zellenbreite sind, werden in die nächste Zelle übertragen, sofern diese Zelle leer ist. Wenn die nächste Zelle darüber nicht leer ist, entspricht dies dem Verhalten von CLIP. Der Text wird nie in die nächste Zeile 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 Wrapping-Strategie stellt die alte Google Tabellen-Wrapping-Strategie dar, bei der Wörter, die länger als eine Zeile sind, abgeschnitten werden, nicht kaputt. Diese Strategie wird nicht auf allen Plattformen unterstützt und wird eingestellt. Beispiel:

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

Zeilen, die länger als die Zellenbreite sind, werden abgeschnitten. Der Text wird nie in die nächste Zeile 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 umschlossen, aber nicht abgeschnitten. Beispiel:

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

Textrichtung

Die Textrichtung in einer Zelle.

Enums
TEXT_DIRECTION_UNSPECIFIED Die Textrichtung ist nicht angegeben. Verwende dieses Attribut nicht.
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.

HyperLink-Displaytyp

Gibt an, ob ein Hyperlink explizit gerendert werden soll. Wenn nicht angegeben, ist der Hyperlink verknüpft.

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

Textrotation

Die Rotation wird auf den Text in einer Zelle angewendet.

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 Rotation, vertikal oder schräg. type darf nur einer der folgenden Werte sein:
angle

integer

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

Hinweis: In der Leserichtung für LTR-Text liegen positive Winkel in entgegengesetzte Richtungen, bei LÜ-Text dagegen im Uhrzeigersinn.

vertical

boolean

Bei „true“ wird Text von oben nach unten gelesen, aber die Ausrichtung der einzelnen Zeichen bleibt unverändert. Beispiel:

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

TextFormatRun

Die Ausführung im Textformat. Das Format dieser Ausführung wird bis zum Startindex der nächsten Ausführung fortgesetzt. Bei der Aktualisierung 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.

DataValidierungsregel

Eine Datenvalidierungsregel.

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

object (BooleanCondition)

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

inputMessage

string

Eine Nachricht, die dem Nutzer angezeigt wird, wenn er Daten in die Zelle einfügt.

strict

boolean

„true“, wenn ungültige Daten abgelehnt werden sollen.

showCustomUi

boolean

„true“, wenn die UI entsprechend der Bedingungsart angepasst werden soll. Bei „true“ wird für Bedingungen vom Typ „Liste“ ein Drop-down-Menü angezeigt.

Datenquelle/Tabelle

Eine Datenquellentabelle, mit der der Nutzer eine statische Tabelle mit Daten aus dem DataSource in Google Tabellen importieren kann. Das wird im Google Tabellen-Editor auch als „Extrahieren“ bezeichnet.

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, mit dem Spalten für die Datenquellentabelle ausgewählt werden. Die Standardeinstellung ist SELECTED.

columns[]

object (DataSourceColumnReference)

Für die Tabelle der Datenquelle ausgewählte Spalten. columnSelectionType muss SELECTED sein.

filterSpecs[]

object (FilterSpec)

Spezifikationen in der Datenquellentabelle filtern

sortSpecs[]

object (SortSpec)

Spezifikationen in der Datenquellentabelle sortieren Das Ergebnis der Datenquellentabelle wird entsprechend der Sortierspezifikationen sortiert.

rowLimit

integer

Das Limit der zurückzugebenden Zeilen. Wenn die Richtlinie nicht konfiguriert ist, wird ein Standardlimit angewendet. Die Standard- und Höchstgrenze im Tabelleneditor.

dataExecutionStatus

object (DataExecutionStatus)

Nur Ausgabe. Der Status der Datenausführung.

DataSourceTableColumnSelectionType

Die Auswahltypen für die Tabellenspalten der Datenquelle.

Enums
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED Der Standardauswahltyp für Spalten, nicht verwenden.
SELECTED Wählen Sie die im Feld columns angegebenen Spalten aus.
SYNC_ALL

Alle aktuellen und zukünftigen Spalten in der Datenquelle synchronisieren

Wenn festgelegt, ruft die Datenquellentabelle alle Spalten in der Datenquelle zum Zeitpunkt der Aktualisierung ab.

DatenquelleFormel

Eine Formel für eine 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.