Cells

CellData

有关特定小区的数据。

JSON 表示法

JSON 表示法
{ "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`) } ] }

{
  "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)
    }
  ]
}

字段
`userEnteredValue`	`object (ExtendedValue)` 用户在单元格中输入的值。例如： `1234`、 `'Hello'` 或 `=NOW()` 注意：日期、时间和日期时间在 `serial number` 中以 double 格式表示。
`effectiveValue`	`object (ExtendedValue)` 相应单元格的有效值。对于包含公式的单元格，这是计算得出的值。对于包含字面值的单元格，此属性与 userEnteredValue 相同。此字段为只读字段。
`formattedValue`	`string` 相应单元格的格式化值。这是向用户显示的值。此字段为只读字段。
`userEnteredFormat`	`object (CellFormat)` 用户为相应单元格输入的格式。写入时，新格式将与现有格式合并。
`effectiveFormat`	`object (CellFormat)` 单元格使用的有效格式。这包括应用任何条件格式的结果，以及单元格包含公式时计算出的数字格式。如果有效格式为默认格式，则不会写入有效格式。此字段为只读字段。
`hyperlink`	`string` 相应单元格指向的超链接（如果有）。如果单元格包含多个超链接，则此字段为空。此字段为只读字段。如需进行设置，请在 `userEnteredValue.formulaValue` 字段中使用 `=HYPERLINK` 公式。您还可以通过 `userEnteredFormat.textFormat` 字段设置单元格级链接。或者，您也可以在跨越整个单元格的 `textFormatRun.format.link` 字段中设置超链接。
`note`	`string` 单元格中的任何注释。
`textFormatRuns[]`	`object (TextFormatRun)` 应用于单元格子部分的富文本运行。运行仅对用户输入的字符串有效，对公式、布尔值或数字无效。运行的属性从文本中的特定索引开始，一直持续到下一个运行。除非明确更改，否则运行会继承相应单元格的属性。写入时，新运行会覆盖任何先前的运行。写入新的 `userEnteredValue` 时，系统会清除之前的跑步记录。
`dataValidation`	`object (DataValidationRule)` 单元格的数据验证规则（如有）。写入时，新的数据验证规则将覆盖任何先前的规则。
`pivotTable`	`object (PivotTable)` 锚定在此单元格中的数据透视表。数据透视表本身的大小是根据其数据、分组、过滤条件、值等动态计算的。数据透视表的左上角单元格仅包含数据透视表定义。其他单元格将包含透视结果的计算值，这些值位于其 `effectiveValue` 字段中。
`dataSourceTable`	`object (DataSourceTable)` 锚定在此单元格的数据源表。数据源表本身的大小会根据其配置动态计算。数据源表格中只有第一个单元格包含数据源表格定义。其他单元格将在其 `effectiveValue` 字段中包含数据源表结果的显示值。
`dataSourceFormula`	`object (DataSourceFormula)` 仅限输出。有关单元格中数据源公式的信息。如果 `userEnteredValue` 是引用某个 `DATA_SOURCE` 工作表的公式，则会设置该字段，例如 `=SUM(DataSheet!Column)`。
`chipRuns[]`	`object (ChipRun)` 可选。应用于单元格子部分的条状标签运行。运行的属性从文本中的特定索引开始，一直持续到下一个运行。在读取时，系统会包含所有使用芯片和未使用芯片的跑步活动。未芯片计时的跑步活动将具有空的 `Chip`。在写作时，仅包含带芯片的跑步活动。包含功能块的运行长度为 1，在用户输入的文本中以“@”占位符符号表示。新运行将覆盖所有先前的运行。写入新的 `userEnteredValue` 会清除之前的运行记录。

CellFormat

单元格的格式。

JSON 表示法

JSON 表示法
{ "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`) } }

{
  "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)
  }
}

字段
`numberFormat`	`object (NumberFormat)` 一种格式，用于描述应如何向用户呈现数值。
`backgroundColor (deprecated)`	`object (Color)` 此项已弃用！单元格的背景颜色。已弃用：请使用 `backgroundColorStyle`。
`backgroundColorStyle`	`object (ColorStyle)` 单元格的背景颜色。如果还设置了 `backgroundColor`，则此字段优先。
`borders`	`object (Borders)` 单元格的边框。
`padding`	`object (Padding)` 单元格的内边距。
`horizontalAlignment`	`enum (HorizontalAlign)` 单元格中值的水平对齐方式。
`verticalAlignment`	`enum (VerticalAlign)` 单元格中值的垂直对齐方式。
`wrapStrategy`	`enum (WrapStrategy)` 单元格中值的换行策略。
`textDirection`	`enum (TextDirection)` 单元格中文字的方向。
`textFormat`	`object (TextFormat)` 单元格中文字的格式（除非被格式运行所替换）。在此处设置单元格级链接会清除单元格的现有链接。在 `TextFormatRun` 中设置链接字段优先于单元格级链接。
`hyperlinkDisplayType`	`enum (HyperlinkDisplayType)` 如果存在，超链接应如何在单元格中显示。
`textRotation`	`object (TextRotation)` 应用于单元格中文字的旋转角度。

