Sheets

工作表

电子表格中的工作表。

JSON 表示法 
{
  "properties": {
    object (SheetProperties)
  },
  "data": [
    {
      object (GridData)
    }
  ],
  "merges": [
    {
      object (GridRange)
    }
  ],
  "conditionalFormats": [
    {
      object (ConditionalFormatRule)
    }
  ],
  "filterViews": [
    {
      object (FilterView)
    }
  ],
  "protectedRanges": [
    {
      object (ProtectedRange)
    }
  ],
  "basicFilter": {
    object (BasicFilter)
  },
  "charts": [
    {
      object (EmbeddedChart)
    }
  ],
  "bandedRanges": [
    {
      object (BandedRange)
    }
  ],
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "rowGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "columnGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "slicers": [
    {
      object (Slicer)
    }
  ],
  "tables": [
    {
      object (Table)
    }
  ]
}
字段
properties

object (SheetProperties)

工作表的属性。

data[]

object (GridData)

网格中的数据（如果这是网格工作表）。

返回的 GridData 对象数量取决于相应工作表中请求的范围数量。例如，如果此值为 Sheet1，并且电子表格是使用范围 Sheet1!A1:C10 和 Sheet1!D15:E20 请求的，则第一个 GridData 的 startRow/startColumn 为 0，而第二个 GridData 的 startRow 14 为 15（从零开始的第 16 行），startColumn 3 为 3（从零开始的第 4 列）。

对于 DATA_SOURCE 工作表，您无法请求特定范围，GridData 包含所有值。

merges[]

object (GridRange)

合并在一起的范围。

conditionalFormats[]

object (ConditionalFormatRule)

相应工作表中的条件格式规则。

filterViews[]

object (FilterView)

相应工作表中的过滤视图。

protectedRanges[]

object (ProtectedRange)

此工作表中的受保护范围。

basicFilter

object (BasicFilter)

相应工作表中的过滤条件（如果有）。

charts[]

object (EmbeddedChart)

相应工作表中每个图表的规范。

bandedRanges[]

object (BandedRange)

相应工作表中的条带状（交替颜色）范围。

developerMetadata[]

object (DeveloperMetadata)

与工作表关联的开发者元数据。

rowGroups[]

object (DimensionGroup)

相应工作表上的所有行组，按范围起始索引的升序排列，然后按组深度排列。

columnGroups[]

object (DimensionGroup)

相应工作表上的所有列组，按范围起始索引的升序排序，然后按组深度排序。

slicers[]

object (Slicer)

相应工作表中的切片器。

tables[]

object (Table)

相应工作表中的表格。

SheetProperties

工作表的属性。

JSON 表示法 
{
  "sheetId": integer,
  "title": string,
  "index": integer,
  "sheetType": enum (SheetType),
  "gridProperties": {
    object (GridProperties)
  },
  "hidden": boolean,
  "tabColor": {
    object (Color)
  },
  "tabColorStyle": {
    object (ColorStyle)
  },
  "rightToLeft": boolean,
  "dataSourceSheetProperties": {
    object (DataSourceSheetProperties)
  }
}
字段
sheetId

integer

工作表的 ID。必须为非负数。 此字段一经设置便无法更改。

title

string

工作表的名称。

index

integer

电子表格中工作表的索引。添加或更新工作表属性时，如果排除此字段，则会将工作表添加到工作表列表的末尾或移至工作表列表的末尾。更新工作表索引或插入工作表时，移动操作会考虑“移动前”的索引。例如，如果有三个工作表（S1、S2、S3），要将 S1 移到 S2 前面，必须将索引设置为 2。如果所请求的索引与工作表的当前索引相同，或者所请求的新索引等于当前工作表索引 + 1，则系统会忽略工作表索引更新请求。

sheetType

enum (SheetType)

工作表的类型。默认值为 GRID。此字段一经设置便无法更改。

gridProperties

object (GridProperties)

