Requests

{

  // Union field kind can be only one of the following:
  "updateSpreadsheetProperties": {
    object (UpdateSpreadsheetPropertiesRequest)
  },
  "updateSheetProperties": {
    object (UpdateSheetPropertiesRequest)
  },
  "updateDimensionProperties": {
    object (UpdateDimensionPropertiesRequest)
  },
  "updateNamedRange": {
    object (UpdateNamedRangeRequest)
  },
  "repeatCell": {
    object (RepeatCellRequest)
  },
  "addNamedRange": {
    object (AddNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "addSheet": {
    object (AddSheetRequest)
  },
  "deleteSheet": {
    object (DeleteSheetRequest)
  },
  "autoFill": {
    object (AutoFillRequest)
  },
  "cutPaste": {
    object (CutPasteRequest)
  },
  "copyPaste": {
    object (CopyPasteRequest)
  },
  "mergeCells": {
    object (MergeCellsRequest)
  },
  "unmergeCells": {
    object (UnmergeCellsRequest)
  },
  "updateBorders": {
    object (UpdateBordersRequest)
  },
  "updateCells": {
    object (UpdateCellsRequest)
  },
  "addFilterView": {
    object (AddFilterViewRequest)
  },
  "appendCells": {
    object (AppendCellsRequest)
  },
  "clearBasicFilter": {
    object (ClearBasicFilterRequest)
  },
  "deleteDimension": {
    object (DeleteDimensionRequest)
  },
  "deleteEmbeddedObject": {
    object (DeleteEmbeddedObjectRequest)
  },
  "deleteFilterView": {
    object (DeleteFilterViewRequest)
  },
  "duplicateFilterView": {
    object (DuplicateFilterViewRequest)
  },
  "duplicateSheet": {
    object (DuplicateSheetRequest)
  },
  "findReplace": {
    object (FindReplaceRequest)
  },
  "insertDimension": {
    object (InsertDimensionRequest)
  },
  "insertRange": {
    object (InsertRangeRequest)
  },
  "moveDimension": {
    object (MoveDimensionRequest)
  },
  "updateEmbeddedObjectPosition": {
    object (UpdateEmbeddedObjectPositionRequest)
  },
  "pasteData": {
    object (PasteDataRequest)
  },
  "textToColumns": {
    object (TextToColumnsRequest)
  },
  "updateFilterView": {
    object (UpdateFilterViewRequest)
  },
  "deleteRange": {
    object (DeleteRangeRequest)
  },
  "appendDimension": {
    object (AppendDimensionRequest)
  },
  "addConditionalFormatRule": {
    object (AddConditionalFormatRuleRequest)
  },
  "updateConditionalFormatRule": {
    object (UpdateConditionalFormatRuleRequest)
  },
  "deleteConditionalFormatRule": {
    object (DeleteConditionalFormatRuleRequest)
  },
  "sortRange": {
    object (SortRangeRequest)
  },
  "setDataValidation": {
    object (SetDataValidationRequest)
  },
  "setBasicFilter": {
    object (SetBasicFilterRequest)
  },
  "addProtectedRange": {
    object (AddProtectedRangeRequest)
  },
  "updateProtectedRange": {
    object (UpdateProtectedRangeRequest)
  },
  "deleteProtectedRange": {
    object (DeleteProtectedRangeRequest)
  },
  "autoResizeDimensions": {
    object (AutoResizeDimensionsRequest)
  },
  "addChart": {
    object (AddChartRequest)
  },
  "updateChartSpec": {
    object (UpdateChartSpecRequest)
  },
  "updateBanding": {
    object (UpdateBandingRequest)
  },
  "addBanding": {
    object (AddBandingRequest)
  },
  "deleteBanding": {
    object (DeleteBandingRequest)
  },
  "createDeveloperMetadata": {
    object (CreateDeveloperMetadataRequest)
  },
  "updateDeveloperMetadata": {
    object (UpdateDeveloperMetadataRequest)
  },
  "deleteDeveloperMetadata": {
    object (DeleteDeveloperMetadataRequest)
  },
  "randomizeRange": {
    object (RandomizeRangeRequest)
  },
  "addDimensionGroup": {
    object (AddDimensionGroupRequest)
  },
  "deleteDimensionGroup": {
    object (DeleteDimensionGroupRequest)
  },
  "updateDimensionGroup": {
    object (UpdateDimensionGroupRequest)
  },
  "trimWhitespace": {
    object (TrimWhitespaceRequest)
  },
  "deleteDuplicates": {
    object (DeleteDuplicatesRequest)
  },
  "updateEmbeddedObjectBorder": {
    object (UpdateEmbeddedObjectBorderRequest)
  },
  "addSlicer": {
    object (AddSlicerRequest)
  },
  "updateSlicerSpec": {
    object (UpdateSlicerSpecRequest)
  },
  "addDataSource": {
    object (AddDataSourceRequest)
  },
  "updateDataSource": {
    object (UpdateDataSourceRequest)
  },
  "deleteDataSource": {
    object (DeleteDataSourceRequest)
  },
  "refreshDataSource": {
    object (RefreshDataSourceRequest)
  },
  "cancelDataSourceRefresh": {
    object (CancelDataSourceRefreshRequest)
  }
  // End of list of possible types for union field kind.
}

object (UpdateSpreadsheetPropertiesRequest)

更新电子表格的属性。

object (UpdateSheetPropertiesRequest)

更新工作表的属性。

object (UpdateDimensionPropertiesRequest)

更新维度的属性。

object (UpdateNamedRangeRequest)

更新命名的范围。

object (RepeatCellRequest)

跨范围重复单个单元格。

object (AddNamedRangeRequest)

添加命名的范围。

object (DeleteNamedRangeRequest)

删除命名的范围。

object (AddSheetRequest)

添加工作表。

object (DeleteSheetRequest)

删除工作表。

object (AutoFillRequest)

根据现有数据自动填充更多数据。

object (CutPasteRequest)

从一个区域剪切数据，然后将其粘贴到另一个区域。

object (CopyPasteRequest)

从一个区域复制数据，并将其粘贴到另一个区域。

object (MergeCellsRequest)

将单元格合并在一起。

object (UnmergeCellsRequest)

取消合并合并的单元格。

object (UpdateBordersRequest)

更新一系列单元格中的边框。

object (UpdateCellsRequest)

一次更新多个单元格。

object (AddFilterViewRequest)

添加过滤视图。

object (AppendCellsRequest)

附加工作表中数据的最后一行之后的单元格。

object (ClearBasicFilterRequest)

清除工作表中的基本过滤条件。

object (DeleteDimensionRequest)

删除工作表中的行或列。

object (DeleteEmbeddedObjectRequest)

删除工作表中嵌入的对象（例如图表、图片）。

object (DeleteFilterViewRequest)

从工作表中删除过滤视图。

object (DuplicateFilterViewRequest)

复制过滤视图。

object (DuplicateSheetRequest)

复制工作表。

object (FindReplaceRequest)

查找某些文本并将其替换为其他文本。

object (InsertDimensionRequest)

在工作表中插入新的行或列。

object (InsertRangeRequest)

在工作表中插入新单元格，以移动现有单元格。

object (MoveDimensionRequest)

将行或列移至工作表中的其他位置。

object (UpdateEmbeddedObjectPositionRequest)

更新嵌入对象（例如图表、图片）的位置。

object (PasteDataRequest)

将数据（HTML 或分隔）粘贴到工作表中。

object (TextToColumnsRequest)

将一列文本转换为多列文本。

object (UpdateFilterViewRequest)

更新过滤视图的属性。

object (DeleteRangeRequest)

从工作表中删除一定范围的单元格，同时移动其余单元格。

object (AppendDimensionRequest)

在工作表末尾附加尺寸。

object (AddConditionalFormatRuleRequest)

添加新的条件格式规则。

object (UpdateConditionalFormatRuleRequest)

更新现有条件格式规则。

object (DeleteConditionalFormatRuleRequest)

用于删除现有的条件格式规则。

object (SortRangeRequest)

对范围内的数据进行排序。

object (SetDataValidationRequest)

为一个或多个单元格设置数据验证。

object (SetBasicFilterRequest)

在工作表上设置基本过滤条件。

object (AddProtectedRangeRequest)

添加受保护的范围。

object (UpdateProtectedRangeRequest)

更新受保护的范围。

object (DeleteProtectedRangeRequest)

删除受保护的范围。

object (AutoResizeDimensionsRequest)

根据一个或多个维度中单元格的内容自动调整该维度的大小。

object (AddChartRequest)

添加图表。

object (UpdateChartSpecRequest)

更新图表的规范。

object (UpdateBandingRequest)

更新带区范围

object (AddBandingRequest)

添加新的带区范围

object (DeleteBandingRequest)

移除带区范围

object (CreateDeveloperMetadataRequest)

创建新的开发者元数据

object (UpdateDeveloperMetadataRequest)

更新现有开发者元数据条目

object (DeleteDeveloperMetadataRequest)

删除开发者元数据

object (RandomizeRangeRequest)

对范围中各行的顺序进行随机化处理。

object (AddDimensionGroupRequest)

在指定范围内创建组。

object (DeleteDimensionGroupRequest)

删除指定范围内的组。

object (UpdateDimensionGroupRequest)

更新指定组的状态。

object (TrimWhitespaceRequest)

去除空格、制表符或换行符。

object (DeleteDuplicatesRequest)

移除单元格范围的指定列中包含重复值的行。

object (UpdateEmbeddedObjectBorderRequest)

更新嵌入对象的边框。

object (AddSlicerRequest)

添加截剪器。

object (UpdateSlicerSpecRequest)

更新截剪器的规范。

object (AddDataSourceRequest)

添加数据源。

object (UpdateDataSourceRequest)

更新数据源。

object (DeleteDataSourceRequest)

删除数据源。

object (RefreshDataSourceRequest)

刷新一个或多个数据源以及关联的 dbobject。

object (CancelDataSourceRefreshRequest)

取消一个或多个数据源及关联的 dbobject 对象的刷新。

{
  "properties": {
    object (SpreadsheetProperties)
  },
  "fields": string
}

object (SpreadsheetProperties)

要更新的属性。

string (FieldMask format)

应更新的字段。必须至少指定一个字段。根“properties”为隐含，不应指定。单个 "*" 可用作列出每个字段的简写形式。

{
  "properties": {
    object (SheetProperties)
  },
  "fields": string
}

object (SheetProperties)

要更新的属性。

string (FieldMask format)

应更新的字段。必须至少指定一个字段。根 properties 是隐式的，不应指定。单个 "*" 可用作列出每个字段的简写形式。

{
  "properties": {
    object (DimensionProperties)
  },
  "fields": string,

  // Union field dimension_range can be only one of the following:
  "range": {
    object (DimensionRange)
  },
  "dataSourceSheetRange": {
    object (DataSourceSheetDimensionRange)
  }
  // End of list of possible types for union field dimension_range.
}

object (DimensionProperties)

要更新的属性。

string (FieldMask format)

应更新的字段。必须至少指定一个字段。根 properties 是隐式的，不应指定。单个 "*" 可用作列出每个字段的简写形式。

object (DimensionRange)

要更新的行或列。

object (DataSourceSheetDimensionRange)

数据源工作表中要更新的列。

{
  "sheetId": integer,
  "columnReferences": [
    {
      object (DataSourceColumnReference)
    }
  ]
}

integer

范围所在数据源工作表的 ID。

object (DataSourceColumnReference)

数据源工作表中的列。

{
  "namedRange": {
    object (NamedRange)
  },
  "fields": string
}

object (NamedRange)

要使用新属性更新的命名范围。

string (FieldMask format)

应更新的字段。必须至少指定一个字段。根 namedRange 是隐式的，不应指定。单个 "*" 可用作列出每个字段的简写形式。

{
  "range": {
    object (GridRange)
  },
  "cell": {
    object (CellData)
  },
  "fields": string
}

object (GridRange)

要在其中重复单元格的范围。

object (CellData)

要写入的数据。

string (FieldMask format)

应更新的字段。必须至少指定一个字段。根 cell 是隐式的，不应指定。单个 "*" 可用作列出每个字段的简写形式。

{
  "namedRange": {
    object (NamedRange)
  }
}

object (NamedRange)

要添加的命名范围。namedRangeId 字段是可选字段；如果未设置该字段，系统会随机生成 ID。（指定已存在的范围 ID 是错误的。）

{
  "namedRangeId": string
}

string

要删除的命名范围的 ID。

{
  "properties": {
    object (SheetProperties)
  }
}

object (SheetProperties)

新工作表应具备的属性。所有属性均为可选属性。sheetId 字段是可选字段；如果未设置该字段，系统会随机生成 ID。（指定已存在的工作表的 ID 是错误的。）

{
  "sheetId": integer
}

integer

要删除的工作表的 ID。

如果工作表的类型是 DATA_SOURCE，关联的 DataSource 也会被删除。

{
  "useAlternateSeries": boolean,

  // Union field area can be only one of the following:
  "range": {
    object (GridRange)
  },
  "sourceAndDestination": {
    object (SourceAndDestination)
  }
  // End of list of possible types for union field area.
}

boolean

如果我们应使用“alternate”系列生成数据，则为 true。这一差异因源数据的类型和数量而异。

object (GridRange)

要自动填充的范围。这将检查范围并检测具有数据的位置，并自动将这些数据填充到范围的其余部分。

object (SourceAndDestination)

要自动填充的源区域和目标区域。这会明确列出自动填充的来源以及扩展这些数据的位置。

{
  "source": {
    object (GridRange)
  },
  "dimension": enum (Dimension),
  "fillLength": integer
}

object (GridRange)

要用作自动填充来源的数据的位置。

enum (Dimension)

数据应填充的维度。

integer

应填充数据的行数或列数。正数会扩展到源数据中的最后一行或最后一列之外。负数会在源数据的第一行或第一列之前展开。

{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridCoordinate)
  },
  "pasteType": enum (PasteType)
}

