- 資源:試算表
- SpreadsheetProperties
- RecalculationInterval
- CellFormat
- NumberFormat
- NumberFormatType
- 顏色
- ColorStyle
- ThemeColorType
- 框線
- 邊框
- 樣式
- 邊框間距
- HorizontalAlign
- VerticalAlign
- WrapStrategy
- TextDirection
- TextFormat
- 連結
- HyperlinkDisplayType
- TextRotation
- IterativeCalculationSettings
- SpreadsheetTheme
- ThemeColorPair
- 試算表
- SheetProperties
- SheetType
- GridProperties
- DataSourceSheetProperties
- DataSourceColumn
- DataSourceColumnReference
- DataExecutionStatus
- DataExecutionState
- DataExecutionErrorCode
- GridData
- RowData
- CellData
- ExtendedValue
- ErrorValue
- ErrorType
- TextFormatRun
- DataValidationRule
- BooleanCondition
- ConditionType
- ConditionValue
- RelativeDate
- PivotTable
- GridRange
- PivotGroup
- PivotGroupValueMetadata
- SortOrder
- PivotGroupSortValueBucket
- PivotGroupRule
- ManualRule
- ManualRuleGroup
- HistogramRule
- DateTimeRule
- DateTimeRuleType
- PivotGroupLimit
- PivotFilterCriteria
- PivotFilterSpec
- PivotValue
- PivotValueSummarizeFunction
- PivotValueCalculatedDisplayType
- PivotValueLayout
- DataSourceTable
- DataSourceTableColumnSelectionType
- FilterSpec
- FilterCriteria
- SortSpec
- DataSourceFormula
- DimensionProperties
- ConditionalFormatRule
- BooleanRule
- GradientRule
- InterpolationPoint
- InterpolationPointType
- FilterView
- ProtectedRange
- 編輯者
- BasicFilter
- EmbeddedChart
- ChartSpec
- TextPosition
- DataSourceChartProperties
- BasicChartSpec
- BasicChartType
- BasicChartLegendPosition
- BasicChartAxis
- BasicChartAxisPosition
- ChartAxisViewWindowOptions
- ViewWindowMode
- BasicChartDomain
- ChartData
- ChartSourceRange
- ChartGroupRule
- ChartDateTimeRule
- ChartDateTimeRuleType
- ChartHistogramRule
- ChartAggregateType
- BasicChartSeries
- LineStyle
- LineDashType
- DataLabel
- DataLabelType
- DataLabelPlacement
- PointStyle
- PointShape
- BasicSeriesDataPointStyleOverride
- BasicChartStackedType
- BasicChartCompareMode
- PieChartSpec
- PieChartLegendPosition
- BubbleChartSpec
- BubbleChartLegendPosition
- CandlestickChartSpec
- CandlestickDomain
- CandlestickData
- CandlestickSeries
- OrgChartSpec
- OrgChartNodeSize
- HistogramChartSpec
- HistogramSeries
- HistogramChartLegendPosition
- WaterfallChartSpec
- WaterfallChartDomain
- WaterfallChartSeries
- WaterfallChartColumnStyle
- WaterfallChartCustomSubtotal
- WaterfallChartStackedType
- TreemapChartSpec
- TreemapChartColorScale
- ScorecardChartSpec
- KeyValueFormat
- BaselineValueFormat
- ComparisonType
- ChartNumberFormatSource
- ChartCustomNumberFormatOptions
- ChartHiddenDimensionStrategy
- EmbeddedObjectPosition
- OverlayPosition
- GridCoordinate
- EmbeddedObjectBorder
- BandedRange
- BandingProperties
- DimensionGroup
- Slicer
- SlicerSpec
- NamedRange
- DataSource
- DataSourceSpec
- BigQueryDataSourceSpec
- BigQueryQuerySpec
- BigQueryTableSpec
- LookerDataSourceSpec
- DataSourceParameter
- DataSourceRefreshSchedule
- DataSourceRefreshScope
- DataSourceRefreshDailySchedule
- TimeOfDay
- DataSourceRefreshWeeklySchedule
- DayOfWeek
- DataSourceRefreshMonthlySchedule
- 間隔
- 方法
資源:試算表
表示試算表的資源。
JSON 表示法 |
---|
{ "spreadsheetId": string, "properties": { object ( |
欄位 | |
---|---|
spreadsheetId |
試算表的 ID。這是唯讀欄位。 |
properties |
試算表的整體屬性。 |
sheets[] |
試算表內的工作表。 |
namedRanges[] |
在試算表中定義的已命名範圍。 |
spreadsheetUrl |
試算表的網址。這是唯讀欄位。 |
developerMetadata[] |
與試算表相關聯的開發人員中繼資料。 |
dataSources[] |
與試算表連結的外部資料來源清單。 |
dataSourceSchedules[] |
僅供輸出。資料來源重新整理時程清單。 |
SpreadsheetProperties
試算表的屬性。
JSON 表示法 |
---|
{ "title": string, "locale": string, "autoRecalc": enum ( |
欄位 | |
---|---|
title |
試算表的標題。 |
locale |
試算表的語言代碼,格式如下:
注意:更新此欄位時,系統僅支援部分語言/語言代碼。 |
autoRecalc |
等待重新計算揮發性函式所需的時間。 |
timeZone |
試算表的時區,格式為 CLDR 格式,例如 |
defaultFormat |
試算表中所有儲存格的預設格式。如果儲存格格式與這個預設格式相同,系統就不會設定 |
iterativeCalculationSettings |
決定是否以反覆運算方式解決循環參照,以及採用何種方式進行。如果沒有這個欄位,表示循環參照會導致計算錯誤。 |
spreadsheetTheme |
已套用主題至試算表。 |
importFunctionsExternalUrlAccessAllowed |
是否允許圖片和匯入函式存取外部網址。僅在為 true 時讀取。如果為 false,您可以將其設為 true。如果管理員已啟用許可清單功能,系統會略過這個值,並一律傳回 true。 |
RecalculationInterval
列舉可能的重新計算間隔選項。
列舉 | |
---|---|
RECALCULATION_INTERVAL_UNSPECIFIED |
預設值。請勿使用此值。 |
ON_CHANGE |
易變函式會在每次變更時更新。 |
MINUTE |
易變函式會在每次變更和每分鐘更新。 |
HOUR |
易變函式會在每次變更和每小時更新。 |
IterativeCalculationSettings
用於控制如何以反覆運算方式解決循環相依性。
JSON 表示法 |
---|
{ "maxIterations": integer, "convergenceThreshold": number } |
欄位 | |
---|---|
maxIterations |
啟用迭代計算時,要執行的計算輪次數量上限。 |
convergenceThreshold |
啟用迭代計算功能後,如果後續結果的差異值低於這個閾值,計算輪次就會停止。 |
SpreadsheetTheme
代表試算表主題
JSON 表示法 |
---|
{
"primaryFontFamily": string,
"themeColors": [
{
object ( |
欄位 | |
---|---|
primaryFontFamily |
主要字型系列的名稱。 |
themeColors[] |
試算表主題顏色配對。如要更新,你必須提供所有主題顏色組合。 |
ThemeColorPair
將試算表主題顏色類型與代表的具體顏色對應。
JSON 表示法 |
---|
{ "colorType": enum ( |
欄位 | |
---|---|
colorType |
試算表主題顏色的類型。 |
color |
對應主題顏色類型的具體顏色。 |
NamedRange
已命名範圍。
JSON 表示法 |
---|
{
"namedRangeId": string,
"name": string,
"range": {
object ( |
欄位 | |
---|---|
namedRangeId |
命名範圍的 ID。 |
name |
命名範圍的名稱。 |
range |
代表的範圍。 |
DataSource
試算表中外部資料來源的相關資訊。
JSON 表示法 |
---|
{ "dataSourceId": string, "spec": { object ( |
欄位 | |
---|---|
dataSourceId |
用於識別資料來源的試算表專屬 ID。示例:1080547365。 |
spec |
與此試算表連結的資料來源的 |
calculatedColumns[] |
資料來源中的所有計算結果欄。 |
sheetId |
與資料來源連結的 建立資料來源時,系統也會建立相關聯的 |
DataSourceSpec
這會指定資料來源的詳細資料。舉例來說,如果是 BigQuery,這會指定 BigQuery 來源的相關資訊。
JSON 表示法 |
---|
{ "parameters": [ { object ( |
欄位 | |
---|---|
parameters[] |
資料來源的參數,用於查詢資料來源。 |
聯集欄位 spec 。每個資料來源類型的實際規格。spec 只能是下列其中一項: |
|
bigQuery |
|
looker |
[LookerDatasourceSpec][]。 |
BigQueryDataSourceSpec
與試算表連結的 BigQuery 資料來源規格。
JSON 表示法 |
---|
{ "projectId": string, // Union field |
欄位 | |
---|---|
projectId |
已附加帳單帳戶的 Google Cloud 專案 (已啟用 BigQuery) 的 ID。針對針對資料來源執行的任何查詢,系統都會向專案收費。 |
聯集欄位 spec 。實際規格。spec 只能是下列其中一項: |
|
querySpec |
|
tableSpec |
|
BigQueryQuerySpec
指定自訂 BigQuery 查詢。
JSON 表示法 |
---|
{ "rawQuery": string } |
欄位 | |
---|---|
rawQuery |
原始查詢字串。 |
BigQueryTableSpec
指定 BigQuery 資料表定義。只允許原生資料表。
JSON 表示法 |
---|
{ "tableProjectId": string, "tableId": string, "datasetId": string } |
欄位 | |
---|---|
tableProjectId |
資料表所屬 BigQuery 專案的 ID。如未指定,系統會假設您使用的是 |
tableId |
BigQuery 資料表 ID。 |
datasetId |
BigQuery 資料集 ID。 |
LookerDataSourceSpec
Looker 資料來源的規格。
JSON 表示法 |
---|
{ "instanceUri": string, "model": string, "explore": string } |
欄位 | |
---|---|
instanceUri |
Looker 執行個體網址。 |
model |
Looker 模型的名稱。 |
explore |
Looker 模型探索的名稱。 |
DataSourceParameter
資料來源查詢中的參數。使用者可以透過這個參數,將試算表中的值傳入查詢。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 identifier 。參數 ID。identifier 只能是下列其中一項: |
|
name |
已命名參數。必須是支援該 |
聯集欄位 value 。參數值。value 只能是下列其中一項: |
|
namedRangeId |
|
range |
包含參數值的範圍。大小必須為 1x1。 |
DataSourceRefreshSchedule
資料來源的重新整理時間表。
試算表中的資料來源會在一段時間內重新整理。你可以在試算表編輯器中按一下「排程重新整理」按鈕,指定開始時間,但間隔時間固定為 4 小時。舉例來說,如果您指定的開始時間為上午 8 點,系統就會在每天上午 8 點到中午 12 點之間進行重新整理。
JSON 表示法 |
---|
{ "enabled": boolean, "refreshScope": enum ( |
欄位 | |
---|---|
enabled |
如果已啟用重新整理時間表,則傳回「是」;否則傳回「否」。 |
refreshScope |
重新整理的範圍。必須為 |
nextRun |
僅供輸出。下次執行作業的時間間隔。 |
聯集欄位 schedule_config 。排程設定 schedule_config 只能是下列其中一種: |
|
dailySchedule |
每日重新整理時間表。 |
weeklySchedule |
每週更新時間表。 |
monthlySchedule |
每月重新整理時間表。 |
DataSourceRefreshScope
資料來源重新整理範圍。
列舉 | |
---|---|
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED |
預設值,請勿使用。 |
ALL_DATA_SOURCES |
重新整理試算表中的所有資料來源及其相關聯的資料來源物件。 |
DataSourceRefreshDailySchedule
資料的排程,每天在指定的時間間隔重新整理資料。
JSON 表示法 |
---|
{
"startTime": {
object ( |
欄位 | |
---|---|
startTime |
資料來源重新整理作業排定的時間間隔開始時間。只使用 |
TimeOfDay
代表一天中的時間。日期和時區並不需要指定,或是在其他位置上指定。API 可選擇允許閏秒。相關類型為 google.type.Date
和 google.protobuf.Timestamp
。
JSON 表示法 |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
欄位 | |
---|---|
hours |
一天中的小時,採用 24 小時制。值應介於 0 到 23 之間。API 可選擇允許使用「24:00:00」這類的值來表示營業打烊時間等情況。 |
minutes |
一天中,每小時內的分鐘。值必須介於 0 到 59 之間。 |
seconds |
在當下時間中,該分鐘的秒數。正常情況下,值必須介於 0 到 59 之間。如果 API 允許閏秒,則可允許值為 60。 |
nanos |
秒數的小數,以奈秒為單位。值必須介於 0 到 999,999,999 之間。 |
DataSourceRefreshWeeklySchedule
每週排程,可在特定時間間隔內的特定日期更新資料。
JSON 表示法 |
---|
{ "startTime": { object ( |
欄位 | |
---|---|
startTime |
資料來源重新整理作業排定的時間間隔開始時間。只使用 |
daysOfWeek[] |
要重新整理的星期幾。至少須指定一天。 |
DayOfWeek
代表星期幾。
列舉 | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
未指定星期幾。 |
MONDAY |
星期一 |
TUESDAY |
週二 |
WEDNESDAY |
週三 |
THURSDAY |
週四 |
FRIDAY |
Friday (週五) |
SATURDAY |
Saturday (週六) |
SUNDAY |
星期日 |
DataSourceRefreshMonthlySchedule
每月定期重新整理資料的時間表,可在特定時間間隔內於當月特定日期重新整理資料。
JSON 表示法 |
---|
{
"startTime": {
object ( |
欄位 | |
---|---|
startTime |
資料來源重新整理作業排定的時間間隔開始時間。只使用 |
daysOfMonth[] |
每月要重新整理的日期。系統僅支援 1 到 28 的值,對應到 1 到 28 日。至少須指定一天。 |
時間間隔
代表時間間隔,編碼為時間戳記開始時間 (包含在內) 和時間戳記結束時間 (不含在內)。
開始時間必須小於或等於結束時間。如果開始時間等於結束時間,則表示間隔為空白 (不符合任何時間)。如果未指定開始和結束時間,則間隔會與任何時間相符。
JSON 表示法 |
---|
{ "startTime": string, "endTime": string } |
欄位 | |
---|---|
startTime |
選用設定。有效時間範圍的起始值 (含)。 如果指定了這個間隔,則時間戳記必須與這個間隔相同或晚於開始時間。 |
endTime |
選用設定。限制時段的結束時間 (不包含在內)。 如果指定了這個間隔,則必須在結束時間之前,提供符合這個間隔的時間戳記。 |
方法 |
|
---|---|
|
將一或多項更新套用至試算表。 |
|
建立試算表,並傳回新建立的試算表。 |
|
傳回指定 ID 的試算表。 |
|
傳回指定 ID 的試算表。 |