如果相应工作表是网格，则为该工作表的其他属性。（如果工作表是包含图表或图片的对象工作表，则此字段将不存在。）在写入时，如果对非网格工作表设置任何网格属性，则会出错。

如果相应工作表是 DATA_SOURCE 工作表，则此字段仅输出，但包含反映数据源工作表在界面中的呈现方式的属性，例如 rowCount。

hidden

boolean

如果工作表在界面中处于隐藏状态，则为 true；如果处于显示状态，则为 false。

tabColor
(deprecated)

object (Color)

界面中标签页的颜色。已弃用：请使用 tabColorStyle。

tabColorStyle

object (ColorStyle)

界面中标签页的颜色。如果还设置了 tabColor，则此字段优先。

rightToLeft

boolean

如果工作表是 RTL 工作表而不是 LTR 工作表，则为 True。

dataSourceSheetProperties

object (DataSourceSheetProperties)

仅限输出。如果存在，该字段包含 DATA_SOURCE 工作表特定属性。

SheetType

工作表的类型。

枚举
SHEET_TYPE_UNSPECIFIED 默认值，请勿使用。
GRID 工作表是一个网格。
OBJECT 工作表中没有网格，而是包含图表或图片等对象。
DATA_SOURCE 工作表与外部 DataSource 建立连接，并显示数据预览。

GridProperties

网格的属性。

JSON 表示法 
{
  "rowCount": integer,
  "columnCount": integer,
  "frozenRowCount": integer,
  "frozenColumnCount": integer,
  "hideGridlines": boolean,
  "rowGroupControlAfter": boolean,
  "columnGroupControlAfter": boolean
}
字段
rowCount

integer

网格中的行数。

columnCount

integer

网格中的列数。

frozenRowCount

integer

网格中冻结的行数。

frozenColumnCount

integer

网格中冻结的列数。

hideGridlines

boolean

如果网格未在界面中显示网格线，则为 True。

rowGroupControlAfter

boolean

如果行分组控制切换开关显示在组之后，则为 true。

columnGroupControlAfter

boolean

如果列分组控制切换开关显示在组之后，则为 true。

DataSourceSheetProperties

DATA_SOURCE 表格的其他属性。

