REST Resource: spreadsheets

资源:电子表格

表示电子表格的资源。

JSON 表示法
{
  "spreadsheetId": string,
  "properties": {
    object (SpreadsheetProperties)
  },
  "sheets": [
    {
      object (Sheet)
    }
  ],
  "namedRanges": [
    {
      object (NamedRange)
    }
  ],
  "spreadsheetUrl": string,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSources": [
    {
      object (DataSource)
    }
  ],
  "dataSourceSchedules": [
    {
      object (DataSourceRefreshSchedule)
    }
  ]
}
字段
spreadsheetId

string

电子表格的 ID。此字段为只读字段。

properties

object (SpreadsheetProperties)

电子表格的整体属性。

sheets[]

object (Sheet)

电子表格中的工作表。

namedRanges[]

object (NamedRange)

电子表格中定义的命名范围。

spreadsheetUrl

string

电子表格的网址。此字段为只读字段。

developerMetadata[]

object (DeveloperMetadata)

与电子表格关联的开发者元数据。

dataSources[]

object (DataSource)

与电子表格关联的外部数据源的列表。

dataSourceSchedules[]

object (DataSourceRefreshSchedule)

仅限输出。数据源刷新时间表的列表。

SpreadsheetProperties

电子表格的属性。

JSON 表示法
{
  "title": string,
  "locale": string,
  "autoRecalc": enum (RecalculationInterval),
  "timeZone": string,
  "defaultFormat": {
    object (CellFormat)
  },
  "iterativeCalculationSettings": {
    object (IterativeCalculationSettings)
  },
  "spreadsheetTheme": {
    object (SpreadsheetTheme)
  },
  "importFunctionsExternalUrlAccessAllowed": boolean
}
字段
title

string

电子表格的标题。

locale

string

电子表格的语言区域,采用以下某种格式:

  • ISO 639-1 语言代码,例如 en

  • ISO 639-2 语言代码(例如 fil,前提是不存在 639-1 代码)

  • ISO 语言代码和国家/地区代码的组合,例如 en_US

注意:更新此字段时,并非所有语言区域/语言都受支持。

autoRecalc

enum (RecalculationInterval)

在重新计算易失性函数之前等待的时间。

timeZone

string

电子表格的时区,采用 CLDR 格式,例如 America/New_York。如果系统无法识别时区,则可能是自定义时区,例如 GMT-07:00

defaultFormat

object (CellFormat)

电子表格中所有单元格的默认格式。如果单元格的格式与此默认格式相同,则不会设置 CellData.effectiveFormat。此字段为只读字段。

iterativeCalculationSettings

object (IterativeCalculationSettings)

决定是否通过迭代计算解决循环引用以及如何解决循环引用。缺少此字段意味着循环引用会导致计算错误。

spreadsheetTheme

object (SpreadsheetTheme)

应用于电子表格的主题。

importFunctionsExternalUrlAccessAllowed

boolean

是否允许图片和导入函数访问外部网址。值为 true 时只读。如果为 false,则可以设置为 true。如果管理员已启用许可名单功能,系统会绕过此值,并始终返回 true。

RecalculationInterval

枚举可能的重新计算间隔选项。

枚举
RECALCULATION_INTERVAL_UNSPECIFIED 默认值。请勿使用此值。
ON_CHANGE 易变函数会在每次更改时更新。
MINUTE 易变函数会每分钟随每次更改更新。
HOUR 易变函数会在每次发生更改时以及每小时更新一次。

IterativeCalculationSettings

用于控制如何通过迭代计算来解析循环依赖项的设置。

JSON 表示法
{
  "maxIterations": integer,
  "convergenceThreshold": number
}
字段
maxIterations

integer

启用迭代计算后,可执行的计算轮次次数上限。

convergenceThreshold

number

启用迭代计算后,如果连续结果的差值低于此阈值,计算轮次将停止。

SpreadsheetTheme

表示电子表格主题

JSON 表示法
{
  "primaryFontFamily": string,
  "themeColors": [
    {
      object (ThemeColorPair)
    }
  ]
}
字段
primaryFontFamily

string

主要字体系列的名称。

themeColors[]

object (ThemeColorPair)

电子表格主题颜色对。如需更新,您必须提供所有主题颜色对。

ThemeColorPair

将电子表格主题颜色类型映射到其代表的具体颜色的对。

JSON 表示法
{
  "colorType": enum (ThemeColorType),
  "color": {
    object (ColorStyle)
  }
}
字段
colorType

enum (ThemeColorType)

电子表格主题颜色的类型。

color

object (ColorStyle)

与主题颜色类型对应的具体颜色。

NamedRange

命名的范围。

