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: Dates, Times und DateTimes werden als Double im Format serial number dargestellt.

effectiveValue

object (ExtendedValue)

Der effektive Wert der Zelle. Bei Zellen mit Formeln ist dies der berechnete Wert. Bei Zellen mit Literalen ist dies mit dem von Nutzern eingegebenen Wert identisch. Dieses Feld ist schreibgeschützt.

formattedValue

string

Der formatierte Wert der Zelle. Das ist der Wert, der 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 effektive Format das Standardformat ist, wird es nicht geschrieben. Dieses Feld ist schreibgeschützt.

note

string

Notiz in der Zelle.

textFormatRuns[]

object (TextFormatRun)

Abschnitte mit reichhaltigem Text, die auf Teilbereiche der Zelle angewendet werden. Durchläufe sind nur für von Nutzern eingegebene Strings gültig, nicht für Formeln, Boolesche Werte oder Zahlen. Die Eigenschaften eines Laufs beginnen an einem bestimmten Index im Text und dauern bis zum nächsten Lauf. 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 schreiben, werden vorherige Ausführungen gelöscht.

dataValidation

object (DataValidationRule)

Eine ggf. vorhandene Datenvalidierungsregel für die Zelle.

Beim Schreiben wird die neue Datenvalidierungsregel über jede vorherige Regel geschrieben.

pivotTable

object (PivotTable)

Eine an dieser Zelle verankerte Pivot-Tabelle. Die Größe der Pivot-Tabelle selbst wird dynamisch anhand der Daten, Gruppierungen, Filter, Werte usw. berechnet. Nur die Zelle links oben in der Pivot-Tabelle enthält die Definition der Pivot-Tabelle. Die anderen Zellen enthalten die berechneten Werte der Ergebnisse der Pivot-Tabelle in den Feldern effectiveValue.

dataSourceTable

object (DataSourceTable)

Eine an dieser Zelle verankerte Datenquellentabelle. 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 in den effectiveValue-Feldern die Anzeigewerte des Ergebnisses der Datenquellentabelle.

dataSourceFormula

object (DataSourceFormula)

Nur Ausgabe. Informationen zu einer Datenquellenformel in der Zelle. Das Feld wird festgelegt, wenn userEnteredValue eine Formel ist, die auf ein DATA_SOURCE-Tabellenblatt verweist, 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 dem Nutzer angezeigt werden sollen.

backgroundColor
(deprecated)

object (Color)

Die Hintergrundfarbe der Zelle. Verworfen: Verwenden Sie stattdessen backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

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

borders

object (Borders)

Die Ränder der Zelle.

padding

object (Padding)

Der 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 Umbruchstrategie für den Wert in der Zelle.

textDirection

enum (TextDirection)

Die Textrichtung in der Zelle.

textFormat

object (TextFormat)

Das Format des Texts in der Zelle, sofern es nicht durch einen Formatierungslauf überschrieben wird. Wenn Sie hier eine Verknüpfung auf Zellenebene festlegen, werden die vorhandenen Verknüpfungen der Zelle gelöscht. Das Link-Feld in einem TextFormatRun hat Vorrang vor der Verknüpfung 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. Dieses Feld muss beim Schreiben festgelegt sein.

pattern

string

Musterstring, der für die Formatierung verwendet wird. Wenn nicht festgelegt, wird bei Bedarf für den angegebenen Typ ein Standardmuster verwendet, das auf der Sprache des Nutzers basiert. Weitere Informationen zu den unterstützten Mustern finden Sie im Leitfaden zu Datums- und Zahlenformaten.

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 diesen Parameter 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 Datums- und Uhrzeitformatierung, z. B. 9/26/08 15:59:00
SCIENTIFIC Formatierung wissenschaftlicher Zahlen, z. B. 1.01E+03

Rahmen

Der Rahmen 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)

Der rechte Rahmen der Zelle.

Rahmen

Ein Rahmen um eine 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. Eingestellt. Die Breite wird durch das Feld "style" bestimmt.

color
(deprecated)

object (Color)

Die Farbe des Rahmens. Verworfen: Verwende colorStyle.

colorStyle

object (ColorStyle)

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

Stil

Der Stil eines Rahmens.

Enums
STYLE_UNSPECIFIED Der Stil ist nicht angegeben. Verwenden Sie diese Option nicht.
DOTTED Der Rahmen ist gepunktet.
DASHED Der Rahmen ist gestrichelt.
SOLID Der Rahmen ist eine dünne durchgezogene Linie.
SOLID_MEDIUM Der Rahmen ist eine durchgehende Linie mittlerer Stärke.
SOLID_THICK Der Rahmen ist eine dicke durchgehende Linie.
NONE Ohne Rahmen. Wird nur beim Aktualisieren eines Rahmens verwendet, um ihn zu löschen.
DOUBLE Die Begrenzung besteht aus zwei durchgezogenen Linien.

