Responses

回答

更新的单个响应。

JSON 表示法
{

  "addNamedRange": {
    object (AddNamedRangeResponse)
  },
  "addSheet": {
    object (AddSheetResponse)
  },
  "addFilterView": {
    object (AddFilterViewResponse)
  },
  "duplicateFilterView": {
    object (DuplicateFilterViewResponse)
  },
  "duplicateSheet": {
    object (DuplicateSheetResponse)
  },
  "findReplace": {
    object (FindReplaceResponse)
  },
  "updateEmbeddedObjectPosition": {
    object (UpdateEmbeddedObjectPositionResponse)
  },
  "updateConditionalFormatRule": {
    object (UpdateConditionalFormatRuleResponse)
  },
  "deleteConditionalFormatRule": {
    object (DeleteConditionalFormatRuleResponse)
  },
  "addProtectedRange": {
    object (AddProtectedRangeResponse)
  },
  "addChart": {
    object (AddChartResponse)
  },
  "addBanding": {
    object (AddBandingResponse)
  },
  "createDeveloperMetadata": {
    object (CreateDeveloperMetadataResponse)
  },
  "updateDeveloperMetadata": {
    object (UpdateDeveloperMetadataResponse)
  },
  "deleteDeveloperMetadata": {
    object (DeleteDeveloperMetadataResponse)
  },
  "addDimensionGroup": {
    object (AddDimensionGroupResponse)
  },
  "deleteDimensionGroup": {
    object (DeleteDimensionGroupResponse)
  },
  "trimWhitespace": {
    object (TrimWhitespaceResponse)
  },
  "deleteDuplicates": {
    object (DeleteDuplicatesResponse)
  },
  "addSlicer": {
    object (AddSlicerResponse)
  },
  "addDataSource": {
    object (AddDataSourceResponse)
  },
  "updateDataSource": {
    object (UpdateDataSourceResponse)
  },
  "refreshDataSource": {
    object (RefreshDataSourceResponse)
  },
  "cancelDataSourceRefresh": {
    object (CancelDataSourceRefreshResponse)
  },
  "addTable": {
    object (AddTableResponse)
  }
}
字段
联合字段 kind。回复的类型。如果请求没有响应,则可能未设置任何字段。 kind 只能是下列其中一项:
addNamedRange

object (AddNamedRangeResponse)

添加命名的范围的回复。

addSheet

object (AddSheetResponse)

添加工作表后收到的回复。

addFilterView

object (AddFilterViewResponse)

添加过滤视图后的回复。

duplicateFilterView

object (DuplicateFilterViewResponse)

复制过滤视图后得到的回复。

duplicateSheet

object (DuplicateSheetResponse)

复制工作表的回复。

findReplace

object (FindReplaceResponse)

执行查找/替换操作后得到的回复。

updateEmbeddedObjectPosition

object (UpdateEmbeddedObjectPositionResponse)

更新嵌入式对象位置的回复。

updateConditionalFormatRule

object (UpdateConditionalFormatRuleResponse)

更新条件格式规则后的回复。

deleteConditionalFormatRule

object (DeleteConditionalFormatRuleResponse)

删除条件格式规则的回复。

addProtectedRange

object (AddProtectedRangeResponse)

添加受保护的范围后的回复。

addChart

object (AddChartResponse)

添加图表后的回复。

addBanding

object (AddBandingResponse)

添加条带范围后的回复。

createDeveloperMetadata

object (CreateDeveloperMetadataResponse)

创建开发者元数据条目后的回复。

updateDeveloperMetadata

object (UpdateDeveloperMetadataResponse)

更新开发者元数据条目后的回复。

deleteDeveloperMetadata

object (DeleteDeveloperMetadataResponse)

删除开发者元数据条目后收到的回复。

addDimensionGroup

object (AddDimensionGroupResponse)

添加维度组后的回复。

deleteDimensionGroup

object (DeleteDimensionGroupResponse)

删除维度组的回复。

trimWhitespace

object (TrimWhitespaceResponse)

修剪掉空白字符后的回复。

deleteDuplicates

object (DeleteDuplicatesResponse)

移除包含重复值的行后得到的回复。

addSlicer

object (AddSlicerResponse)

添加截剪器的回复。

addDataSource

object (AddDataSourceResponse)

添加数据源后的回复。

updateDataSource

object (UpdateDataSourceResponse)

更新数据源后的回复。

refreshDataSource

object (RefreshDataSourceResponse)

刷新数据源对象的回复。

cancelDataSourceRefresh

object (CancelDataSourceRefreshResponse)

取消数据源对象刷新操作后收到的回复。

addTable

object (AddTableResponse)

添加表格后的回复。

DataSourceObjectReference

对数据源对象的引用。

JSON 表示法
{

  "sheetId": string,
  "chartId": integer,
  "dataSourceTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourcePivotTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourceFormulaCell": {
    object (GridCoordinate)
  }
}
字段
联合字段 value。引用类型。 value 只能是下列其中一项:
sheetId

