请求
要应用于电子表格的单项更新。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 kind 。更新的类型。只有一个字段是必填字段。
kind 只能是下列其中一项:
|
|
updateSpreadsheetProperties
|
更新电子表格的属性。 |
updateSheetProperties
|
更新工作表的属性。 |
updateDimensionProperties
|
更新维度的属性。 |
updateNamedRange
|
更新命名的范围。 |
repeatCell
|
在某个范围内重复某个单元格。 |
addNamedRange
|
添加已命名的范围。 |
deleteNamedRange
|
删除命名的范围。 |
addSheet
|
添加工作表。 |
deleteSheet
|
删除工作表。 |
autoFill
|
根据现有数据自动填写更多数据。 |
cutPaste
|
剪切某个区域的数据,并将其粘贴到另一个区域。 |
copyPaste
|
从一个区域复制数据,并将其粘贴到另一个区域。 |
mergeCells
|
将单元格合并。 |
unmergeCells
|
取消合并已合并的单元格。 |
updateBorders
|
更新一系列单元格中的边框。 |
updateCells
|
一次更新多个单元格。 |
addFilterView
|
添加过滤视图。 |
appendCells
|
在工作表中最后一行后附加单元格数据。 |
clearBasicFilter
|
清除工作表的基本过滤条件。 |
deleteDimension
|
删除工作表中的行或列。 |
deleteEmbeddedObject
|
删除工作表中嵌入的对象(例如图表、图片)。 |
deleteFilterView
|
从工作表中删除过滤视图。 |
duplicateFilterView
|
复制过滤视图。 |
duplicateSheet
|
复制工作表。 |
findReplace
|
查找某些文本并将其替换为其他文本。 |
insertDimension
|
在工作表中插入新行或新列。 |
insertRange
|
在工作表中插入新单元格时,会移动现有单元格。 |
moveDimension
|
将行或列移动到工作表中的其他位置。 |
updateEmbeddedObjectPosition
|
更新嵌入式对象(例如图表、图片)的位置。 |
pasteData
|
将数据(HTML 或分隔数据)粘贴到工作表中。 |
textToColumns
|
将文本列转换为许多文本列。 |
updateFilterView
|
更新过滤视图的属性。 |
deleteRange
|
从工作表中删除一组单元格,同时移动其余单元格。 |
appendDimension
|
将维度附加到工作表的末尾。 |
addConditionalFormatRule
|
添加了新的条件格式规则。 |
updateConditionalFormatRule
|
更新现有条件格式规则。 |
deleteConditionalFormatRule
|
删除现有的条件格式规则。 |
sortRange
|
对范围中的数据进行排序。 |
setDataValidation
|
为一个或多个单元格设置数据验证。 |
setBasicFilter
|
设置工作表的基本过滤条件。 |
addProtectedRange
|
添加受保护的范围。 |
updateProtectedRange
|
更新受保护的范围。 |
deleteProtectedRange
|
删除受保护的范围。 |
autoResizeDimensions
|
根据该维度中单元格的内容自动调整一个或多个维度的大小。 |
addChart
|
添加图表。 |
updateChartSpec
|
更新图表的规范。 |
updateBanding
|
更新带范围的范围 |
addBanding
|
添加新的带范围 |
deleteBanding
|
移除条带范围 |
createDeveloperMetadata
|
创建新的开发者元数据 |
updateDeveloperMetadata
|
更新现有开发者元数据条目 |
deleteDeveloperMetadata
|
删除开发者元数据 |
randomizeRange
|
对范围中各行的顺序进行随机化。 |
addDimensionGroup
|
创建超出指定范围的群组。 |
deleteDimensionGroup
|
删除指定范围内的群组。 |
updateDimensionGroup
|
更新指定组的状态。 |
trimWhitespace
|
去除空格(例如空格、制表符或换行符)。 |
deleteDuplicates
|
移除单元格指定列中包含重复值的行。 |
updateEmbeddedObjectBorder
|
更新嵌入对象的边框。 |
addSlicer
|
添加截剪器。 |
updateSlicerSpec
|
更新截剪器的规范。 |
addDataSource
|
添加数据源。 |
updateDataSource
|
更新数据源。 |
deleteDataSource
|
删除数据源。 |
refreshDataSource
|
刷新一个或多个数据源以及关联的数据库对象。 |
Update 电子表格 PropertiesRequest
更新电子表格的属性。
JSON 表示法 |
---|
{
"properties": {
object (
|
字段 | |
---|---|
properties
|
要更新的属性。 |
fields
|
应更新的字段。必须至少指定一个字段。暗示“根”属性为根源,不应指定。单个 |
UpdateSheetPropertiesRequest
使用指定的 sheetId
更新工作表的属性。
JSON 表示法 |
---|
{
"properties": {
object (
|
字段 | |
---|---|
properties
|
要更新的属性。 |
fields
|
应更新的字段。必须至少指定一个字段。根隐式意味着 |
UpdateDimensionPropertiesRequest
更新指定范围内的维度属性。
JSON 表示法 |
---|
{ "properties": { object ( |
字段 | |
---|---|
properties
|
要更新的属性。 |
fields
|
应更新的字段。必须至少指定一个字段。根隐式意味着 |
联合字段 dimension_range 。维度范围。
dimension_range 只能是下列其中一项:
|
|
range
|
要更新的行或列。 |
dataSourceSheetRange
|
数据源工作表中要更新的列。 |
DataSourceSheetDimensionRange
一个 DATA_SOURCE
工作表中一个维度的范围。
JSON 表示法 |
---|
{
"sheetId": integer,
"columnReferences": [
{
object (
|
字段 | |
---|---|
sheetId
|
范围所在数据源工作表的 ID。 |
columnReferences[]
|
数据源工作表中的列。 |
UpdateNamedRangeRequest
使用指定的 namedRangeId
更新命名范围的属性。
JSON 表示法 |
---|
{
"namedRange": {
object (
|
字段 | |
---|---|
namedRange
|
使用新属性更新的已命名范围。 |
fields
|
应更新的字段。必须至少指定一个字段。根隐式意味着 |
RepeatCellRequest
将范围中的所有单元格更新为指定 Cell 对象中的值。只有 fields
字段中列出的字段会更新;其他字段保持不变。
如果输入的是包含公式的单元格,那么此公式的范围会自动对范围中的每个字段进行递增。例如,如果将公式为 =A1
的单元格写入范围 B2:C4,B2 为 =A1
,B3 为 =A2
,B4 为 =A3
,C2 为 =B1
,C3 为 =B2
,C4 为 =B3
。
要让公式的范围保持不变,请使用 $
指示符。例如,使用公式 =$A$1
防止行和列递增。
JSON 表示法 |
---|
{ "range": { object ( |
字段 | |
---|---|
range
|
要重复输入单元格的范围。 |
cell
|
要写入的数据。 |
fields
|
应更新的字段。必须至少指定一个字段。根隐式意味着 |
AddNamedRangeRequest
将已命名范围添加到电子表格。
JSON 表示法 |
---|
{
"namedRange": {
object (
|
字段 | |
---|---|
namedRange
|
要添加的命名范围。 |
DeleteNamedRangeRequest
从电子表格中移除指定 ID 的命名范围。
JSON 表示法 |
---|
{ "namedRangeId": string } |
字段 | |
---|---|
namedRangeId
|
要删除的已命名范围的 ID。 |
AddSheetRequest
添加新工作表。当某个工作表被添加到给定索引中时,所有后续工作表的索引都会递增。如需添加对象工作表,请改用 AddChartRequest
并指定 EmbeddedObjectPosition.sheetId
或 EmbeddedObjectPosition.newSheet
。
JSON 表示法 |
---|
{
"properties": {
object (
|
字段 | |
---|---|
properties
|
新工作表应具有的属性。所有房源均为可选属性。 |
DeleteSheetRequest
删除所请求的工作表。
JSON 表示法 |
---|
{ "sheetId": integer } |
字段 | |
---|---|
sheetId
|
要删除的工作表的 ID。
如果工作表的类型为 |
自动填充请求
根据现有数据填充更多数据。
JSON 表示法 |
---|
{ "useAlternateSeries": boolean, // Union field |
字段 | |
---|---|
useAlternateSeries
|
如果我们应该生成具有“备用”系列的数据,则为 true。具体取决于源数据的类型和数量。 |
联合字段 area 。要自动填充的区域。
area 只能是下列其中一项:
|
|
range
|
要自动填充的范围。这会对范围进行检测,检测存在数据的位置,并自动将数据填充到范围的其余位置。 |
sourceAndDestination
|
要自动填充的来源和目标区域。这会明确列出自动填充数据的来源以及扩展这些数据的位置。 |
来源和目标
来源范围以及如何扩展来源。
JSON 表示法 |
---|
{ "source": { object ( |
字段 | |
---|---|
source
|
用作自动填充来源的数据的位置。 |
dimension
|
数据应填充到的维度。 |
fillLength
|
应填写数据的行数或列数。正数会扩展到来源的最后一行或最后一列。负数在来源的第一行或第一列之前展开。 |
CutPasteRequest
将数据从源迁移到目标。
JSON 表示法 |
---|
{ "source": { object ( |
字段 | |
---|---|
source
|
要剪切的源数据。 |
destination
|
应粘贴数据的左上角坐标。 |
pasteType
|
要粘贴的数据类型。所有源数据都会被剪切,无论粘贴的是哪个数据。 |
粘贴类型
应粘贴哪些类型的数据。
枚举 | |
---|---|
PASTE_NORMAL
|
粘贴值、公式、格式以及合并。 |
PASTE_VALUES
|
仅粘贴值,不粘贴格式、公式或合并。 |
PASTE_FORMAT
|
请仅粘贴格式和数据验证。 |
PASTE_NO_BORDERS
|
与 PASTE_NORMAL 类似,但无边框。
|
PASTE_FORMULA
|
仅粘贴公式。 |
PASTE_DATA_VALIDATION
|
仅粘贴数据验证。 |
PASTE_CONDITIONAL_FORMATTING
|
请仅粘贴条件格式规则。 |
CopyPasteRequest
将来源中的数据复制到目标位置。
JSON 表示法 |
---|
{ "source": { object ( |
字段 | |
---|---|
source
|
要复制的来源范围。 |
destination
|
要粘贴到的位置。如果该范围涵盖的范围是来源高度或宽度的倍数,则会重复数据以填充目标范围。如果此范围小于来源范围,则整个源数据仍将复制(在目标范围的末尾之外)。 |
pasteType
|
要粘贴的数据类型。 |
pasteOrientation
|
粘贴时该如何定向数据。 |
粘贴方向
应如何执行粘贴操作。
枚举 | |
---|---|
NORMAL
|
正常粘贴。 |
TRANSPOSE
|
粘贴转置内容,其中所有行都变成列,反之亦然。 |
MergeCellsRequest
合并范围中的所有单元格。
JSON 表示法 |
---|
{ "range": { object ( |
字段 | |
---|---|
range
|
要合并的单元格范围。 |
mergeType
|
应如何合并单元格。 |
MergeType
要创建的合并类型。
枚举 | |
---|---|
MERGE_ALL
|
根据范围创建单个合并 |
MERGE_COLUMNS
|
为范围中的每个列创建合并 |
MERGE_ROWS
|
为范围的每行创建一个合并 |
UnmergeCellsRequest
取消合并指定范围内的单元格。
JSON 表示法 |
---|
{
"range": {
object (
|
字段 | |
---|---|
range
|
应在其中合并所有单元格的范围。如果该范围跨越多个合并,则所有合并将取消合并。该范围不得跨越部分合并。 |
UpdateBordersRequest
更新范围的边框。如果请求中未设置某个字段,则意味着边框保持不变。例如,有两个后续 UpdateBordersRequest:
-
范围:A1:A5
{ top: RED, bottom: WHITE }
-
范围:A1:A5
{ left: BLUE }
这将导致 A1:A5 的边框为 { top: RED, bottom: WHITE, left: BLUE }
。若要清除边框,请将样式明确设置为 NONE
。
JSON 表示法 |
---|
{ "range": { object ( |
字段 | |
---|---|
range
|
应更新其边框的范围。 |
top
|
要放置在范围顶部的边框。 |
bottom
|
要放置在范围底部的边框。 |
left
|
要放置在范围左侧的边框。 |
right
|
要放置在范围右侧的边框。 |
innerHorizontal
|
要置于范围内的水平边框。 |
innerVertical
|
要置于范围内的垂直边框。 |
UpdateCellsRequest
使用新数据更新范围中的所有单元格。
JSON 表示法 |
---|
{ "rows": [ { object ( |
字段 | |
---|---|
rows[]
|
要写入的数据。 |
fields
|
应更新的 CellData 字段。必须至少指定一个字段。根为 CellData;不应指定“row.values”。单个 |
联合字段 area 。应写入位置数据。只能设置一个值。area 只能是下列其中一项:
|
|
start
|
开始写入数据的坐标。可以写入任意数量的行和列(包括每行的不同列数)。 |
range
|
要写入数据的范围。
如果行中的数据未涵盖整个请求范围,则系统会清除与 |
AddFilterViewRequest
添加过滤视图。
JSON 表示法 |
---|
{
"filter": {
object (
|
字段 | |
---|---|
filter
|
要添加的过滤条件。 |
附加单元格请求
在工作表中最后一行后添加新的单元格,必要时在表格中插入新行。
JSON 表示法 |
---|
{
"sheetId": integer,
"rows": [
{
object (
|
字段 | |
---|---|
sheetId
|
要附加数据的工作表 ID。 |
rows[]
|
要附加的数据。 |
fields
|
应更新的 CellData 字段。必须至少指定一个字段。根为 CellData;不应指定“row.values”。单个 |
ClearBasicFilterRequest
如果工作表中存在基本过滤条件,则清除该过滤条件。
JSON 表示法 |
---|
{ "sheetId": integer } |
字段 | |
---|---|
sheetId
|
应在其中清除基本过滤条件的工作表 ID。 |
DeleteDimensionRequest
从工作表中删除维度。
JSON 表示法 |
---|
{
"range": {
object (
|
字段 | |
---|---|
range
|
要从工作表中删除的维度。 |
删除嵌入式对象请求
删除具有指定 ID 的嵌入对象。
JSON 表示法 |
---|
{ "objectId": integer } |
字段 | |
---|---|
objectId
|
要删除的嵌入对象的 ID。 |
DeleteFilterViewRequest
删除特定的过滤视图。
JSON 表示法 |
---|
{ "filterId": integer } |
字段 | |
---|---|
filterId
|
要删除的过滤器的 ID。 |
DuplicateFilterViewRequest
复制特定的过滤视图。
JSON 表示法 |
---|
{ "filterId": integer } |
字段 | |
---|---|
filterId
|
正在复制的过滤条件的 ID。 |
DuplicateSheetRequest
复制工作表中的内容。
JSON 表示法 |
---|
{ "sourceSheetId": integer, "insertSheetIndex": integer, "newSheetId": integer, "newSheetName": string } |
字段 | |
---|---|
sourceSheetId
|
要复制的工作表。
如果源工作表的类型为 |
insertSheetIndex
|
应该插入新工作表的索引(从零开始)。此后所有工作表的索引都会递增。 |
newSheetId
|
设置后,相应新工作表的 ID 即会设置。如果未设置,则系统会选择 ID。如果设置此参数,则该 ID 不得与任何现有的工作表 ID 冲突。如果设置此参数,它必须是非负数。 |
newSheetName
|
新工作表的名称。如果为空,系统会为您选择新名称。 |
FindReplaceRequest
查找并替换单元格、范围或所有工作表中的数据。
JSON 表示法 |
---|
{ "find": string, "replacement": string, "matchCase": boolean, "matchEntireCell": boolean, "searchByRegex": boolean, "includeFormulas": boolean, // Union field |
字段 | |
---|---|
find
|
要搜索的值。 |
replacement
|
要用作替换值的值。 |
matchCase
|
如果搜索区分大小写,则为 true。 |
matchEntireCell
|
如果查找值应与整个单元格匹配,则为 true。 |
searchByRegex
|
如果查找值是正则表达式,则返回 true。正则表达式和替换应遵循 https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html 上的 Java 正则表达式规则。替换字符串可引用捕获组。例如,如果一个单元格包含 |
includeFormulas
|
如果搜索应包含包含公式的单元格,则为 true。设为 false 时,将跳过公式计算单元格。 |
联合字段 scope 。要查找/替换的范围,只能设置一个。scope 只能是下列其中一项:
|
|
range
|
要查找/替换的范围。 |
sheetId
|
要查找/替换的工作表。 |
allSheets
|
如果为 true,则会查找/替换所有工作表。 |
InsertDimensionRequest
在工作表中的特定索引处插入行或列。
JSON 表示法 |
---|
{
"range": {
object (
|
字段 | |
---|---|
range
|
要插入的维度。起始索引和结束索引都必须有界限。 |
inheritFromBefore
|
维度属性是否应从新插入维度的前面或后面展开。如果从先前的维度继承( true ,则起始索引必须大于 0);如果从其之前继承,则值为 false。
例如,如果行索引 0 具有红色背景,行索引 1 具有绿色背景,则在索引 1 处插入 2 行可继承绿色或红色背景。如果 |
InsertRangeRequest
将单元格插入某个范围,将现有单元格上移或下移。
JSON 表示法 |
---|
{ "range": { object ( |
字段 | |
---|---|
range
|
要插入新单元格的范围。 |
shiftDimension
|
|
MoveDimensionRequest
移动一行或多列。
JSON 表示法 |
---|
{
"source": {
object (
|
字段 | |
---|---|
source
|
要移动的来源维度。 |
destinationIndex
|
根据从源数据中移除源数据之前的坐标,将源数据移动到什么起始索引(从零开始)。现有数据将下移或向右移动(具体取决于维度),以便为移动的维度腾出空间。系统会从网格中移除来源维度,因此数据最终显示的位置可能不同于指定的索引。
例如,假设 |
更新嵌入式对象位置请求
更新嵌入对象的位置(例如移动图表或图片大小)。
JSON 表示法 |
---|
{
"objectId": integer,
"newPosition": {
object (
|
字段 | |
---|---|
objectId
|
要移动的对象的 ID。 |
newPosition
|
将嵌入式对象移动到的明确位置。如果您设置了 |
fields
|
在设置新位置时应更新的 |
粘贴数据请求
以指定的坐标为起点,在电子表格中插入数据。
JSON 表示法 |
---|
{ "coordinate": { object ( |
字段 | |
---|---|
coordinate
|
应开始插入数据的坐标。 |
data
|
要插入的数据。 |
type
|
应如何粘贴数据。 |
联合字段 kind 。如何解读数据,只能设置一个值。
kind 只能是下列其中一项:
|
|
delimiter
|
数据中的分隔符。 |
html
|
如果数据为 HTML,则为 true。 |
TextToColumnsRequest
根据每个单元格中的分隔符将一列文本拆分为多列。
JSON 表示法 |
---|
{ "source": { object ( |
字段 | |
---|---|
source
|
源数据范围。必须正好有一列。 |
delimiter
|
要使用的分隔符。仅在分隔符为 |
delimiterType
|
要使用的分隔符类型。 |
分隔符类型
要拆分的分隔符。
枚举 | |
---|---|
DELIMITER_TYPE_UNSPECIFIED
|
默认值。不得使用此值。 |
COMMA
|
” |
SEMICOLON
|
“;” |
PERIOD
|
。” |
SPACE
|
” |
CUSTOM
|
分隔符中定义的自定义值。 |
AUTODETECT
|
自动检测列。 |
UpdateFilterViewRequest
更新过滤视图的属性。
JSON 表示法 |
---|
{
"filter": {
object (
|
字段 | |
---|---|
filter
|
过滤视图的新属性。 |
fields
|
应更新的字段。必须至少指定一个字段。根隐式意味着 |
DeleteRangeRequest
删除一系列单元格,将其他单元格移至已删除区域。
JSON 表示法 |
---|
{ "range": { object ( |
字段 | |
---|---|
range
|
要删除的单元格范围。 |
shiftDimension
|
用来替换已删除单元格的维度。如果值为 |
附加维度请求
将行或列附加到工作表的末尾。
JSON 表示法 |
---|
{
"sheetId": integer,
"dimension": enum (
|
字段 | |
---|---|
sheetId
|
要附加行或列的工作表。 |
dimension
|
是否应附加行或列。 |
length
|
要附加的行数或列数。 |
AddConditionalFormatRuleRequest
在给定索引处添加新的条件格式规则。所有后续规则的索引都会递增。
JSON 表示法 |
---|
{
"rule": {
object (
|
字段 | |
---|---|
rule
|
要添加的规则。 |
index
|
应插入规则的索引(从零开始)。 |
UpdateConditionalFormatRuleRequest
更新给定索引处的条件格式规则,或将条件格式规则移至另一个索引。
JSON 表示法 |
---|
{ "index": integer, "sheetId": integer, // Union field |
字段 | |
---|---|
index
|
应替换或移动的规则的索引(从零开始)。 |
sheetId
|
要移动的规则的表格。如果设置了 |
联合字段 instruction 。应发生的更新类型。
instruction 只能是下列其中一项:
|
|
rule
|
应替换给定索引中的规则的规则。 |
newIndex
|
规则最终应从零开始的新索引。 |
DeleteConditionalFormatRuleRequest
删除指定索引处的条件格式规则。所有后续规则的索引都会减少。
JSON 表示法 |
---|
{ "index": integer, "sheetId": integer } |
字段 | |
---|---|
index
|
要删除的规则的索引(从零开始)。 |
sheetId
|
从中删除规则的工作表。 |
SortRangeRequest
根据每列的排序顺序将数据排序。
JSON 表示法 |
---|
{ "range": { object ( |
字段 | |
---|---|
range
|
要排序的范围。 |
sortSpecs[]
|
每列的排序顺序。如果前面的规范中的值相等,系统会使用更晚的规范。 |
SetDataValidationRequest
为范围中的每个单元格设置数据验证规则。如需清除某个范围内的验证,请在不指定规则的情况下调用此方法。
JSON 表示法 |
---|
{ "range": { object ( |
字段 | |
---|---|
range
|
数据验证规则应应用的范围。 |
rule
|
为范围中的每个单元格设置的数据验证规则,或留空以清除范围中的数据验证。 |
SetBasicFilterRequest
设置与工作表关联的基本过滤条件。
JSON 表示法 |
---|
{
"filter": {
object (
|
字段 | |
---|---|
filter
|
要设置的过滤器。 |
AddProtectedRangeRequest
添加新的受保护的范围。
JSON 表示法 |
---|
{
"protectedRange": {
object (
|
字段 | |
---|---|
protectedRange
|
要添加的受保护范围。 |
UpdateProtectedRangeRequest
使用指定的 protectedRangeId
更新现有受保护的范围。
JSON 表示法 |
---|
{
"protectedRange": {
object (
|
字段 | |
---|---|
protectedRange
|
需要更新新属性的受保护范围。 |
fields
|
应更新的字段。必须至少指定一个字段。根隐式意味着 |
DeleteProtectedRangeRequest
删除具有指定 ID 的受保护范围。
JSON 表示法 |
---|
{ "protectedRangeId": integer } |
字段 | |
---|---|
protectedRangeId
|
要删除的受保护范围的 ID。 |
AutoResizeDimensionRequest
根据该维度中单元格的内容自动调整一个或多个维度的大小。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 dimension_range 。维度范围。
dimension_range 只能是下列其中一项:
|
|
dimensions
|
要自动调整大小的维度。 |
dataSourceSheetDimensions
|
数据源工作表中自动调整大小的维度。 |
AddChartRequest
将图表添加到电子表格中的工作表。
JSON 表示法 |
---|
{
"chart": {
object (
|
字段 | |
---|---|
chart
|
添加到电子表格的图表,包括应放置的位置。 |
UpdateChartSpecRequest
更新图表的规范。(这不会移动图表或调整图表的大小。如需移动图表或调整图表大小,请使用 UpdateEmbeddedObjectPositionRequest
。)
JSON 表示法 |
---|
{
"chartId": integer,
"spec": {
object (
|
字段 | |
---|---|
chartId
|
要更新的图表的 ID。 |
spec
|
应用于图表的规范。 |
UpdateBandingRequest
更新提供的频段范围的属性。
JSON 表示法 |
---|
{
"bandedRange": {
object (
|
字段 | |
---|---|
bandedRange
|
要更新为新属性的带范围范围。 |
fields
|
应更新的字段。必须至少指定一个字段。根隐式意味着 |
AddBandingRequest
向电子表格中添加新的带范围范围。
JSON 表示法 |
---|
{
"bandedRange": {
object (
|
字段 | |
---|---|
bandedRange
|
要添加的频段范围。 |
DeleteBandingRequest
从电子表格中移除指定 ID 的带频段范围。
JSON 表示法 |
---|
{ "bandedRangeId": integer } |
字段 | |
---|---|
bandedRangeId
|
要删除的频段范围的 ID。 |
CreateDeveloperMetadataRequest
请求创建开发者元数据。
JSON 表示法 |
---|
{
"developerMetadata": {
object (
|
字段 | |
---|---|
developerMetadata
|
要创建的开发者元数据。 |
UpdateDeveloperMetadataRequest
请求更新开发者元数据的属性。将过滤器选择的开发者元数据的属性更新为 DeveloperMetadata
资源中提供的值。调用方必须在 fields 参数中指定他们要更新的属性,以及指定至少一个与其要更新的元数据匹配的 DataFilter
。
JSON 表示法 |
---|
{ "dataFilters": [ { object ( |
字段 | |
---|---|
dataFilters[]
|
与要更新的开发者元数据条目匹配的过滤器。 |
developerMetadata
|
数据过滤器匹配的所有元数据都将更新为该值。 |
fields
|
应更新的字段。必须至少指定一个字段。根隐式意味着 |
DeleteDeveloperMetadataRequest
请求删除开发者元数据。
JSON 表示法 |
---|
{
"dataFilter": {
object (
|
字段 | |
---|---|
dataFilter
|
数据过滤器,描述用于选择删除的开发者元数据条目的条件。 |
RandomizeRangeRequest
对范围中各行的顺序进行随机化。
JSON 表示法 |
---|
{
"range": {
object (
|
字段 | |
---|---|
range
|
要随机范围。 |
AddDimensionGroupRequest
创建超出指定范围的群组。
如果请求的范围是现有群组 G 的范围的超集,则 G 的深度会递增,而这个新群组 G 的深度为对应群组的深度。例如,组 [C:D, depth 1] + [B:E] 可生成组 [B:E, depth 1] 和 [C:D, depth 2]。如果请求的范围是现有群组 G 范围的子集,则新群组 G' 的深度会大于 G 的深度。例如,组 [B:E, depth 1] + [C:D] 可生成组 [B:E, depth 1] 和 [C:D, depth 2]。如果请求的范围在现有群组 G 的范围之前开始、在 结束之前结束,或在 结束之后结束,则现有群组 G 的范围将变为范围的集合,并且新群组 G' 的深度大于 G 的范围,并且范围的范围为范围的交集。例如,组 [B:D, depth 1] + [C:E] 可生成组 [B:E, depth 1] 和 [C:D, depth 2]。
JSON 表示法 |
---|
{
"range": {
object (
|
字段 | |
---|---|
range
|
可在其中创建组的范围。 |
DeleteDimensionGroupRequest
通过递减范围内维度的深度,删除指定范围内的组。
例如,假设工作表在 B:E 上具有 depth-1 组,在 C:D 上具有 depth-2 组。如果通过 D:E 删除组,那么在 B:D 上留下了 depth-1 组和 C:C 上 depth-2 组。
JSON 表示法 |
---|
{
"range": {
object (
|
字段 | |
---|---|
range
|
要删除的组的范围。 |
UpdateDimensionGroupRequest
更新指定组的状态。
JSON 表示法 |
---|
{
"dimensionGroup": {
object (
|
字段 | |
---|---|
dimensionGroup
|
应更新其状态的群组。组的范围和深度应指定工作表上的有效组,并更新所有其他字段。 |
fields
|
应更新的字段。必须至少指定一个字段。根隐式意味着 |
TrimWhitespaceRequest
删除指定范围每个单元格内的空白(例如空格、制表符或换行符)。此请求会移除每个单元格文本开头和结尾的所有空格,并将剩余空白字符的所有子序列减少到一个空格。如果生成的剪辑后的文字以“+”或“=”字符开头,则相应文本将保留为字符串值,而不会被解释为公式。
JSON 表示法 |
---|
{
"range": {
object (
|
字段 | |
---|---|
range
|
要修剪的单元格范围。 |
DeleteDuplicatesRequest
移除此范围内包含指定列中与之前任何行中的值重复的行。系统会将具有相同值但字母大小写、格式设置或公式不同的行视为重复行。
此请求还会移除视图中隐藏的重复行(例如,由于过滤条件)。移除重复项时,每个从顶部向下扫描的重复行都会保持在生成的范围内。指定范围之外的内容不会被移除,且被视为重复的行不必在该范围内彼此相邻。
JSON 表示法 |
---|
{ "range": { object ( |
字段 | |
---|---|
range
|
要移除重复行的范围。 |
comparisonColumns[]
|
要分析是否存在重复值的范围的列。如果未选择任何列,则会分析所有列是否存在重复项。 |
UpdateEmbedObjectBorderRequest
更新嵌入对象的边框属性。
JSON 表示法 |
---|
{
"objectId": integer,
"border": {
object (
|
字段 | |
---|---|
objectId
|
要更新的嵌入对象的 ID。 |
border
|
应用于嵌入式对象的边框。 |
fields
|
应更新的字段。必须至少指定一个字段。根隐式意味着 |
AddSlicerRequest
向电子表格中的工作表添加截剪器。
JSON 表示法 |
---|
{
"slicer": {
object (
|
字段 | |
---|---|
slicer
|
应添加到电子表格的截剪器,包括应将其放置的位置。 |
UpdateSlicerSpecRequest
更新截剪器的规范。(此操作不会移动截剪器或调整截图的大小。如需移动截剪器或调整其大小,请使用 UpdateEmbeddedObjectPositionRequest
。
JSON 表示法 |
---|
{
"slicerId": integer,
"spec": {
object (
|
字段 | |
---|---|
slicerId
|
要更新的截剪器的 ID。 |
spec
|
应用于截剪器的规范。 |
fields
|
应更新的字段。必须至少指定一个字段。根隐式意味着 |
AddDataSourceRequest
添加数据源。成功添加数据源后,系统会创建关联的 DATA_SOURCE
表格,并触发执行来刷新工作表,以从数据源读取数据。该请求需要额外的 bigquery.readonly
OAuth 范围。
JSON 表示法 |
---|
{
"dataSource": {
object (
|
字段 | |
---|---|
dataSource
|
要添加的数据源。 |
UpdateDataSourceRequest
更新数据源。数据源成功更新后,系统会触发执行来刷新关联的 DATA_SOURCE
表,以从更新后的数据源读取数据。该请求需要额外的 bigquery.readonly
OAuth 范围。
JSON 表示法 |
---|
{
"dataSource": {
object (
|
字段 | |
---|---|
dataSource
|
要更新的数据源。 |
fields
|
应更新的字段。必须至少指定一个字段。根隐式意味着 |
DeleteDataSourceRequest
删除数据源。该请求还会删除关联的数据源工作表,并解除关联所有关联的数据源对象。
JSON 表示法 |
---|
{ "dataSourceId": string } |
字段 | |
---|---|
dataSourceId
|
要删除的数据源的 ID。 |
RefreshDataSourceRequest
使用指定的引用刷新电子表格中的一个或多个数据源对象。该请求需要额外的 bigquery.readonly
OAuth 范围。
如果在同一批请求中有多个引用同一数据源对象的刷新请求,那么系统只会处理最后一个刷新请求,并且所有相应的请求都会有相同的响应。
JSON 表示法 |
---|
{ "force": boolean, // Union field |
字段 | |
---|---|
force
|
刷新数据源对象(无论当前状态如何)。如果未设置,并且引用的数据源对象处于错误状态,则刷新将立即失败。 |
联合字段 target 。指定要刷新的内容。
target 只能是下列其中一项:
|
|
references
|
对要刷新的数据源对象的引用。 |
dataSourceId
|
引用 |
isAll
|
刷新电子表格中的所有现有数据源对象。 |
DataSourceObjectReferences
对数据源对象的引用列表。
JSON 表示法 |
---|
{
"references": [
{
object (
|
字段 | |
---|---|
references[]
|
引用。 |
DataSourceObjectReference
对数据源对象的引用。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 value 。引用类型。
value 只能是下列其中一项:
|
|
sheetId
|
对 |
chartId
|
对数据源图表的引用。 |
dataSourceTableAnchorCell
|
对锚定在单元格内的 |
dataSourcePivotTableAnchorCell
|
对锚定在单元格中的数据源 |
dataSourceFormulaCell
|
对包含 |