object (GridRange)

要剪切的源数据。

object (GridCoordinate)

应粘贴数据的左上角坐标。

enum (PasteType)

要粘贴的数据类型。无论粘贴什么内容，所有源数据都将被剪切。

{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridRange)
  },
  "pasteType": enum (PasteType),
  "pasteOrientation": enum (PasteOrientation)
}

object (GridRange)

要复制的来源范围。

object (GridRange)

要粘贴内容的位置。如果该范围覆盖的 span 是来源高度或宽度的倍数，则系统将重复数据以填充目标范围。如果此范围小于源范围，系统仍会复制整个源数据（超出目标范围的末尾）。

enum (PasteType)

要粘贴的数据类型。

enum (PasteOrientation)

粘贴数据时应如何定向。

{
  "range": {
    object (GridRange)
  },
  "mergeType": enum (MergeType)
}

object (GridRange)

要合并的单元格范围。

enum (MergeType)

单元格应如何合并。

{
  "range": {
    object (GridRange)
  }
}

object (GridRange)

应取消合并所有单元格的范围。如果该范围涵盖多次合并，所有合并操作都不会合并。该范围不得部分跨越所有合并单元格。

{
  "range": {
    object (GridRange)
  },
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  },
  "innerHorizontal": {
    object (Border)
  },
  "innerVertical": {
    object (Border)
  }
}