string

DATA_SOURCE 工作表的引用。

chartId

integer

对数据源图表的引用。

dataSourceTableAnchorCell

object (GridCoordinate)

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

dataSourcePivotTableAnchorCell

object (GridCoordinate)

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

dataSourceFormulaCell

object (GridCoordinate)

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

AddNamedRangeResponse

添加命名的范围的结果。

JSON 表示法
{
  "namedRange": {
    object (NamedRange)
  }
}
字段
namedRange

object (NamedRange)

要添加的命名范围。

AddSheetResponse

添加工作表的结果。

JSON 表示法
{
  "properties": {
    object (SheetProperties)
  }
}
字段
properties

object (SheetProperties)

新添加的工作表的属性。

AddFilterViewResponse

添加过滤视图的结果。

JSON 表示法
{
  "filter": {
    object (FilterView)
  }
}
字段
filter

object (FilterView)

新添加的过滤视图。

DuplicateFilterViewResponse

复制过滤视图的结果。

JSON 表示法
{
  "filter": {
    object (FilterView)
  }
}
字段
filter

object (FilterView)

新创建的过滤条件。

DuplicateSheetResponse

复制工作表的结果。

JSON 表示法
{
  "properties": {
    object (SheetProperties)
  }
}
字段
properties

object (SheetProperties)

重复工作表的属性。

FindReplaceResponse

查找/替换的结果。

JSON 表示法
{
  "valuesChanged": integer,
  "formulasChanged": integer,
  "rowsChanged": integer,
  "sheetsChanged": integer,
  "occurrencesChanged": integer
}
字段
valuesChanged

integer

非公式单元格的数量发生了变化。

formulasChanged

integer

公式单元格的数量发生了变化。

rowsChanged

integer

更改的行数。

sheetsChanged

integer

工作表的数量发生了变化。

occurrencesChanged

integer

出现次数(可能在一个单元格内多次出现)发生了变化。例如,如果要在 "Google Sheets" 中将 "e" 替换为 "o",则结果为 "3",因为 "Google Sheets" -> "Googlo Shoots"

UpdateEmbeddedObjectPositionResponse

更新嵌入式对象位置的结果。

JSON 表示法
{
  "position": {
    object (EmbeddedObjectPosition)
  }
}
字段
position

object (EmbeddedObjectPosition)

嵌入对象的新位置。

UpdateConditionalFormatRuleResponse

更新条件格式规则的结果。

JSON 表示法
{
  "newRule": {
    object (ConditionalFormatRule)
  },
  "newIndex": integer,

  "oldRule": {
    object (ConditionalFormatRule)
  },
  "oldIndex": integer
}
字段
newRule

object (ConditionalFormatRule)

取代旧规则的新规则(如果取代)或移动的规则(如果移动)

newIndex

integer

新规则的索引。

联合字段 old_info。有关前一条规则的信息。 old_info 只能是下列其中一项:
oldRule

object (ConditionalFormatRule)

旧(已删除)规则。如果规则已移动,则不会设置(因为与 newRule 相同)。

oldIndex

integer

相应规则的旧索引。如果规则被替换(因为与 newIndex 相同),则不设置。

DeleteConditionalFormatRuleResponse

删除条件格式规则的结果。

JSON 表示法
{
  "rule": {
    object (ConditionalFormatRule)
  }
}
字段
rule

object (ConditionalFormatRule)

已删除的规则。

AddProtectedRangeResponse

添加新受保护范围的结果。

JSON 表示法
{
  "protectedRange": {
    object (ProtectedRange)
  }
}
字段
protectedRange

object (ProtectedRange)

新添加的受保护范围。

AddChartResponse

将图表添加到电子表格后的效果。

JSON 表示法
{
  "chart": {
    object (EmbeddedChart)
  }
}
字段
chart

object (EmbeddedChart)

新添加的图表。

AddBandingResponse

添加带状范围后的结果。

JSON 表示法
{
  "bandedRange": {
    object (BandedRange)
  }
}
字段
bandedRange

object (BandedRange)

添加的条带状范围。

CreateDeveloperMetadataResponse

创建开发者元数据的响应。

JSON 表示法
{
  "developerMetadata": {
    object (DeveloperMetadata)
  }
}
字段
developerMetadata

object (DeveloperMetadata)

已创建的开发者元数据。

UpdateDeveloperMetadataResponse

更新开发者元数据后的响应。

JSON 表示法
{
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ]
}
字段
developerMetadata[]

object (DeveloperMetadata)

更新后的开发者元数据。

DeleteDeveloperMetadataResponse

删除开发者元数据后的响应。

JSON 表示法
{
  "deletedDeveloperMetadata": [
    {
      object (DeveloperMetadata)
    }
  ]
}
字段
deletedDeveloperMetadata[]

object (DeveloperMetadata)

已删除的元数据。

AddDimensionGroupResponse

添加群组的结果。