JSON 表示法
{
  "namedRangeId": string,
  "name": string,
  "range": {
    object (GridRange)
  }
}
字段
namedRangeId

string

命名范围的 ID。

name

string

命名范围的名称。

range

object (GridRange)

此值所代表的范围。

DataSource

电子表格中外部数据源的相关信息。

JSON 表示法
{
  "dataSourceId": string,
  "spec": {
    object (DataSourceSpec)
  },
  "calculatedColumns": [
    {
      object (DataSourceColumn)
    }
  ],
  "sheetId": integer
}
字段
dataSourceId

string

用于标识数据源的电子表格级唯一 ID。示例:1080547365。

spec

object (DataSourceSpec)

与此电子表格关联的数据源的 DataSourceSpec

calculatedColumns[]

object (DataSourceColumn)

数据源中的所有计算列。

sheetId

integer

与数据源关联的 Sheet 的 ID。此字段一经设置便无法更改。

创建数据源时,系统还会创建关联的 DATA_SOURCE 工作表;如果未指定此字段,系统会随机生成所创建工作表的 ID。

DataSourceSpec

此属性指定了数据源的详细信息。例如,对于 BigQuery,此字段会指定有关 BigQuery 来源的信息。

JSON 表示法
{
  "parameters": [
    {
      object (DataSourceParameter)
    }
  ],

  // Union field spec can be only one of the following:
  "bigQuery": {
    object (BigQueryDataSourceSpec)
  },
  "looker": {
    object (LookerDataSourceSpec)
  }
  // End of list of possible types for union field spec.
}
字段
parameters[]

object (DataSourceParameter)

数据源的参数,在查询数据源时使用。

联合字段 spec。每种数据源类型的实际规范。spec 只能是下列其中一项:
bigQuery

object (BigQueryDataSourceSpec)

一个 BigQueryDataSourceSpec

looker

object (LookerDataSourceSpec)

[LookerDatasourceSpec][]。

BigQueryDataSourceSpec

与工作表相关联的 BigQuery 数据源的规范。

JSON 表示法
{
  "projectId": string,

  // Union field spec can be only one of the following:
  "querySpec": {
    object (BigQueryQuerySpec)
  },
  "tableSpec": {
    object (BigQueryTableSpec)
  }
  // End of list of possible types for union field spec.
}
字段
projectId

string

已启用 BigQuery 且关联了结算账号的 Google Cloud 项目的 ID。对于对数据源执行的任何查询,项目都会产生费用。

联合字段 spec。实际规范。spec 只能是下列其中一项:
querySpec

object (BigQueryQuerySpec)

一个 BigQueryQuerySpec

tableSpec

object (BigQueryTableSpec)

一个 BigQueryTableSpec

BigQueryQuerySpec

指定自定义 BigQuery 查询。

JSON 表示法
{
  "rawQuery": string
}
字段
rawQuery

string

原始查询字符串。

BigQueryTableSpec

指定 BigQuery 表定义。仅允许使用原生表格

JSON 表示法
{
  "tableProjectId": string,
  "tableId": string,
  "datasetId": string
}
字段
tableProjectId

string

表所属的 BigQuery 项目的 ID。如果未指定,则假定为 projectId

tableId

string

BigQuery 表 ID。

datasetId

string

BigQuery 数据集 ID。

LookerDataSourceSpec

Looker 数据源的规范。

JSON 表示法
{
  "instanceUri": string,
  "model": string,
  "explore": string
}
字段
instanceUri

string

Looker 实例网址。

model

string

Looker 模型的名称。

explore

string

Looker 模型探索的名称。

DataSourceParameter

数据源查询中的参数。参数可让用户将电子表格中的值传入查询中。

JSON 表示法
{

  // Union field identifier can be only one of the following:
  "name": string
  // End of list of possible types for union field identifier.

  // Union field value can be only one of the following:
  "namedRangeId": string,
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field value.
}
字段
联合字段 identifier。参数标识符。identifier 只能是下列其中一项:
name

string

具名参数。必须是支持该 DataSource 的有效标识符。例如,BigQuery 标识符

联合字段 value。参数值。value 只能是下列其中一项:
namedRangeId

string

NamedRange 的 ID。其尺寸必须为 1x1。

range

object (GridRange)

包含参数值的范围。其尺寸必须为 1x1。

DataSourceRefreshSchedule

刷新数据源的计划。

电子表格中的数据源会在一定时间间隔内刷新。您可以点击表格编辑器中的“计划刷新”按钮来指定开始时间,但时间间隔固定为 4 小时。例如,如果您指定的开始时间为上午 8 点,则刷新将在每天上午 8 点到中午 12 点之间进行。