object (GridRange)

应更新其边框的范围。

object (Border)

要在范围顶部放置的边框。

object (Border)

要在范围底部放置的边框。

object (Border)

要在范围左侧放置的边框。

object (Border)

要在范围右侧添加的边框。

object (Border)

要在范围内的水平边框。

object (Border)

要置于范围内的垂直边框。

{
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string,

  // Union field area can be only one of the following:
  "start": {
    object (GridCoordinate)
  },
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field area.
}

object (RowData)

要写入的数据。

string (FieldMask format)

应更新的 CellData 的字段。必须至少指定一个字段。根是 CellData；不得指定“row.values.”。单个 "*" 可用作列出每个字段的简写形式。

object (GridCoordinate)

开始写入数据的坐标。可以写入任意数量的行和列（包括每行不同数量的列）。

object (GridRange)

要向其中写入数据的范围。

如果行中的数据未涵盖请求的整个范围，则将清除与 fields 中设置的字段匹配的字段。

{
  "filter": {
    object (FilterView)
  }
}

object (FilterView)

要添加的过滤条件。filterViewId 字段是可选字段；如果未设置该字段，系统会随机生成 ID。（指定已存在的过滤器的 ID 是错误的。）

{
  "sheetId": integer,
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string
}

integer

要附加数据的工作表 ID。