JSON 表示法
{
  "dimensionGroups": [
    {
      object (DimensionGroup)
    }
  ]
}
字段
dimensionGroups[]

object (DimensionGroup)

将某个群组添加到相应维度后,该维度的所有群组。

DeleteDimensionGroupResponse

删除群组的结果。

JSON 表示法
{
  "dimensionGroups": [
    {
      object (DimensionGroup)
    }
  ]
}
字段
dimensionGroups[]

object (DimensionGroup)

从维度中删除某个群组后,该维度的所有群组。

TrimWhitespaceResponse

剪除单元格中的空格后的结果。

JSON 表示法
{
  "cellsChangedCount": integer
}
字段
cellsChangedCount

integer

已移除空格的单元格数量。

DeleteDuplicatesResponse

移除某个范围内的重复项后得到的结果。

JSON 表示法
{
  "duplicatesRemovedCount": integer
}
字段
duplicatesRemovedCount

integer

已移除的重复行数。

AddSlicerResponse

向电子表格添加截剪器的结果。

JSON 表示法
{
  "slicer": {
    object (Slicer)
  }
}
字段
slicer

object (Slicer)

新添加的切片器。

AddDataSourceResponse

添加数据源的结果。

JSON 表示法
{
  "dataSource": {
    object (DataSource)
  },
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
字段
dataSource

object (DataSource)

已创建的数据源。

dataExecutionStatus

object (DataExecutionStatus)

数据执行状态。

UpdateDataSourceResponse

更新数据源的响应。

JSON 表示法
{
  "dataSource": {
    object (DataSource)
  },
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
字段
dataSource

object (DataSource)

更新后的数据源。

dataExecutionStatus

object (DataExecutionStatus)

数据执行状态。

RefreshDataSourceResponse

刷新一个或多个数据源对象后得到的响应。

JSON 表示法
{
  "statuses": [
    {
      object (RefreshDataSourceObjectExecutionStatus)
    }
  ]
}
字段
statuses[]

object (RefreshDataSourceObjectExecutionStatus)

请求中指定的数据源对象引用的所有刷新状态。如果指定了 isAll,则该字段仅包含处于失败状态的资源。

RefreshDataSourceObjectExecutionStatus

刷新一个数据源对象的执行状态。

JSON 表示法
{
  "reference": {
    object (DataSourceObjectReference)
  },
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
字段
reference

object (DataSourceObjectReference)

对正在刷新的数据源对象的引用。

dataExecutionStatus

object (DataExecutionStatus)

数据执行状态。

CancelDataSourceRefreshResponse

取消一个或多个数据源对象刷新操作的响应。

JSON 表示法
{
  "statuses": [
    {
      object (CancelDataSourceRefreshStatus)
    }
  ]
}
字段
statuses[]

object (CancelDataSourceRefreshStatus)

相应请求中指定的所有数据源对象的刷新取消状态。如果指定了 isAll,则该字段仅包含处于失败状态的作业。在同一 batchUpdate 中,也不允许刷新和取消刷新同一数据源对象。

CancelDataSourceRefreshStatus

取消单个数据源对象刷新的状态。

JSON 表示法
{
  "reference": {
    object (DataSourceObjectReference)
  },
  "refreshCancellationStatus": {
    object (RefreshCancellationStatus)
  }
}
字段
reference

object (DataSourceObjectReference)

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

refreshCancellationStatus

object (RefreshCancellationStatus)

取消状态。

RefreshCancellationStatus

刷新取消的状态。

您可以发送 cancel request 来明确取消一个或多个数据源对象刷新。

JSON 表示法
{
  "state": enum (RefreshCancellationState),
  "errorCode": enum (RefreshCancellationErrorCode)
}
字段
state

enum (RefreshCancellationState)

用于取消 Google 表格中的刷新的调用的状态。

errorCode

enum (RefreshCancellationErrorCode)

错误代码。

RefreshCancellationState

刷新取消状态的枚举。

枚举
REFRESH_CANCELLATION_STATE_UNSPECIFIED 默认值,请勿使用。
CANCEL_SUCCEEDED 对 Google 表格发出的取消刷新 API 调用已成功。这并不意味着取消已成功完成,而是表示已成功发出调用。
CANCEL_FAILED 调用 Sheets 以取消刷新失败。

RefreshCancellationErrorCode

刷新取消错误代码的枚举。

枚举
REFRESH_CANCELLATION_ERROR_CODE_UNSPECIFIED 默认值,请勿使用。
EXECUTION_NOT_FOUND 在查询引擎或 Google 表格中未找到要取消的执行。
CANCEL_PERMISSION_DENIED 用户无权取消查询。
QUERY_EXECUTION_COMPLETED 查询执行已完成,因此无法取消。
CONCURRENT_CANCELLATION 系统已在处理另一项取消请求。
CANCEL_OTHER_ERROR 所有其他错误。

AddTableResponse

添加表格后的结果。

JSON 表示法
{
  "table": {
    object (Table)
  }
}
字段
table

object (Table)

仅限输出。添加的表格。