此页面由 Cloud Translation API 翻译。

Class DataSourceChart

访问和修改现有数据源图表。

该类仅适用于连接到数据库的数据。

方法	返回类型	简介
`forceRefreshData()`	`DataSourceChart`	刷新此对象的数据，而不考虑当前状态。
`getDataSource()`	`DataSource`	获取对象关联的数据源。
`getStatus()`	`DataExecutionStatus`	获取对象的数据执行状态。
`refreshData()`	`DataSourceChart`	刷新对象的数据。
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	等待当前执行完成，在提供的秒数后超时。

详细文档

刷新此对象的数据，而不考虑当前状态。如需了解详情，请参阅 refreshData()。

如果数据源类型未启用，则会抛出异常。使用 SpreadsheetApp#enable...Execution() 方法可针对特定数据源类型启用数据执行。

DataSourceChart - 数据对象。

使用此方法的脚本需要获得以下一个或多个范围的授权：

获取对象关联的数据源。

DataSource - 数据源。

使用此方法的脚本需要获得以下一个或多个范围的授权：

获取对象的数据执行状态。

DataExecutionStatus - 数据执行状态。

使用此方法的脚本需要获得以下一个或多个范围的授权：

刷新对象的数据。

如果当前处于 error 状态，则会抛出异常。使用 DataSource#updateSpec() 更新规范。此方法优于 forceRefreshData()，可防止对数据源进行意外修改。

如果数据源类型未启用，则会抛出异常。使用 SpreadsheetApp#enable...Execution() 方法可针对特定数据源类型启用数据执行。

DataSourceChart - 数据对象。

使用此方法的脚本需要获得以下一个或多个范围的授权：

等待当前执行完成，在提供的秒数后超时。如果在超时时执行未完成，但并未取消数据执行，则会抛出异常。

名称	类型	说明
`timeoutInSeconds`	`Integer`	等待数据执行的时间，以秒为单位。最长为 300 秒。

DataExecutionStatus - 数据执行状态。

使用此方法的脚本需要获得以下一个或多个范围的授权：