object (RowData)

要附加的数据。

string (FieldMask format)

应更新的 CellData 的字段。必须至少指定一个字段。根是 CellData；不得指定“row.values.”。单个 "*" 可用作列出每个字段的简写形式。

{
  "sheetId": integer
}

integer

应清除基本过滤条件的工作表 ID。

{
  "range": {
    object (DimensionRange)
  }
}

object (DimensionRange)

要从工作表中删除的维度。

{
  "objectId": integer
}

integer

要删除的嵌入对象的 ID。

{
  "filterId": integer
}

integer

要删除的过滤器的 ID。

{
  "filterId": integer
}

integer

要复制的过滤器的 ID。

{
  "sourceSheetId": integer,
  "insertSheetIndex": integer,
  "newSheetId": integer,
  "newSheetName": string
}

integer

要复制的工作表。

如果源工作表是 DATA_SOURCE 类型，系统还会复制其后备 DataSource，并将其与工作表的新副本相关联。不会触发数据执行，此工作表的网格数据也会被复制，但只有在批处理请求完成后才可使用。

integer

应在其中插入新工作表的索引（从零开始）。此后所有工作表的索引值递增。

integer

新工作表的 ID（如果已设置）。如果未设置，系统会选择一个 ID。如果已设置，则该 ID 不得与任何现有的工作表 ID 冲突。如果设置，此值必须是非负数。