JSON 表示法
{
  "enabled": boolean,
  "refreshScope": enum (DataSourceRefreshScope),
  "nextRun": {
    object (Interval)
  },

  // Union field schedule_config can be only one of the following:
  "dailySchedule": {
    object (DataSourceRefreshDailySchedule)
  },
  "weeklySchedule": {
    object (DataSourceRefreshWeeklySchedule)
  },
  "monthlySchedule": {
    object (DataSourceRefreshMonthlySchedule)
  }
  // End of list of possible types for union field schedule_config.
}
字段
enabled

boolean

如果已启用刷新时间表,则为 true,否则为 false。

refreshScope

enum (DataSourceRefreshScope)

刷新的范围。必须为 ALL_DATA_SOURCES

nextRun

object (Interval)

仅限输出。下次运行的时间间隔。

联合字段 schedule_config。时间表配置“schedule_config”只能是下列其中一项:
dailySchedule

object (DataSourceRefreshDailySchedule)

每日刷新时间表。

weeklySchedule

object (DataSourceRefreshWeeklySchedule)

每周刷新时间表。

monthlySchedule

object (DataSourceRefreshMonthlySchedule)

每月刷新时间表。

DataSourceRefreshScope

数据源刷新范围。

枚举
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED 默认值,请勿使用。
ALL_DATA_SOURCES 刷新电子表格中的所有数据源及其关联的数据源对象。

DataSourceRefreshDailySchedule

在指定时间间隔内每天刷新数据的时间表。

JSON 表示法
{
  "startTime": {
    object (TimeOfDay)
  }
}
字段
startTime

object (TimeOfDay)

安排数据源刷新的时间间隔的开始时间。仅使用了 hours 部分。时间间隔大小默认为 Google 表格编辑器中的大小。

TimeOfDay

表示一天中的某个时间。日期和时区不重要,或在别处指定。API 可以选择允许闰秒。相关类型为 google.type.Dategoogle.protobuf.Timestamp

JSON 表示法
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
字段
hours

integer

一天中的小时(采用 24 小时制)。值应为 0 到 23。对于业务结束时间等场景,API 可以选择允许“24:00:00”一值。

minutes

integer

一天中某小时的分钟数。值必须是介于 0 和 59 之间的数字。

seconds

integer

时间的秒数部分。通常必须是介于 0 和 59 之间的数字。如果 API 允许闰秒,则 API 可以允许 60 一值。

nanos

integer

秒数的小数部分(以纳秒为单位)。值必须是介于 0 和 999999999 之间的数字。

DataSourceRefreshWeeklySchedule

每周时间表,用于在给定时间间隔内的特定日期刷新数据。

JSON 表示法
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
字段
startTime

object (TimeOfDay)

安排数据源刷新的时间间隔的开始时间。仅使用 hours 部分。时间间隔大小在表格编辑器中默认采用该大小。

daysOfWeek[]

enum (DayOfWeek)

要刷新的星期几。必须指定至少一天。

DayOfWeek

表示星期几。

枚举
DAY_OF_WEEK_UNSPECIFIED 未指定星期几。
MONDAY 星期一
TUESDAY 星期二
WEDNESDAY 星期三
THURSDAY 星期四
FRIDAY 星期五
SATURDAY 星期六
SUNDAY 星期日

DataSourceRefreshMonthlySchedule

按月安排,在一个月中的特定几天,在指定时间间隔内刷新数据。

JSON 表示法
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfMonth": [
    integer
  ]
}
字段
startTime

object (TimeOfDay)

安排数据源刷新的时间间隔的开始时间。仅使用了 hours 部分。时间间隔大小在表格编辑器中默认采用该大小。

daysOfMonth[]

integer

要刷新的天数。仅支持 1-28,其对应的值介于 1 到 28 之间。必须指定至少一天。

间隔时间

表示时间间隔,编码为时间戳开始(含)和时间戳结束(不含)。

开始时间必须小于或等于结束时间。如果开始时间等于结束时间,则间隔时间为空(不匹配任何时间)。如果同时未指定开始时间和结束时间,则该时间间隔与任何时间都匹配。

JSON 表示法
{
  "startTime": string,
  "endTime": string
}
字段
startTime

string (Timestamp format)

可选。间隔的开始值(含)。

如果指定,则与此间隔匹配的时间戳必须相同或晚于开始时间。

endTime

string (Timestamp format)

可选。间隔结束(不含)。

如果已指定,则与此间隔时间匹配的时间戳必须在结束时间之前。

方法

batchUpdate

将一个或多个更新应用于电子表格。

create

创建电子表格,并返回新创建的电子表格。

get

返回具有指定 ID 的电子表格。

getByDataFilter

返回具有指定 ID 的电子表格。