NumberFormat

单元格的数字格式。

JSON 表示法
{ "type": enum (`NumberFormatType`), "pattern": string }

字段

字段
`type`	`enum (NumberFormatType)` 数字格式的类型。在写入时，必须设置此字段。
`pattern`	`string` 用于设置格式的模式字符串。如果未设置，系统会根据电子表格的语言区域使用默认格式（如果给定类型需要）。如需详细了解支持的模式，请参阅日期和数字格式指南。

type

enum (NumberFormatType)

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

pattern

string

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

NumberFormatType

相应单元格的数字格式。在此文档中，语言区域假定为 en_US，但实际格式取决于电子表格的语言区域。

枚举
`NUMBER_FORMAT_TYPE_UNSPECIFIED`	未指定数字格式，而是根据单元格的内容确定。请勿明确使用此变量。
`TEXT`	文本格式，例如 `1000.12`
`NUMBER`	数字格式，例如 `1,000.12`
`PERCENT`	百分比格式，例如 `10.12%`
`CURRENCY`	货币格式，例如 `$1,000.12`
`DATE`	日期格式，例如 `9/26/2008`
`TIME`	时间格式，例如 `3:59:00 PM`
`DATE_TIME`	日期+时间格式，例如 `9/26/08 15:59:00`
`SCIENTIFIC`	科学计数数字格式，例如 `1.01E+03`

边框

单元格的边框。

JSON 表示法
{ "top": { object (`Border`) }, "bottom": { object (`Border`) }, "left": { object (`Border`) }, "right": { object (`Border`) } }

字段
`top`	`object (Border)` 单元格的上边框。
`bottom`	`object (Border)` 单元格的下边框。
`left`	`object (Border)` 单元格的左边框。
`right`	`object (Border)` 单元格的右边框。

边框

沿单元格的边框。

JSON 表示法
{ "style": enum (`Style`), "width": integer, "color": { object (`Color`) }, "colorStyle": { object (`ColorStyle`) } }

字段
`style`	`enum (Style)` 边框的样式。
`width (deprecated)`	`integer` 此项已弃用！边框的宽度（以像素为单位）。已弃用；宽度由“style”字段确定。
`color (deprecated)`	`object (Color)` 此项已弃用！边框的颜色。已弃用：请使用 `colorStyle`。
`colorStyle`	`object (ColorStyle)` 边框的颜色。如果还设置了 `color`，则此字段优先。

样式

边框的样式。

枚举
`STYLE_UNSPECIFIED`	未指定样式。请勿使用此属性。
`DOTTED`	边框为虚线。
`DASHED`	边框为虚线。
`SOLID`	边框为细实线。
`SOLID_MEDIUM`	边框为中等粗细的实线。
`SOLID_THICK`	边框为粗实线。
`NONE`	无边框。仅在更新边框以将其擦除时使用。
`DOUBLE`	边框为两条实线。

内边距

单元格周围的内边距量（以像素为单位）。更新内边距时，必须指定每个字段。

JSON 表示法
{ "top": integer, "right": integer, "bottom": integer, "left": integer }

字段
`top`	`integer` 单元格的顶部内边距。
`right`	`integer` 单元格的右内边距。
`bottom`	`integer` 单元格的底部内边距。
`left`	`integer` 单元格的左内边距。

VerticalAlign

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

枚举
`VERTICAL_ALIGN_UNSPECIFIED`	未指定垂直对齐方式。请勿使用此属性。
`TOP`	文本明确与单元格顶部对齐。
`MIDDLE`	文本明确与单元格的中间对齐。
`BOTTOM`	文本明确对齐到单元格底部。

WrapStrategy

如何使单元格中的文本换行。