JSON 表示法 
{
  "dataSourceId": string,
  "columns": [
    {
      object (DataSourceColumn)
    }
  ],
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
字段
dataSourceId

string

与工作表关联的 DataSource 的 ID。

columns[]

object (DataSourceColumn)

工作表上显示的列，与 RowData 中的值对应。

dataExecutionStatus

object (DataExecutionStatus)

数据执行状态。

GridData

网格中的数据以及有关维度的元数据。

JSON 表示法 
{
  "startRow": integer,
  "startColumn": integer,
  "rowData": [
    {
      object (RowData)
    }
  ],
  "rowMetadata": [
    {
      object (DimensionProperties)
    }
  ],
  "columnMetadata": [
    {
      object (DimensionProperties)
    }
  ]
}
字段
startRow

integer

此 GridData 所指的第一个行（从零开始）。

startColumn

integer

此 GridData 所指的第一个列（从零开始）。

rowData[]

object (RowData)

网格中的数据，每行一个条目，从 startRow 中的行开始。RowData 中的值将对应于从 startColumn 开始的列。

rowMetadata[]

object (DimensionProperties)

网格中请求的行的元数据，从 startRow 中的行开始。

columnMetadata[]

object (DimensionProperties)

网格中有关所请求列的元数据，从 startColumn 中的列开始。

RowData

有关某行中每个单元格的数据。

JSON 表示法 
{
  "values": [
    {
      object (CellData)
    }
  ]
}
字段
values[]

object (CellData)

行中的值，每列一个值。

DimensionProperties

有关维度的属性。

JSON 表示法 
{
  "hiddenByFilter": boolean,
  "hiddenByUser": boolean,
  "pixelSize": integer,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
}
字段
hiddenByFilter

boolean

如果相应维度正在被过滤，则为 True。此字段为只读字段。

hiddenByUser

boolean

如果相应维度被明确隐藏，则为 True。

pixelSize

integer

相应维度的高度（如果是行）或宽度（如果是列），以像素为单位。

developerMetadata[]

object (DeveloperMetadata)

与单行或单列关联的开发者元数据。

dataSourceColumnReference

object (DataSourceColumnReference)

仅限输出。如果设置，则表示数据源工作表中的列。

ConditionalFormatRule

描述条件格式的规则。

JSON 表示法 
{
  "ranges": [
    {
      object (GridRange)
    }
  ],

  // Union field rule can be only one of the following:
  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
  // End of list of possible types for union field rule.
}
字段
ranges[]

object (GridRange)

如果条件为 true，则设置格式的范围。所有范围都必须位于同一网格中。

联合字段 rule。控制相应条件格式的规则，必须设置一个。 rule 只能是下列其中一项：
booleanRule

object (BooleanRule)

格式设置根据规则处于“开启”或“关闭”状态。

gradientRule

object (GradientRule)

格式会因规则中的梯度而异。

BooleanRule

根据条件，可能匹配也可能不匹配的规则。

JSON 表示法 
{
  "condition": {
    object (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}
字段
condition

object (BooleanCondition)

规则的条件。如果条件计算结果为 true，则应用相应格式。

format

object (CellFormat)

要应用的格式。条件格式只能应用部分格式： bold、 italic、 strikethrough、 foreground color 和 background color。

GradientRule

一种规则，用于应用基于所列插值点的渐变色标格式。单元格的格式会因其内容与插值点的值的比较而异。

JSON 表示法 
{
  "minpoint": {
    object (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
字段
minpoint

object (InterpolationPoint)

插值的起始点。

midpoint

object (InterpolationPoint)

可选的中间插值点。

maxpoint

object (InterpolationPoint)

最终插值点。

InterpolationPoint

梯度条件格式中的单个插值点。这些标记会根据所选的颜色、类型和值来固定渐变色标。

JSON 表示法 
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}
字段
color
(deprecated)

object (Color)

相应插值点应使用的颜色。已弃用：请使用 colorStyle。

colorStyle

object (ColorStyle)

相应插值点应使用的颜色。如果还设置了 color，则此字段优先。

type

enum (InterpolationPointType)

应如何解读该值。

value

string

相应插值点所使用的值。可能是公式。如果 type 为 MIN 或 MAX，则未使用。

InterpolationPointType

插值点的类型。

枚举
INTERPOLATION_POINT_TYPE_UNSPECIFIED 默认值，请勿使用。
MIN 插值点使用条件格式范围内的单元格中的最小值。
MAX 插值点使用条件格式范围内的单元格中的最大值。
NUMBER 插值点使用 InterpolationPoint.value 中的确切值。
PERCENT

插值点是条件格式范围内的所有单元格中给定的百分比。如果值为 =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100)))，则这相当于 NUMBER（其中，在扁平化时会忽略范围内的错误）。

PERCENTILE 插值点是条件格式范围内的所有单元格中给定的百分位数。如果值为 =PERCENTILE(FLATTEN(range), value / 100)，则这相当于 NUMBER（其中，在扁平化时会忽略范围内的错误）。

FilterView

过滤视图。如需了解详情，请参阅使用过滤条件管理数据可见性。

JSON 表示法 
{
  "filterViewId": integer,
  "title": string,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
字段
filterViewId

integer

过滤后视图的 ID。

title

string

过滤视图的名称。

range

object (GridRange)

相应过滤视图所涵盖的范围。

在写入时，只能设置 range、namedRangeId 或 tableId 之一。
namedRangeId

string

相应过滤视图所基于的已命名范围（如有）。

在写入时，只能设置 range、namedRangeId 或 tableId 之一。
tableId

string

相应过滤视图所基于的表格（如果有）。

在写入时，只能设置 range、namedRangeId 或 tableId 之一。
sortSpecs[]

object (SortSpec)

每列的排序顺序。如果较早规范中的值相等，则使用较晚规范中的值。

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

用于显示/隐藏每个列的值的条件。该映射的键是列索引，值是相应列的条件。

此字段已弃用，取而代之的是 filterSpecs。

filterSpecs[]

object (FilterSpec)

用于按列显示或隐藏值的过滤条件。

criteria 和 filterSpecs 都会填充在响应中。如果更新请求中同时指定了这两个字段，则此字段的优先级更高。

ProtectedRange

受保护的范围。

JSON 表示法 
{
  "protectedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
字段
protectedRangeId

integer

受保护范围的 ID。此字段为只读字段。

range

object (GridRange)

受保护的范围。范围可能完全不受限，在这种情况下，该工作表会被视为受保护的工作表。

写入时，只能设置 range、namedRangeId 或 tableId 之一。

namedRangeId

string

相应受保护范围所基于的命名范围（如果有）。

写入时，只能设置 range、namedRangeId 或 tableId 之一。

tableId

string

受保护范围所基于的表（如有）。

写入时，只能设置 range、namedRangeId 或 tableId 之一。

description

string

相应受保护范围的说明。

warningOnly

boolean

如果此受保护范围在编辑时会显示警告，则为 True。基于警告的保护是指，每位用户都可以修改受保护范围中的数据，但修改操作会触发警告，要求用户确认修改。

在写入时：如果此字段为 true，则忽略 editors。此外，如果此字段从 true 更改为 false，并且未设置 editors 字段（也未包含在字段掩码中），则编辑器将设置为文档中的所有编辑器。

requestingUserCanEdit

boolean

如果请求此受保护范围的用户可以修改受保护区域，则为 true。此字段为只读字段。

unprotectedRanges[]

object (GridRange)

受保护工作表中的不受保护的范围列表。不受保护的范围仅在受保护的工作表中受支持。

editors

object (Editors)

对受保护范围具有修改权限的用户和群组。此字段仅对拥有受保护范围和文档的编辑权限的用户可见。编辑器不支持 warningOnly 保护。

编辑者

受保护范围的编辑者。

JSON 表示法 
{
  "users": [
    string
  ],
  "groups": [
    string
  ],
  "domainUsersCanEdit": boolean
}
字段
users[]

string

对受保护范围具有修改权限的用户的电子邮件地址。

groups[]

string

对受保护范围具有修改权限的群组的电子邮件地址。

domainUsersCanEdit

boolean

如果文档网域中的任何人都有权修改受保护的范围，则为 True。网域保护仅支持网域内的文档。

BasicFilter

与工作表关联的默认过滤条件。如需了解详情，请参阅使用过滤条件管理数据可见性。

JSON 表示法 
{
  "range": {
    object (GridRange)
  },
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
字段
range

object (GridRange)

过滤条件涵盖的范围。

tableId

string

相应过滤器的支持表（如果有）。写入时，只能设置 range 或 tableId 之一。

sortSpecs[]

object (SortSpec)

每列的排序顺序。如果较早规范中的值相等，则使用较晚规范中的值。

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

用于显示/隐藏每个列的值的条件。该映射的键是列索引，值是相应列的条件。

此字段已弃用，取而代之的是 filterSpecs。

filterSpecs[]

object (FilterSpec)

每列的过滤条件。

criteria 和 filterSpecs 都会填充在响应中。如果更新请求中同时指定了这两个字段，则此字段的优先级更高。

BandedRange

工作表中的带状（交替颜色）范围。

JSON 表示法 
{
  "bandedRangeId": integer,
  "bandedRangeReference": string,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
字段
bandedRangeId

integer

分段范围的 ID。如果未设置，请参阅 bandedRangeReference。

bandedRangeReference

string

仅限输出。带状范围的引用，用于标识 bandedRangeId 不支持的 ID。

range

object (GridRange)

应用这些属性的范围。

rowProperties

object (BandingProperties)

行条带的属性。这些属性会逐行应用于范围内的所有行。必须至少指定 rowProperties 或 columnProperties 中的一个。

columnProperties

object (BandingProperties)

列条带的属性。这些属性会逐列应用于相应范围内的所有列。必须至少指定 rowProperties 或 columnProperties 中的一个。

BandingProperties

引用单个维度（行或列）的属性。如果同时设置了 BandedRange.row_properties 和 BandedRange.column_properties，系统会根据以下规则将填充颜色应用于单元格：

例如，第一行的颜色优先于第一列的颜色，但第一列的颜色优先于第二行的颜色。同样，左上角单元格中的行标题优先于列标题，但如果未设置行标题，则列标题优先于第一行颜色。

JSON 表示法 
{
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
字段
headerColor
(deprecated)

object (Color)

第一行或第一列的颜色。如果设置了此字段，则第一行或第一列会填充此颜色，并且从第二行或第二列开始，颜色会在 firstBandColor 和 secondBandColor 之间交替变化。否则，第一行或第一列会填充 firstBandColor，颜色会像往常一样交替显示。已弃用：请使用 headerColorStyle。

headerColorStyle

object (ColorStyle)

第一行或第一列的颜色。如果设置了此字段，则第一行或第一列会填充此颜色，并且从第二行或第二列开始，颜色会在 firstBandColor 和 secondBandColor 之间交替变化。否则，第一行或第一列会填充 firstBandColor，颜色会像往常一样交替显示。如果还设置了 headerColor，则此字段优先。

firstBandColor
(deprecated)

object (Color)

交替显示的第一种颜色。（必需）已弃用：请改用 firstBandColorStyle。

firstBandColorStyle

object (ColorStyle)

交替显示的第一种颜色。（必需）如果还设置了 firstBandColor，则此字段优先。

secondBandColor
(deprecated)

object (Color)

交替显示的第二种颜色。（必需）已弃用：请改用 secondBandColorStyle。

secondBandColorStyle

object (ColorStyle)

交替显示的第二种颜色。（必需）如果还设置了 secondBandColor，则此字段优先。

footerColor
(deprecated)

object (Color)

最后一行或最后一列的颜色。如果未设置此字段，则根据上一行或上一列的颜色，最后一行或最后一列将填充 firstBandColor 或 secondBandColor。已弃用：请使用 footerColorStyle。

footerColorStyle

object (ColorStyle)

最后一行或最后一列的颜色。如果未设置此字段，则根据上一行或上一列的颜色，最后一行或最后一列将填充 firstBandColor 或 secondBandColor。如果还设置了 footerColor，则此字段优先。

DimensionGroup

工作表中一组行或列，可以包含其他组或包含在其他组中。在工作表中，您可以将群组作为一个整体收起或展开。

JSON 表示法 
{
  "range": {
    object (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
字段
range

object (DimensionRange)

相应群组存在的时间范围。

depth

integer

群组的深度，表示有多少个群组的范围完全包含此群组的范围。

collapsed

boolean

如果相应群组处于收拢状态，则此字段为 true。如果展开较浅深度的重叠组，收起的组仍会保持收起状态。

true 值并不意味着组中的所有维度都处于隐藏状态，因为维度的可见性可以独立于此组属性而发生变化。不过，更新此属性时，如果此字段为 true，则其中的所有维度都会设置为隐藏；如果此字段为 false，则其中的所有维度都会设置为显示。

Slicer

工作表中的切片器。

JSON 表示法 
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}
字段
slicerId

integer

切片的 ID。

spec

object (SlicerSpec)

切片的规范。

position

object (EmbeddedObjectPosition)

切片器的位置。请注意，切片器只能放置在现有工作表中。此外，切片器的宽度和高度可以自动调整，以使其保持在允许的限制范围内。

SlicerSpec

切片器的规范。

JSON 表示法 
{
  "dataRange": {
    object (GridRange)
  },
  "filterCriteria": {
    object (FilterCriteria)
  },
  "columnIndex": integer,
  "applyToPivotTables": boolean,
  "title": string,
  "textFormat": {
    object (TextFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "horizontalAlignment": enum (HorizontalAlign)
}
字段
dataRange

object (GridRange)

切片器的数据范围。

filterCriteria

object (FilterCriteria)

切片器的过滤条件。

columnIndex

integer

应用过滤条件的数据表中的从零开始的列索引。

applyToPivotTables

boolean

如果过滤条件应应用于数据透视表，则为 True。如果未设置，则默认为 True。

title

string

切片器的标题。

textFormat

object (TextFormat)

切片器中标题的文本格式。链接字段不受支持。

backgroundColor
(deprecated)

object (Color)

切片器的背景颜色。已弃用：请使用 backgroundColorStyle。

backgroundColorStyle

object (ColorStyle)

切片器的背景颜色。如果还设置了 backgroundColor，则此字段优先。

horizontalAlignment

enum (HorizontalAlign)

切片器中标题的水平对齐方式。如果未指定，则默认为 LEFT

表格

表格。

JSON 表示法 
{
  "tableId": string,
  "name": string,
  "range": {
    object (GridRange)
  },
  "rowsProperties": {
    object (TableRowsProperties)
  },
  "columnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
字段
tableId

string

表的 ID。

name

string

表名称。在同一电子表格中，此值对于所有表格都是唯一的。

range

object (GridRange)

表格范围。

rowsProperties

object (TableRowsProperties)

表格行的属性。

columnProperties[]

object (TableColumnProperties)

表格列属性。

TableRowsProperties

表格行属性。

JSON 表示法 
{
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
字段
headerColorStyle

object (ColorStyle)

标题行的颜色。如果设置了此字段，则标题行会填充指定的颜色。否则，标题行将填充默认颜色。

firstBandColorStyle

object (ColorStyle)

交替显示的第一种颜色。如果设置了此字段，则第一个条带状行将填充为指定颜色。否则，第一个条带状行的填充颜色为默认颜色。

secondBandColorStyle

object (ColorStyle)

交替显示的第二种颜色。如果设置了此字段，则第二个条带化行将填充指定的颜色。否则，第二个带状行将填充默认颜色。

footerColorStyle

object (ColorStyle)

最后一行的颜色。如果未设置此字段，则不会添加页脚，最后一行将填充 firstBandColorStyle 或 secondBandColorStyle，具体取决于上一行的颜色。如果更新没有页脚的现有表格以添加页脚，则范围将扩大 1 行。如果更新包含页脚的现有表格并移除页脚，范围将缩小 1 行。

TableColumnProperties

表格列。

JSON 表示法 
{
  "columnIndex": integer,
  "columnName": string,
  "columnType": enum (ColumnType),
  "dataValidationRule": {
    object (TableColumnDataValidationRule)
  }
}
字段
columnIndex

integer

从 0 开始的列索引。此索引相对于其在表中的位置，不一定与工作表中的列索引相同。

columnName

string

列名称。

columnType

enum (ColumnType)

列类型。

dataValidationRule

object (TableColumnDataValidationRule)

列数据验证规则。仅针对下拉菜单列类型设置。

ColumnType

表中指定列的列类型。

枚举
COLUMN_TYPE_UNSPECIFIED 未指定的列类型。
DOUBLE 数字列类型。
CURRENCY 币种列类型。
PERCENT 百分比列类型。
DATE 日期列类型。
TIME 时间列类型。
DATE_TIME 日期和时间列类型。
TEXT 文本列类型。
BOOLEAN 布尔值列类型。
DROPDOWN 下拉菜单列类型。
FILES_CHIP 文件条状标签列类型
PEOPLE_CHIP 人员条状标签列类型
FINANCE_CHIP 财经条状标签列类型
PLACE_CHIP 地点条状标签列类型
RATINGS_CHIP 评分条状标签列类型

TableColumnDataValidationRule

表中列的数据验证规则。

JSON 表示法 
{
  "condition": {
    object (BooleanCondition)
  }
}
字段
condition

object (BooleanCondition)

单元格中的数据必须满足的条件。仅当 [BooleanCondition.type] 为 ONE_OF_LIST 时有效。