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

  • 如果沒有 639-1 代碼，請提供 ISO 639-2 語言代碼，例如 fil

  • 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。

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)
  }
  // End of list of possible types for union field spec.
}
欄位
parameters[]

object (DataSourceParameter)

查詢資料來源時使用的資料來源參數。
聯集欄位 spec。每種資料來源類型的實際規格。spec 只能是下列其中一項：
bigQuery

object (BigQueryDataSourceSpec)

BigQueryDataSourceSpec。

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。

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。參數 ID。identifier 只能是下列其中一項：
name

string

已命名參數。必須是支援 DataSource 的合法 ID。例如「BigQuery ID」。
聯集欄位 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 部分。在試算表編輯器中，時間間隔大小預設為這個值。

TimeOfDay

代表一天中的時間。日期和時區並不需要指定，或是在其他位置上指定。API 可選擇允許閏秒。相關類型為 google.type.Date 和 google.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 允許閏秒，則可允許值為 60。
nanos

integer

秒數的小數，以奈秒為單位。值必須介於 0 到 999,999,999 之間。

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 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 的試算表。