string

新工作表的名称。如果为空，系统会为您选择新名称。

{
  "find": string,
  "replacement": string,
  "matchCase": boolean,
  "matchEntireCell": boolean,
  "searchByRegex": boolean,
  "includeFormulas": boolean,

  // Union field scope can be only one of the following:
  "range": {
    object (GridRange)
  },
  "sheetId": integer,
  "allSheets": boolean
  // End of list of possible types for union field scope.
}

string

要搜索的值。

string

要用作替换项的值。

boolean

如果搜索区分大小写，则为 true。

boolean

如果查找的值应与整个单元格匹配，则为 true。

boolean

如果查找的值是正则表达式，则返回 true。正则表达式和替换应遵循 Java 正则表达式规则 (https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html)。替换字符串可以指代捕获组。例如，如果某个单元格的内容为 "Google Sheets"，而另一个单元格的内容为 "Google Docs"，则搜索 "o.* (.*)" 并将其替换成 "$1 Rocks" 会将单元格的内容分别更改为 "GSheets Rocks" 和 "GDocs Rocks"。

boolean

如果搜索应包含带公式的单元格，则为 true。值为 false 时，将跳过包含公式的单元格。

object (GridRange)

要查找/替换的范围。

integer

要查找/替换的工作表。

boolean

如果为 True，则可查找/替换所有工作表。

{
  "range": {
    object (DimensionRange)
  },
  "inheritFromBefore": boolean
}

object (DimensionRange)

要插入的尺寸。起始索引和结束索引都必须有界限。

boolean

是否应根据新插入的维度之前或之后的维度扩展维度属性。如果为 true，则从之前的维度继承属性（在这种情况下，起始索引必须大于 0），值为 false 时，会从后面的维度继承。