Abstand

Der Abstand um die Zelle herum 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

Die vertikale Ausrichtung von Text in einer Zelle.

Enums
VERTICAL_ALIGN_UNSPECIFIED Die vertikale Ausrichtung ist nicht angegeben. Verwenden Sie diese Option nicht.
TOP Der Text ist explizit am oberen Rand der Zelle ausgerichtet.
MIDDLE Der Text ist explizit auf die Mitte der Zelle ausgerichtet.
BOTTOM Der Text ist explizit am unteren Rand der 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 geschrieben, solange diese Zelle leer ist. Wenn die nächste Zelle nicht leer ist, verhält sich das Element genauso wie CLIP. Der Text wird nie 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 Umbruchstrategie in Google Tabellen, bei der Wörter, die länger als eine Zeile sind, abgeschnitten werden, anstatt umgebrochen zu werden. Diese Strategie wird nicht auf allen Plattformen unterstützt und 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 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. Verwenden Sie diese Option nicht.
LEFT_TO_RIGHT Die Textrichtung wurde vom Nutzer auf „von links nach rechts“ festgelegt.
RIGHT_TO_LEFT Die Textrichtung wurde vom Nutzer auf „linksläufig“ festgelegt.

HyperlinkDisplayType

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

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

TextRotation

Die Drehung, die auf 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 darf nur einen der folgenden Werte haben:
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: Bei einer linksläufigen Textrichtung sind positive Winkel gegen den Uhrzeigersinn, bei einer rechtsläufigen Textrichtung im Uhrzeigersinn.

vertical

boolean

Wenn „wahr“ festgelegt ist, wird der Text von oben nach unten gelesen, die Ausrichtung der einzelnen Zeichen bleibt jedoch unverändert. Beispiel: 

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

TextFormatRun

Ein Durchlauf eines Textformats. Das Format dieses Laufs wird bis zum Startindex des nächsten Laufs 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 dieses Laufs. Fehlende Werte übernehmen das Format der Zelle.

DataValidationRule

Eine Regel für die Datenvalidierung.

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 Daten in die Zelle einfügt.

strict

boolean

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

showCustomUi

boolean

„Wahr“, wenn die Benutzeroberfläche je nach Art der Bedingung angepasst werden soll. Wenn „wahr“ festgelegt ist, wird für „Liste“-Bedingungen ein Drop-down-Menü angezeigt.

DataSourceTable

Eine Datenquellentabelle, mit der Nutzer eine statische Datentabelle aus der DataSource in Google Tabellen importieren können. Im Editor von Google Tabellen wird diese Option 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, der die Datenquellentabelle zugeordnet ist.

columnSelectionType

enum (DataSourceTableColumnSelectionType)

Der Typ, mit dem Spalten für die Datenquellentabelle ausgewählt werden. Die Standardeinstellung ist SELECTED.

columns[]

object (DataSourceColumnReference)

Spalten, die für die Datenquellentabelle ausgewählt wurden. Der columnSelectionType muss SELECTED lauten.

filterSpecs[]

object (FilterSpec)

Filtern Sie die Spezifikationen in der Tabelle der Datenquelle.

sortSpecs[]

object (SortSpec)

Sortierungsspezifikationen in der Datenquellentabelle Das Ergebnis der Datenquellentabelle wird anhand der Sortiervorgaben sortiert.

rowLimit

integer

Die maximale Anzahl der zurückzugebenden Zeilen. Wenn keine Angabe erfolgt, wird ein Standardlimit angewendet. Die Standard- und Maximalwerte finden Sie im Editor von Google Tabellen.

dataExecutionStatus

object (DataExecutionStatus)

Nur Ausgabe. Der Status der Datenausführung.

DataSourceTableColumnSelectionType

Die Auswahltypen für Spalten in der Datenquellentabelle.

Enums
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED Der Standardtyp für die Spaltenauswahl. Nicht verwenden.
SELECTED Wählen Sie die Spalten aus, die durch das Feld columns angegeben sind.
SYNC_ALL

Alle aktuellen und zukünftigen Spalten in der Datenquelle synchronisieren

Wenn diese Option festgelegt ist, werden bei der Aktualisierung alle Spalten in der Datenquelle abgerufen.

DataSourceFormula

Eine Datenquellenformel.

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

string

Die ID der Datenquelle, der die Formel zugewiesen ist.

dataExecutionStatus

object (DataExecutionStatus)

Nur Ausgabe. Der Ausführungsstatus der Daten.