Cells

object (ExtendedValue)

用户在单元格中输入的值。例如： 1234、'Hello' 或 =NOW() 注意：日期、时间和日期时间以 serial number 格式的双精度数表示。

object (ExtendedValue)

单元格的有效值。对于包含公式的单元格，此值为计算值。对于包含字面量的单元格，此值与 userEnteredValue 相同。此字段为只读字段。

string

单元格的格式化值。这是向用户显示的值。此字段为只读字段。

object (CellFormat)

用户为单元格输入的格式。

写入时，新格式将与现有格式合并。

object (CellFormat)

单元格使用的有效格式。这包括应用任何条件格式后的结果，以及（如果单元格包含公式）计算得出的数字格式。如果有效格式为默认格式，则不会写入有效格式。此字段为只读字段。

string

此单元格指向的超链接（如果有）。如果单元格包含多个超链接，则此字段将为空。此字段为只读字段。如需进行设置，请在 userEnteredValue.formulaValue 字段中使用 =HYPERLINK 公式。您还可以通过 userEnteredFormat.textFormat 字段设置单元格级链接。或者，在 textFormatRun.format.link 字段中设置一个超链接，使其跨越整个单元格。

string

单元格中的任何备注。

object (TextFormatRun)

应用于单元格子部分的富文本段落。运行作业仅适用于用户输入的字符串，而不适用于公式、布尔值或数字。运行的属性从文本中的特定索引开始，并持续到下一次运行。除非明确更改，否则运行作业将继承单元格的属性。

写入时，新运行作业将覆盖之前的所有运行作业。写入新的 userEnteredValue 时，系统会清除之前的运行记录。

object (DataValidationRule)

单元格上的数据验证规则（如果有）。

在写入时，新的数据验证规则会覆盖任何先前的规则。

object (PivotTable)

此单元格中锚定的透视表。数据透视表本身的大小是根据其数据、分组、过滤条件、值等进行动态计算的。只有数据透视表的左上角单元格包含数据透视表定义。其他单元格的 effectiveValue 字段将包含数据透视结果的计算值。

object (DataSourceTable)

锚定在此单元格的数据源表。数据源表本身的大小会根据其配置动态计算。只有数据源表的第一个单元格包含数据源表定义。其他单元格将在其 effectiveValue 字段中包含数据源表结果的显示值。

object (DataSourceFormula)

仅限输出。关于单元格中数据源公式的信息。如果 userEnteredValue 是引用某个 DATA_SOURCE 工作表（例如 =SUM(DataSheet!Column)）的公式，则系统会设置该字段。

object (ChipRun)

可选。应用于单元格子部分的条状标签序列。运行的属性从文本中的特定索引开始，并持续到下一次运行。

读取时，系统会包含所有带条状标签和不带条状标签的运行。未嵌入条状标签的运行作业将具有空的 Chip。

写入时，仅包含包含条状标签的运行。包含条状标签的运行长度为 1，在用户输入的文本中用“@”占位符符号表示。新的运行作业将覆盖之前的所有运行作业。写入新的 userEnteredValue 会清除之前的运行记录。

object (NumberFormat)

一种格式，用于说明应如何向用户呈现数字值。

object (Color)

单元格的背景颜色。已废弃：请使用 backgroundColorStyle。

object (ColorStyle)

单元格的背景颜色。如果同时设置了 backgroundColor，则此字段优先。

object (Borders)

单元格的边框。

object (Padding)

单元格的内边距。

enum (HorizontalAlign)

单元格中值的水平对齐方式。

enum (VerticalAlign)

单元格中值的垂直对齐方式。

enum (WrapStrategy)

单元格中值的换行策略。

enum (TextDirection)

单元格中文本的方向。

object (TextFormat)

单元格中文本的格式（除非被运行的格式替换）。在此处设置单元格级链接会清除单元格的现有链接。在 TextFormatRun 中设置链接字段优先于单元格级链接。

enum (HyperlinkDisplayType)

超链接在单元格中的显示方式（如果有）。

object (TextRotation)

应用于单元格中文本的旋转角度。

enum (NumberFormatType)

数字格式的类型。写入时，必须设置此字段。

string

用于设置格式的模式字符串。如果未设置，系统会根据用户的语言区域使用默认模式（如果给定类型需要）。如需详细了解支持的模式，请参阅日期和数字格式指南。

object (Border)

单元格的上边框。

object (Border)

单元格的底边框。

object (Border)

单元格的左边框。

object (Border)

单元格的右边框。

enum (Style)

边框的样式。

integer

边框的宽度（以像素为单位）。已废弃；宽度由“style”字段决定。

object (Color)

边框的颜色。已废弃：请使用 colorStyle。

object (ColorStyle)

边框的颜色。如果同时设置了 color，则此字段优先。

integer

单元格的上内边距。

integer

单元格的右内边距。

integer

单元格的底部内边距。

integer

单元格的左内边距。

integer

标准屏幕方向与所需屏幕方向之间的角度。以度为单位。有效值介于 -90 到 90 之间。正角度是向上倾斜，负角度是向下倾斜。

注意：对于 LTR 文本方向，正角度为逆时针方向，而对于 RTL 文本方向，正角度为顺时针方向

boolean

如果为 true，文本会从上到下阅读，但各个字符的方向保持不变。例如：

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

integer

此运行开始的字符索引（从零开始），以 UTF-16 代码单元为单位。

object (TextFormat)

此次运行的格式。缺失的值会继承单元格的格式。

object (BooleanCondition)

单元格中的数据必须符合的条件。

string

向用户显示的消息，用于在向单元格添加数据时显示。

boolean

如果应拒绝无效数据，则为 true。

boolean

如果应根据条件类型自定义界面，则为 true。如果为 true，则“列表”条件将显示下拉菜单。

string

数据源表关联的数据源的 ID。

enum (DataSourceTableColumnSelectionType)

用于为数据源表选择列的类型。默认值为 SELECTED。

object (DataSourceColumnReference)

为数据源表选择的列。columnSelectionType 必须为 SELECTED。

object (FilterSpec)

数据源表中的过滤条件规范。

object (SortSpec)

数据源表中的排序规范。数据源表的结果会按排序规范有序排列。

integer

要返回的行数上限。如果未设置，系统会应用默认限制。如需了解默认值和上限，请参阅 Google 表格编辑器。

object (DataExecutionStatus)

仅限输出。数据执行状态。

string

公式关联的数据源的 ID。

object (DataExecutionStatus)

仅限输出。数据执行状态。

integer

必需。此运行开始的字符索引（从零开始），以 UTF-16 代码单元为单位。

object (Chip)

可选。此运行的条状标签。

object (PersonProperties)

关联的人员的属性。

object (RichLinkProperties)

富媒体链接的属性。

string

必需。与此人关联的电子邮件地址。此字段始终存在。

enum (DisplayFormat)

可选。人员条状标签的显示格式。如果未设置，则使用默认显示格式。

string

必需。链接的 URI。始终存在。

string

仅限输出。链接的 MIME 类型（如果有，例如当链接是云端硬盘中的文件时）。