例如，如果行索引 0 的背景为红色，行索引 1 为绿色背景，则在索引 1 处插入 2 行可继承绿色或红色背景。如果 inheritFromBefore 为 true，则两个新行将为红色（因为插入点前面的行为红色），而如果 inheritFromBefore 为 false，两个新行将为绿色（因为插入点后面的行为绿色）。

{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}

object (GridRange)

要在其中插入新单元格的范围。

enum (Dimension)

插入单元格时将偏移的维度。如果值为 ROWS，现有单元格将下移。如果值为 COLUMNS，现有单元格将右移。

{
  "source": {
    object (DimensionRange)
  },
  "destinationIndex": integer
}

object (DimensionRange)

要移动的来源维度。

integer

源数据要移至的位置的起始索引，基于从网格中移除源数据之前的坐标。现有数据会向下或向右移动（具体取决于维度），以便为移动的维度腾出空间。源维度会从网格中移除，因此数据最终获得的索引可能与指定索引不同。

例如，假设 A1..A5 为 0, 1, 2, 3, 4，并且您希望将 "1" 和 "2" 移到 "3" 和 "4" 之间，那么源索引将为 ROWS [1..3)，目标索引为 "4"（第 5 行从零开始的索引）。最终结果将是 A1..A5 个（共 0, 3, 1, 2, 4 个）。

{
  "objectId": integer,
  "newPosition": {
    object (EmbeddedObjectPosition)
  },
  "fields": string
}

integer

要移动的对象的 ID。

object (EmbeddedObjectPosition)

要将嵌入对象移动到的明确位置。如果设置 newPosition.sheetId，系统会创建具有该 ID 的新工作表。如果 newPosition.newSheet 设为 true，系统会使用为您选择的 ID 创建一个新工作表。

string (FieldMask format)

设置新位置时应更新的 OverlayPosition 字段。仅在设置了 newPosition.overlayPosition 时使用，在这种情况下，必须至少指定一个字段。根 newPosition.overlayPosition 是隐式的，不应指定。单个 "*" 可用作列出每个字段的简写形式。

{
  "coordinate": {
    object (GridCoordinate)
  },
  "data": string,
  "type": enum (PasteType),

  // Union field kind can be only one of the following:
  "delimiter": string,
  "html": boolean
  // End of list of possible types for union field kind.
}

object (GridCoordinate)

开始插入数据的坐标。

string

要插入的数据。

enum (PasteType)

应如何粘贴数据。

string

数据中的分隔符。

boolean

如果数据为 HTML，则为 true。

{
  "source": {
    object (GridRange)
  },
  "delimiter": string,
  "delimiterType": enum (DelimiterType)
}

object (GridRange)

源数据范围。此值必须正好跨列一列。

string

要使用的分隔符。仅在 感谢您为 CUSTOM 时使用 分隔符。

enum (DelimiterType)

要使用的分隔符类型。

{
  "filter": {
    object (FilterView)
  },
  "fields": string
}

object (FilterView)

过滤视图的新属性。

string (FieldMask format)

应更新的字段。必须至少指定一个字段。根 filter 是隐式的，不应指定。单个 "*" 可用作列出每个字段的简写形式。

{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}

object (GridRange)

要删除的单元格范围。

enum (Dimension)

用于替换已删除单元格的维度。如果值为 ROWS，现有单元格会上移，以替换已删除的单元格。如果值为 COLUMNS，现有单元格会左移以替换已删除的单元格。

{
  "sheetId": integer,
  "dimension": enum (Dimension),
  "length": integer
}

integer

要附加行或列的工作表。

enum (Dimension)

是否应附加行或列。

integer

要附加的行数或列数。

{
  "rule": {
    object (ConditionalFormatRule)
  },
  "index": integer
}

object (ConditionalFormatRule)

要添加的规则。

integer

应在其中插入规则的索引（从零开始）。

{
  "index": integer,
  "sheetId": integer,

  // Union field instruction can be only one of the following:
  "rule": {
    object (ConditionalFormatRule)
  },
  "newIndex": integer
  // End of list of possible types for union field instruction.
}

integer

应替换或移动的规则的索引（从零开始）。

integer

