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)
  },
  "chipRuns": [
    {
      object (ChipRun)
    }
  ]
}
Felder
userEnteredValue

object (ExtendedValue)

Der Wert, den der Nutzer in die Zelle eingegeben hat, z. B.: 1234, 'Hello' oder =NOW() Hinweis: Datums-, Uhrzeit- und DateTime-Werte werden in serial number als Gleitkommazahlen dargestellt.

effectiveValue

object (ExtendedValue)

Der effektive Wert der Zelle. Bei Zellen mit Formeln ist dies der berechnete Wert. Bei Zellen mit Literalen ist dies dasselbe wie „userEnteredValue“. 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, falls 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

Eine beliebige Anmerkung zur Zelle.

textFormatRuns[]

object (TextFormatRun)

Läufe von Rich-Text, die auf Unterabschnitte der Zelle angewendet werden. Läufe sind nur für vom Nutzer eingegebene Strings gültig, nicht für Formeln, boolesche Werte oder Zahlen. Die Eigenschaften eines Laufs beginnen an einem bestimmten Index im Text und werden bis zum nächsten Lauf fortgesetzt. Läufe übernehmen die Eigenschaften der Zelle, sofern sie nicht explizit geändert werden.

Beim Schreiben werden alle vorherigen Läufe überschrieben. Wenn Sie einen neuen userEnteredValue schreiben, werden vorherige Ausführungen gelöscht.

dataValidation

object (DataValidationRule)

Eine Datenvalidierungsregel für die Zelle, falls vorhanden.

Beim Schreiben wird jede vorherige Regel durch die neue Regel zur Datenvalidierung überschrieben.

pivotTable

object (PivotTable)

Eine Pivot-Tabelle, die in dieser Zelle verankert ist. Die Größe der Pivot-Tabelle selbst wird dynamisch auf Grundlage der Daten, Gruppierung, Filter, Werte usw. berechnet. Nur die Zelle oben links in der Pivot-Tabelle enthält die Definition der Pivot-Tabelle. Die anderen Zellen enthalten die berechneten Werte der Pivot-Ergebnisse 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 des Ergebnisses der Datenquellentabelle in ihren effectiveValue-Feldern.

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).

chipRuns[]

object (ChipRun)

Optional. Ausführungen von Chips, die auf Unterabschnitte der Zelle angewendet werden. Die Eigenschaften eines Laufs beginnen an einem bestimmten Index im Text und werden bis zum nächsten Lauf fortgesetzt.

Beim Lesen werden alle Läufe mit und ohne Chip berücksichtigt. Bei Läufen ohne Chip ist Chip leer.

Beim Schreiben werden nur Läufe mit Chips berücksichtigt. Läufe mit Chips haben die Länge 1 und werden im vom Nutzer eingegebenen Text durch das Platzhaltersymbol „@“ dargestellt. Neue Ausführungen überschreiben alle vorherigen Ausführungen. Wenn Sie einen neuen userEnteredValue schreiben, werden vorherige Läufe gelöscht.

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 präsentiert werden sollen.

backgroundColor
(deprecated)

object (Color)

Die Hintergrundfarbe der Zelle. Verworfen: Verwenden Sie backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

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

borders

object (Borders)

Die Rahmen der Zelle.

padding

object (Padding)

Der Innenabstand 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 Richtung des Texts in der Zelle.

textFormat

object (TextFormat)

Das Format des Texts in der Zelle, sofern es nicht durch einen Formatierungslauf überschrieben wird. Wenn Sie hier einen Link auf Zellebene festlegen, werden die vorhandenen Links der Zelle gelöscht. Wenn Sie das Linkfeld in einem TextFormatRun festlegen, hat das Vorrang vor dem Link auf Zellebene.

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

Musterstring für die Formatierung. Wenn kein Muster festgelegt ist, wird bei Bedarf ein Standardmuster basierend auf dem Gebietsschema der Tabelle verwendet. Weitere Informationen zu den unterstützten Mustern finden Sie im Leitfaden zu Datums- und Zahlenformaten.

NumberFormatType

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 Prozentformatierung, 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 Rahmen der Zelle.

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

object (Border)

Die obere Rahmenlinie der Zelle.

bottom

object (Border)

Die untere Rahmenlinie der Zelle.

left

object (Border)

Der linke Rand der Zelle.

right

object (Border)

Die rechte Rahmenlinie 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. Veraltet. Die Breite wird durch das Feld „style“ bestimmt.

color
(deprecated)

object (Color)

Die Farbe des Rahmens. Verworfen: Verwenden Sie 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. Nicht verwenden.
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 durchgezogene Linie.
NONE Kein Rahmen. Wird nur verwendet, wenn ein Rahmen aktualisiert wird, um ihn zu löschen.
DOUBLE Der Rahmen besteht aus zwei durchgezogenen Linien.

Abstand

Die Größe des Abstands um die Zelle in Pixeln. Beim Aktualisieren des Abstands muss jedes Feld angegeben werden.

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

integer

Der obere Innenabstand der Zelle.

right

integer

Der rechte Innenabstand der Zelle.

bottom

integer

Der untere Abstand der Zelle.

left

integer

Das linke Padding der Zelle.

VerticalAlign

Die vertikale Ausrichtung von Text in einer Zelle.

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

WrapStrategy

So brechen Sie Text in einer Zelle um.

Enums
WRAP_STRATEGY_UNSPECIFIED Der Standardwert, nicht verwenden.
OVERFLOW_CELL