枚举
`WRAP_STRATEGY_UNSPECIFIED`	默认值，请勿使用。
`OVERFLOW_CELL`	如果某行的长度超过了单元格宽度，系统会将该行写入下一个单元格（前提是该单元格为空）。如果下一个单元格不为空，则此函数的行为与 `CLIP` 相同。除非用户手动插入新行，否则文本永远不会换行。示例： `\| First sentence. \| \| Manual newline that is very long. <- Text continues into next cell \| Next newline. \|`
`LEGACY_WRAP`	此换行策略表示旧版 Google 表格换行策略，其中长于一行的字词会被剪裁，而不是换行。此策略并非所有平台都支持，并且正在逐步淘汰。示例： `\| Cell has a \| \| loooooooooo\| <- Word is clipped. \| word. \|`
`CLIP`	如果某行的长度超过了单元格宽度，则会被剪裁。除非用户手动插入新行，否则文本永远不会换行。示例： `\| First sentence. \| \| Manual newline t\| <- Text is clipped \| Next newline. \|`
`WRAP`	如果某个字词的长度超过一行，系统会将其换行显示，而不是截断。示例： `\| Cell has a \| \| loooooooooo\| <- Word is broken. \| ong word. \|`

TextDirection

单元格中文字的方向。

枚举
`TEXT_DIRECTION_UNSPECIFIED`	未指定文字方向。请勿使用此属性。
`LEFT_TO_RIGHT`	用户设置了从左至右的文字方向。
`RIGHT_TO_LEFT`	用户已将文本方向设置为从右至左。

HyperlinkDisplayType

是否显式呈现超链接。如果未指定，则超链接处于链接状态。

枚举
`HYPERLINK_DISPLAY_TYPE_UNSPECIFIED`	默认值：呈现超链接。请勿使用此属性。
`LINKED`	应明确呈现超链接。
`PLAIN_TEXT`	不应呈现超链接。

TextRotation

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