要移动的规则的工作表。如果设置了 newIndex，则为必需，否则不使用。

object (ConditionalFormatRule)

应替换指定索引中的规则的规则。

integer

规则最终应位于的新索引（从零开始）。

{
  "index": integer,
  "sheetId": integer
}

integer

要删除的规则的索引（从零开始）。

integer

要从中删除规则的工作表。

{
  "range": {
    object (GridRange)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ]
}

object (GridRange)

要排序的范围。

object (SortSpec)

每列的排序顺序。当值等于前面的规范时，将采用后面的规范。

{
  "range": {
    object (GridRange)
  },
  "rule": {
    object (DataValidationRule)
  }
}

object (GridRange)

应应用数据验证规则的范围。

object (DataValidationRule)

要为范围中的每个单元格设置的数据验证规则，如果留空，则清除范围中的数据验证。

{
  "filter": {
    object (BasicFilter)
  }
}

object (BasicFilter)

要设置的过滤条件。

{
  "protectedRange": {
    object (ProtectedRange)
  }
}

object (ProtectedRange)

要添加的受保护范围。protectedRangeId 字段是可选字段；如果未设置该字段，系统会随机生成 ID。（指定已存在的范围 ID 是错误的。）

{
  "protectedRange": {
    object (ProtectedRange)
  },
  "fields": string
}

object (ProtectedRange)

要使用新属性更新的受保护范围。

string (FieldMask format)

应更新的字段。必须至少指定一个字段。根 protectedRange 是隐式的，不应指定。单个 "*" 可用作列出每个字段的简写形式。

{
  "protectedRangeId": integer
}

integer

要删除的受保护范围的 ID。

{

  // Union field dimension_range can be only one of the following:
  "dimensions": {
    object (DimensionRange)
  },
  "dataSourceSheetDimensions": {
    object (DataSourceSheetDimensionRange)
  }
  // End of list of possible types for union field dimension_range.
}

object (DimensionRange)

要自动调整的尺寸。

object (DataSourceSheetDimensionRange)

数据源工作表上要自动调整尺寸的尺寸。

{
  "chart": {
    object (EmbeddedChart)
  }
}

object (EmbeddedChart)

应添加到电子表格的图表，包括应放置该图表的位置。chartId 字段是可选字段；如果未设置该字段，系统会随机生成 ID。（指定已存在的嵌入对象的 ID 会导致出错。）

{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  }
}

integer

要更新的图表的 ID。

object (ChartSpec)

应用于图表的规范。

{
  "bandedRange": {
    object (BandedRange)
  },
  "fields": string
}

object (BandedRange)

要使用新属性更新的带区范围。

string (FieldMask format)

应更新的字段。必须至少指定一个字段。根 bandedRange 是隐式的，不应指定。单个 "*" 可用作列出每个字段的简写形式。

{
  "bandedRange": {
    object (BandedRange)
  }
}

object (BandedRange)

要添加的带状范围。bandedRangeId 字段是可选字段；如果未设置该字段，系统会随机生成 ID。（指定已存在的范围 ID 是错误的。）

{
  "bandedRangeId": integer
}

integer

要删除的带区范围的 ID。

{
  "developerMetadata": {
    object (DeveloperMetadata)
  }
}

object (DeveloperMetadata)

要创建的开发者元数据。

{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "developerMetadata": {
    object (DeveloperMetadata)
  },
  "fields": string
}

object (DataFilter)

与要更新的开发者元数据条目匹配的过滤条件。

object (DeveloperMetadata)

与数据过滤器匹配的所有元数据都将更新为的值。

string (FieldMask format)

应更新的字段。必须至少指定一个字段。根 developerMetadata 是隐式的，不应指定。单个 "*" 可用作列出每个字段的简写形式。

{
  "dataFilter": {
    object (DataFilter)
  }
}

object (DataFilter)

数据过滤器，描述用于选择要删除的开发者元数据条目的条件。

{
  "range": {
    object (GridRange)
  }
}

object (GridRange)

要随机化的范围。

{
  "range": {
    object (DimensionRange)
  }
}