Zeilen, die länger als die Zellbreite sind, werden in die nächste Zelle geschrieben, sofern diese leer ist. Wenn die nächste Zelle nicht leer ist, verhält sich die Funktion wie 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 Umbruchstrategie entspricht der alten Google Tabellen-Umbruchstrategie, bei der Wörter, die länger als eine Zeile sind, abgeschnitten und nicht umgebrochen werden. 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 umgebrochen und nicht abgeschnitten. Beispiel: 

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

TextDirection

Die Richtung des Texts in einer Zelle.

Enums
TEXT_DIRECTION_UNSPECIFIED Die Textrichtung ist nicht angegeben. Nicht verwenden.
LEFT_TO_RIGHT Die Textrichtung „rechtsläufig“ wurde vom Nutzer festgelegt.
RIGHT_TO_LEFT Die Textrichtung „Linksläufig“ wurde vom Nutzer festgelegt.

HyperlinkDisplayType

Gibt an, ob ein Hyperlink explizit gerendert werden soll. Wenn nicht angegeben, 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 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. Der Rotationstyp: vertikal oder geneigt. Für type ist nur einer der folgenden Werte zulässig:
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 nach unten.

Hinweis: Bei der Textrichtung „Links nach rechts“ werden positive Winkel gegen den Uhrzeigersinn gemessen, bei „Rechts nach links“ im Uhrzeigersinn.

vertical

boolean

Bei „true“ 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 Lauf 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 dieser Lauf 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 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. Bei „true“ wird für „Liste“-Bedingungen ein Drop-down-Menü angezeigt.

DataSourceTable

Eine Datenquellentabelle, mit der der Nutzer eine statische Datentabelle aus DataSource in Google Sheets importieren kann. Im Sheets-Editor wird diese Funktion 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 zum Auswählen von Spalten für die Datenquellentabelle. Die Standardeinstellung ist SELECTED.

columns[]

object (DataSourceColumnReference)

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

filterSpecs[]

object (FilterSpec)

Spezifikationen in der Datenquellentabelle filtern

sortSpecs[]

object (SortSpec)

Sortieren Sie die Spezifikationen in der Datenquellentabelle. Das Ergebnis der Datenquellentabelle wird anhand der Sortierspezifikationen sortiert.

rowLimit

integer

Die maximale Anzahl der zurückzugebenden Zeilen. Wenn kein Limit festgelegt ist, wird ein Standardlimit angewendet. Das Standard- und das maximale Limit finden Sie im Sheets-Editor.

dataExecutionStatus

object (DataExecutionStatus)

Nur Ausgabe. Der Status der Datenausführung.

DataSourceTableColumnSelectionType

Die Auswahltypen für Datenquellen-Tabellenspalten.

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 werden.
SYNC_ALL

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

Wenn diese Option festgelegt ist, werden beim Aktualisieren alle Spalten in der Datenquelle abgerufen.

DataSourceFormula

Eine Datenquellenformel.

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.

ChipRun

Der Lauf eines Chips. Der Chip wird bis zum Startindex des nächsten Laufs fortgesetzt.

JSON-Darstellung 
{
  "startIndex": integer,
  "chip": {
    object (Chip)
  }
}
Felder
startIndex

integer

Erforderlich. Der nullbasierte Zeichenindex, an dem dieser Lauf beginnt, in UTF-16-Codeeinheiten.

chip

object (Chip)

Optional. Der Chip dieses Laufs.

Chip

Der Smartchip.

JSON-Darstellung 
{

  // Union field properties can be only one of the following:
  "personProperties": {
    object (PersonProperties)
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
  // End of list of possible types for union field properties.
}
Felder
Union-Feld properties. Die Eigenschaften des Chips. Für properties ist nur einer der folgenden Werte zulässig:
personProperties

object (PersonProperties)

Eigenschaften einer verknüpften Person.

PersonProperties

Eigenschaften, die für eine verknüpfte Person spezifisch sind.

JSON-Darstellung 
{
  "email": string,
  "displayFormat": enum (DisplayFormat)
}
Felder
email

string

Erforderlich. Die mit dieser Person verknüpfte E-Mail-Adresse. Dieses Feld ist immer vorhanden.

displayFormat

enum (DisplayFormat)

Optional. Das Anzeigeformat des Personen-Chips. Wenn nicht festgelegt, wird das Standardanzeigeformat verwendet.

DisplayFormat

Bevorzugtes Anzeigeformat, sofern verfügbar.

Enums
DISPLAY_FORMAT_UNSPECIFIED Standardwert, nicht verwenden.
DEFAULT Standardanzeigeformat.
LAST_NAME_COMMA_FIRST_NAME Anzeigeformat für Nachname und Vorname.
EMAIL Anzeigeformat für E‑Mails.

RichLinkProperties

Eigenschaften eines Links zu einer Google-Ressource, z. B. einer Datei in Drive, einem YouTube-Video, einer Maps-Adresse oder einem Kalendertermin. Nur Drive-Dateien können als Chips geschrieben werden. Alle anderen Rich-Link-Typen sind schreibgeschützt.

URIs dürfen beim Schreiben nicht länger als 2.000 Byte sein.

HINWEIS: Zum Schreiben von Drive-Datei-Chips ist mindestens einer der folgenden OAuth-Bereiche erforderlich: drive.file, drive.readonly oder drive.

JSON-Darstellung 
{
  "uri": string,
  "mimeType": string
}
Felder
uri

string

Erforderlich. Der URI des Links. Diese ist immer vorhanden.

mimeType

string

Nur Ausgabe. Der MIME-Typ des Links, falls vorhanden (z. B. wenn es sich um eine Datei in Drive handelt).