JSON 表示法
{ // Union field `type` can be only one of the following: "angle": integer, "vertical": boolean // End of list of possible types for union field `type`. }

字段

字段
联合字段 `type`。旋转类型，垂直或倾斜。 `type` 只能是下列其中一项：
`angle`	`integer` 标准方向与所需方向之间的角度。以度为单位。有效值介于 -90 和 90 之间。正角度表示向上倾斜，负角度表示向下倾斜。注意：对于 LTR 文本方向，正角度为逆时针方向；对于 RTL 文本方向，正角度为顺时针方向
`vertical`	`boolean` 如果为 true，则文本从上到下读取，但各个字符的方向保持不变。例如： `\| V \| \| e \| \| r \| \| t \| \| i \| \| c \| \| a \| \| l \|`

联合字段 type。旋转类型，垂直或倾斜。 type 只能是下列其中一项：

angle

integer

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

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

vertical

boolean

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

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

TextFormatRun

文本格式的运行。相应运行的格式会一直持续到下一次运行的起始索引。更新时，必须设置所有字段。

JSON 表示法
{ "startIndex": integer, "format": { object (`TextFormat`) } }

字段

字段
`startIndex`	`integer` 相应运行开始位置的从零开始的字符索引，以 UTF-16 代码单元表示。
`format`	`object (TextFormat)` 相应跑步活动的格式。缺省值会沿用相应单元格的格式。

startIndex

integer

相应运行开始位置的从零开始的字符索引，以 UTF-16 代码单元表示。

format

object (TextFormat)

相应跑步活动的格式。缺省值会沿用相应单元格的格式。

DataValidationRule

数据验证规则。

JSON 表示法
{ "condition": { object (`BooleanCondition`) }, "inputMessage": string, "strict": boolean, "showCustomUi": boolean }

字段
`condition`	`object (BooleanCondition)` 单元格中的数据必须满足的条件。
`inputMessage`	`string` 在向单元格添加数据时向用户显示的消息。
`strict`	`boolean` 如果应拒绝无效数据，则为 True。
`showCustomUi`	`boolean` 如果应根据条件类型自定义界面，则为 True。如果为 true，“列表”条件将显示一个下拉菜单。

DataSourceTable

一种数据源表，允许用户将 DataSource 中的静态数据表导入 Google 表格。在 Google 表格编辑器中，此功能也称为“提取”。

JSON 表示法

JSON 表示法
{ "dataSourceId": string, "columnSelectionType": enum (`DataSourceTableColumnSelectionType`), "columns": [ { object (`DataSourceColumnReference`) } ], "filterSpecs": [ { object (`FilterSpec`) } ], "sortSpecs": [ { object (`SortSpec`) } ], "rowLimit": integer, "dataExecutionStatus": { object (`DataExecutionStatus`) } }

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

字段
`dataSourceId`	`string` 数据源表所关联的数据源的 ID。
`columnSelectionType`	`enum (DataSourceTableColumnSelectionType)` 用于为数据源表选择列的类型。默认值为 `SELECTED`。
`columns[]`	`object (DataSourceColumnReference)` 为数据源表选择的列。`columnSelectionType` 必须是 `SELECTED`。
`filterSpecs[]`	`object (FilterSpec)` 数据源表中的过滤条件规范。
`sortSpecs[]`	`object (SortSpec)` 数据源表中的排序规范。数据源表的结果会根据排序规范按顺序排序。
`rowLimit`	`integer` 要返回的行数上限。如果未设置，系统会应用默认限制。请参阅 Google 表格编辑器，了解默认限制和最大限制。
`dataExecutionStatus`	`object (DataExecutionStatus)` 仅限输出。数据执行状态。

DataSourceTableColumnSelectionType

数据源表列选择类型。

枚举

DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED 默认列选择类型，请勿使用。

SELECTED 选择由 columns 字段指定的列。

枚举
`DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED`	默认列选择类型，请勿使用。
`SELECTED`	选择由 `columns` 字段指定的列。
`SYNC_ALL`	同步数据源中的所有现有列和日后增加的列。如果设置，数据源表会在刷新时提取数据源中的所有列。

SYNC_ALL

同步数据源中的所有现有列和日后增加的列。

如果设置，数据源表会在刷新时提取数据源中的所有列。

DataSourceFormula

数据源公式。

JSON 表示法
{ "dataSourceId": string, "dataExecutionStatus": { object (`DataExecutionStatus`) } }

字段

字段
`dataSourceId`	`string` 公式所关联的数据源的 ID。
`dataExecutionStatus`	`object (DataExecutionStatus)` 仅限输出。数据执行状态。

dataSourceId

string

公式所关联的数据源的 ID。

dataExecutionStatus

object (DataExecutionStatus)

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

ChipRun

芯片的运行。该 chip 会一直持续到下一次运行的开始索引。

JSON 表示法
{ "startIndex": integer, "chip": { object (`Chip`) } }

字段

字段
`startIndex`	`integer` 必需。相应运行开始位置的从零开始的字符索引，以 UTF-16 代码单元表示。
`chip`	`object (Chip)` 可选。相应跑步活动的条状标签。

startIndex

integer

必需。相应运行开始位置的从零开始的字符索引，以 UTF-16 代码单元表示。

chip

object (Chip)

可选。相应跑步活动的条状标签。

条状标签

智能条状标签。

JSON 表示法

JSON 表示法
{ // 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`. }

{

  // 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.
}

字段

字段
联合字段 `properties`。功能块的属性。 `properties` 只能是下列其中一项：
`personProperties`	`object (PersonProperties)` 关联人员的属性。
`richLinkProperties`	`object (RichLinkProperties)` 富链接的属性。

联合字段 properties。功能块的属性。 properties 只能是下列其中一项：

personProperties

object (PersonProperties)

关联人员的属性。

richLinkProperties

object (RichLinkProperties)

富链接的属性。

PersonProperties

与关联人员相关的属性。

JSON 表示法
{ "email": string, "displayFormat": enum (`DisplayFormat`) }

字段

字段
`email`	`string` 必需。与此人相关联的电子邮件地址。此字段始终存在。
`displayFormat`	`enum (DisplayFormat)` 可选。人员 chip 的显示格式。如果未设置，则使用默认显示格式。

email

string

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

displayFormat

enum (DisplayFormat)

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

DisplayFormat

首选显示格式（如有）。

枚举
`DISPLAY_FORMAT_UNSPECIFIED`	默认值，请勿使用。
`DEFAULT`	默认显示格式。
`LAST_NAME_COMMA_FIRST_NAME`	姓氏、名字显示格式。
`EMAIL`	电子邮件显示格式。

RichLinkProperties

指向 Google 资源（例如云端硬盘中的文件、YouTube 视频、Google 地图地址或日历活动）的链接的属性。只有云端硬盘文件可以作为功能块写入。所有其他富链接类型均为只读。

写入时，URI 不得超过 2000 字节。

注意：写入云端硬盘文件 chip 需要至少一个 drive.file、drive.readonly 或 drive OAuth 范围。

JSON 表示法
{ "uri": string, "mimeType": string }

字段

字段
`uri`	`string` 必需。链接的 URI。始终存在。
`mimeType`	`string` 仅限输出。链接的 MIME 类型（如果有）（例如，当链接是 Google 云端硬盘中的文件时）。

uri

string

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

mimeType

string

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

Cells 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

CellData

CellFormat

NumberFormat

NumberFormatType

边框

边框

样式

内边距

VerticalAlign

WrapStrategy

TextDirection

HyperlinkDisplayType

TextRotation

TextFormatRun

DataValidationRule

DataSourceTable

DataSourceTableColumnSelectionType

DataSourceFormula

ChipRun

条状标签

PersonProperties

DisplayFormat

RichLinkProperties

Cells