object (DimensionRange)

要创建群组的范围。

{
  "range": {
    object (DimensionRange)
  }
}

object (DimensionRange)

要删除的组的范围。

{
  "dimensionGroup": {
    object (DimensionGroup)
  },
  "fields": string
}

object (DimensionGroup)

应更新其状态的组。组的范围和深度应指定工作表上的有效组，并更新所有其他字段。

string (FieldMask format)

应更新的字段。必须至少指定一个字段。根 dimensionGroup 是隐式的，不应指定。单个 "*" 可用作列出每个字段的简写形式。

{
  "range": {
    object (GridRange)
  }
}

object (GridRange)

要修剪其单元格的范围。

{
  "range": {
    object (GridRange)
  },
  "comparisonColumns": [
    {
      object (DimensionRange)
    }
  ]
}

object (GridRange)

要从中移除重复行的范围。

object (DimensionRange)

要分析是否存在重复值的范围内的列。如果未选择任何列，则会分析所有列是否重复。

{
  "objectId": integer,
  "border": {
    object (EmbeddedObjectBorder)
  },
  "fields": string
}

integer

要更新的嵌入对象的 ID。

object (EmbeddedObjectBorder)

应用于嵌入对象的边框。

string (FieldMask format)

应更新的字段。必须至少指定一个字段。根 border 是隐式的，不应指定。单个 "*" 可用作列出每个字段的简写形式。

{
  "slicer": {
    object (Slicer)
  }
}

object (Slicer)

应添加到电子表格的截剪器，包括应放置该截剪器的位置。slicerId 字段是可选字段；如果未设置该字段，系统会随机生成 ID。（指定已存在的截剪器的 ID 是错误的。）

{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "fields": string
}

integer

要更新的截剪器的 ID。

object (SlicerSpec)

应用于截剪器的规范。

string (FieldMask format)

应更新的字段。必须至少指定一个字段。根 SlicerSpec 是隐式的，不应指定。一个“*”可用作列出每个字段的简写形式。

{
  "dataSource": {
    object (DataSource)
  }
}

object (DataSource)

要添加的数据源。

{
  "dataSource": {
    object (DataSource)
  },
  "fields": string
}

object (DataSource)

要更新的数据源。

string (FieldMask format)

应更新的字段。必须至少指定一个字段。根 dataSource 是隐式的，不应指定。单个 "*" 可用作列出每个字段的简写形式。

{
  "dataSourceId": string
}

string

要删除的数据源的 ID。

{
  "force": boolean,

  // Union field target can be only one of the following:
  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
  // End of list of possible types for union field target.
}

boolean

刷新数据源对象，而不考虑当前状态。如果未设置，并且引用的数据源对象处于错误状态，则刷新将立即失败。

object (DataSourceObjectReferences)

对要刷新的数据源对象的引用。

string

对 DataSource 的引用。如果指定，则刷新数据源的所有关联数据源对象。

boolean

刷新电子表格中的所有现有数据源对象。

{
  "references": [
    {
      object (DataSourceObjectReference)
    }
  ]
}

object (DataSourceObjectReference)

引用。

{

  // Union field value can be only one of the following:
  "sheetId": string,
  "chartId": integer,
  "dataSourceTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourcePivotTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourceFormulaCell": {
    object (GridCoordinate)
  }
  // End of list of possible types for union field value.
}

string

对 DATA_SOURCE 表格的引用。

integer

对数据源图表的引用。

object (GridCoordinate)

对锚定在单元格中的 DataSourceTable 的引用。

object (GridCoordinate)

对锚定在单元格中的数据源 PivotTable 的引用。

object (GridCoordinate)

对包含 DataSourceFormula 的单元格的引用。

{

  // Union field target can be only one of the following:
  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
  // End of list of possible types for union field target.
}

object (DataSourceObjectReferences)

对要取消刷新的数据源对象的引用。

string

对 DataSource 的引用。如果指定，系统将取消此数据源的所有关联数据源对象刷新。

boolean

取消对电子表格中所有数据源的所有现有数据源对象刷新。