Charts

integer

圖表的 ID。

object (ChartSpec)

圖表的規格。

object (EmbeddedObjectPosition)

圖表的位置。

object (EmbeddedObjectBorder)

圖表的邊框。

string

圖表的標題。

string

用來說明圖表的替代文字。這項功能通常用於無障礙功能。

object (TextFormat)

標題文字格式。不支援刪除線、底線和連結。

object (TextPosition)

標題文字的位置。這是選填欄位。

string

圖表的副標題。

object (TextFormat)

字幕文字格式。不支援刪除線、底線和連結。

object (TextPosition)

副標題文字位置。這是選填欄位。

string

預設用於所有圖表文字 (例如標題、軸標籤、圖例) 的字型名稱。如果為圖表的特定部分指定字型，則會覆寫這個字型名稱。

boolean

設為 True 可讓圖表以最小邊框間距填滿繪製的整個空間。設為 False 可使用預設邊框間距。(不適用於地理圖和組織圖)。

object (Color)

整個圖表的背景顏色。不適用於組織圖。已淘汰：請改用 backgroundColorStyle。

object (ColorStyle)

整個圖表的背景顏色。不適用於組織圖。如果同時設定了 backgroundColor，這個欄位的優先順序會高於 backgroundColor。

object (DataSourceChartProperties)

如果有此欄位，則會包含資料來源圖表專屬的屬性。

object (FilterSpec)

套用至圖表來源資料的篩選器。僅支援資料來源圖表。

object (SortSpec)

排序圖表資料的順序。系統僅支援單一排序規格。僅支援資料來源圖表。

enum (ChartHiddenDimensionStrategy)

決定圖表如何使用隱藏的資料列或資料欄。

object (BasicChartSpec)

基本圖表規格可為多種圖表的其中一種。如需所有支援圖表的清單，請參閱 BasicChartType。

object (PieChartSpec)

圓餅圖規格。

object (BubbleChartSpec)

泡泡圖規格。

object (CandlestickChartSpec)

K 線圖規格。

object (OrgChartSpec)

組織圖規格。

object (HistogramChartSpec)

直方圖規格。

object (WaterfallChartSpec)

瀑布圖規格。

object (TreemapChartSpec)

樹狀圖圖表規格。

object (ScorecardChartSpec)

評量圖表規格。

enum (HorizontalAlign)

文字的水平對齊設定。

string

與圖表相關聯的資料來源 ID。

object (DataExecutionStatus)

僅供輸出。資料執行狀態。

enum (BasicChartType)

圖表類型。

enum (BasicChartLegendPosition)

圖例的位置。

object (BasicChartAxis)

圖表上的軸。

object (BasicChartDomain)

這項資料的網域。僅支援單一網域。

object (BasicChartSeries)

這張圖表所顯示的資料。

integer

資料中「標題」列數或欄數。如果未設定，Google 試算表會根據資料判斷有多少列是標題。

(請注意，BasicChartAxis.title 可能會覆寫從標頭值推斷的軸標題)。

boolean

將此屬性設為 True，即可將圖表設為 3D 格式。適用於長條圖和柱狀圖。

boolean

如果資料系列中缺少部分值，圖表中可能會出現空白 (例如，折線圖中會缺少線段)。如要消除這些差距，請將此值設為 true。適用於折線圖、面積圖和組合圖。

enum (BasicChartStackedType)

支援垂直堆疊的圖表的堆疊類型。適用於面積圖、長條圖、柱狀圖、組合圖和階梯狀面積圖。

boolean

取得預設是否應將所有線條算繪為平滑或直線。適用於折線圖。

enum (BasicChartCompareMode)

當游標懸停在資料和圖表區域時，工具提示和資料醒目顯示的行為。

object (DataLabel)

控制是否要在堆疊圖表中顯示額外資料標籤，該圖表會將網域軸上每個值的所有堆疊值加總為總值。只有在 chartType 為 AREA、BAR、COLUMN、COMBO 或 STEPPED_AREA 時，才能設定這些資料標籤，且 stackedType 為 STACKED 或 PERCENT_STACKED。此外，對於 COMBO，只有在只有一種可堆疊的系列 type 或一種類型有比其他類型更多的系列，且每個其他類型最多只有一個系列時，才會支援這項功能。舉例來說，如果圖表包含兩個堆疊長條圖序列和一個面積圖序列，則會支援總資料標籤。如果圖表包含三個長條圖序列和兩個區域圖序列，則不允許顯示總資料標籤。CUSTOM 和 placement 都無法在 totalDataLabel 上設定。

enum (BasicChartAxisPosition)

這個軸的位置。

string

此軸的標題。如果已設定，則會覆寫從資料標頭推斷的任何標題。

object (TextFormat)

標題的格式。只有在軸未與網域相關聯時才有效。不支援連結欄位。

object (TextPosition)

軸標題文字位置。

object (ChartAxisViewWindowOptions)

這個軸的檢視區塊選項。

number

這個檢視窗中要顯示的最小數值。如果未設定，系統會自動判斷最適合資料的最低值。

number

這個檢視窗口中顯示的最大數值。如果未設定，系統會自動判斷最適合資料的最大值。

enum (ViewWindowMode)

檢視畫面的模式。

object (ChartData)

網域的資料。舉例來說，如果要繪製股價隨時間變化的圖表，這就是代表日期的資料。

boolean

將網域值 (水平軸) 的順序反轉。

object (ChartGroupRule)

依據 ChartData 是否支援資料來源圖表的網域，將資料分組的規則。僅支援資料來源圖表。

enum (ChartAggregateType)

資料來源圖表序列的匯總類型。僅支援資料來源圖表。

object (ChartSourceRange)

資料的來源範圍。

object (DataSourceColumnReference)

資料讀取的資料來源欄參照。

object (GridRange)

系列或網域的資料範圍。只有一個維度必須長度為 1，清單中的所有來源都必須有長度為 1 的相同維度。網域 (如果有的話) 和所有序列都必須有相同數量的來源範圍。如果使用多個來源範圍，則在指定偏移位置的來源範圍必須按順序排列，且跨網域和系列。

例如，下列為有效的設定：

domain sources: A1:A5
series1 sources: B1:B5
series2 sources: D6:D10

domain sources: A1:A5, C10:C12
series1 sources: B1:B5, D10:D12
series2 sources: C1:C5, E10:E12

object (ChartDateTimeRule)

ChartDateTimeRule。

object (ChartHistogramRule)

A ChartHistogramRule

enum (ChartDateTimeRuleType)

要套用的日期時間分組類型。

number

項目歸入值區時的最低值。小於下限的值會歸為單一特徵分塊。如果省略，系統會根據最低商品價值決定。

number

項目放入值區的最大值。大於上限的值會組成單一特徵分塊。如果省略，則由項目最大值決定。

number

已建立的桶大小。必須為正數。

object (ChartData)

這個圖表系列中要視覺化的資料。

enum (BasicChartAxisPosition)

指定此序列值範圍的輔助軸。舉例來說，如果要繪製股票的時間序列圖表，建議將「交易量」系列釘選至右側，並將價格釘選至左側，因為交易量的刻度與價格的刻度不同。如果指定的軸不是圖表 type 的有效次軸，則會發生錯誤。

enum (BasicChartType)

這個系列叢書的類型。只有在 chartType 為 COMBO 時才有效。不同類型的資料會影響序列的視覺化方式。僅支援 LINE、AREA 和 COLUMN。

object (LineStyle)

此系列的線條樣式。只有在 chartType 為 AREA、LINE 或 SCATTER 時才有效。如果 series chart type 是 AREA 或 LINE，系統也支援 COMBO 圖表。

object (DataLabel)

這個系列叢書的資料標籤相關資訊。

object (Color)

與此系列相關聯的元素 (例如長條、線條和點) 的顏色。如果留空，系統會使用預設顏色。已淘汰：請改用 colorStyle。

object (ColorStyle)

與此系列相關聯的元素 (例如長條、線條和點) 的顏色。如果留空，系統會使用預設顏色。如果同時設定了 color，這個欄位的優先順序會高於 color。

object (PointStyle)

與此系列相關聯的點樣式。只有在 chartType 為 AREA、LINE 或 SCATTER 時才有效。如果 series chart type 是 AREA、LINE 或 SCATTER，也支援 COMBO 圖表。如果留空，系統會使用預設的點樣式。

object (BasicSeriesDataPointStyleOverride)

系列資料點的樣式覆寫設定。

integer

線條的粗細 (以像素為單位)。

enum (LineDashType)

線條的虛線類型。

enum (DataLabelType)

資料標籤的類型。

object (TextFormat)

資料標籤使用的文字格式。不支援連結欄位。

enum (DataLabelPlacement)

相對於已標記資料的資料標籤位置。

object (ChartData)

用於自訂標籤的資料。只有在 type 設為 CUSTOM 時才會使用。此資料的長度必須與所套用的資料標籤所適用的系列或其他元素相同。此外，如果時間序列分割為多個來源範圍，則此來源資料必須來自來源資料中的下一個資料欄。舉例來說，如果資料列為 B2:B4、E6:E8，則這項資料必須來自 C2:C4、F6:F8。

number

資料點大小。如果留空，系統會使用預設大小。

enum (PointShape)

點形狀。如為空白或未指定，系統會使用預設形狀。

integer

系列資料點的索引，從零開始。

object (Color)

序列資料點的顏色。如果留空，系統會使用系列叢書的預設值。已淘汰：請改用 colorStyle。

object (ColorStyle)

序列資料點的顏色。如果留空，系統會使用系列叢書的預設值。如果同時設定了 color，這個欄位的優先順序會高於 color。

object (PointStyle)

序列資料點的點樣式。只有在 chartType 為 AREA、LINE 或 SCATTER 時才有效。如果 series chart type 是 AREA、LINE 或 SCATTER，也支援 COMBO 圖表。如果留空，系統會使用系列叢書的預設值。

enum (PieChartLegendPosition)

圓餅圖的圖例繪製位置。

object (ChartData)

涵蓋圓餅圖網域的資料。

object (ChartData)

涵蓋圓餅圖中唯一一組序列的資料。

boolean

如果圖表是三維圖表，則為「是」。

number

圓餅圖中洞的大小。

enum (BubbleChartLegendPosition)

圖表圖例的繪製位置。

object (ChartData)

包含氣泡標籤的資料。這些值不必是唯一值。

object (ChartData)

含有氣泡 x 值的資料。這些值會將泡泡水平定位在圖表中。

object (ChartData)

包含氣泡 y 值的資料。這些值會將泡泡垂直放置在圖表中。

object (ChartData)

包含氣泡群組 ID 的資料。所有群組 ID 相同的氣泡都會以相同顏色繪製。如果指定 bubbleSizes，則必須一併指定這個欄位，但可能包含空白值。這是選填欄位。

object (ChartData)

包含氣泡大小的資料。氣泡大小用於繪製不同大小的氣泡，如果指定了 groupIds，則必須一併指定 。這是選填欄位。

number

說明圖示的不透明度介於 0 和 1.0 之間。0 表示完全透明，1 則是完全不透明。

object (Color)

說明圖示邊框顏色。已淘汰：請改用 bubbleBorderColorStyle。

object (ColorStyle)

說明圖示邊框顏色。如果同時設定了 bubbleBorderColor，這個欄位的優先順序會高於 bubbleBorderColor。

integer

氣泡的半徑大小上限 (以像素為單位)。如果指定此值，欄位必須是正值。

integer

氣泡的半徑大小下限 (以像素為單位)。如果是特定值，則欄位必須是正值。

object (TextFormat)

氣泡內文字的格式。不支援刪除線、底線和連結。

object (CandlestickDomain)

燭台圖表的網域資料 (水平軸)。系統會將字串資料視為離散標籤，其他資料則視為連續值。

object (CandlestickData)

K 線圖資料。僅支援一個 CandlestickData。

object (ChartData)

CandlestickDomain 的資料。

boolean

將網域值 (水平軸) 的順序反轉。

object (CandlestickSeries)

每個蠟燭圖低點/最小值的範圍資料 (垂直軸)。這是 K 線圖中的下影線底端。

object (CandlestickSeries)

每個蠟燭圖的開盤/初始值範圍資料 (垂直軸)。這是蠟燭主體的底部。如果小於收盤價，實體段就會是填滿的實心。否則蠟燭會變成空心狀態。

object (CandlestickSeries)

每個蠟燭圖的收盤/最終值範圍資料 (垂直軸)。這是 K 線圖的實體頂端。如果大於開盤價，實體段就會是填滿的實心。否則蠟燭會變成空心狀態。

object (CandlestickSeries)

每個蠟燭圖的最高/最大值範圍資料 (垂直軸)。這是 K 線圖中的上影線頂端。

object (ChartData)

CandlestickSeries 的資料。

enum (OrgChartNodeSize)

組織結構圖節點的大小。

object (Color)

組織圖節點的顏色。已淘汰：請改用 nodeColorStyle。

object (ColorStyle)

組織圖節點的顏色。如果同時設定了 nodeColor，這個欄位的優先順序會高於 nodeColor。

object (Color)

所選組織圖節點的顏色。已淘汰：請改用 selectedNodeColorStyle。

object (ColorStyle)

所選組織圖節點的顏色。如果同時設定了 selectedNodeColor，這個欄位的優先順序會高於 selectedNodeColor。

object (ChartData)

包含圖表中所有節點標籤的資料。標籤不得重複。

object (ChartData)

包含對應節點父項的標籤資料。空白值表示節點沒有父項節點，是頂層節點。這是選填欄位。

object (ChartData)

包含對應節點工具提示的資料。如果值為空白，則不會顯示節點的工具提示。這是選填欄位。

object (HistogramSeries)

直方圖的系列可以是單一要分割的值系列，也可以是多個系列，每個系列的長度都相同，並包含系列名稱和該系列要分割的值。

enum (HistogramChartLegendPosition)

圖例的位置。

boolean

是否要在每個欄的項目之間顯示水平分隔線。

number

根據預設，系統會自動選擇桶大小 (單一欄中堆疊的值範圍)，但您可以在此覆寫。例如：值區大小為 1.5 時，值區範圍為 0 - 1.5、1.5 - 3.0 等，不得為負值。這是選填欄位。

number

異常值百分位數可確保異常值不會對值區大小的計算產生負面影響。舉例來說，如果設定 0.05 的異常值百分位數，表示計算值區時，會排除前 5% 和後 5% 的值。這些值仍會納入圖表，但會加入第一或最後一個值區，而非各自的值區。必須介於 0.0 和 0.5 之間。

object (Color)

在各個值區中，代表此系列的資料欄顏色。這是選填欄位。已淘汰：請改用 barColorStyle。

object (ColorStyle)

在各個值區中，代表此系列的資料欄顏色。這是選填欄位。如果同時設定了 barColor，這個欄位的優先順序會高於 barColor。

object (ChartData)

這個直方圖序列的資料。

object (WaterfallChartDomain)

瀑布圖的網域資料 (水平軸)。

object (WaterfallChartSeries)

這張瀑布圖表所呈現的資料。

enum (WaterfallChartStackedType)

堆疊類型。

boolean

若為 true，系統會將第一個值解讀為總和。

boolean

將欄之間的連接線設為隱藏狀態。

object (LineStyle)

連接線的線條樣式。

object (DataLabel)

控制是否要在堆疊圖表中顯示額外資料標籤，這些標籤會沿著網域軸，將每個值的所有堆疊值加總為總值。stackedType 必須為 STACKED，且 CUSTOM 和 placement 都無法在 totalDataLabel 上設定。

object (ChartData)

WaterfallChartDomain 的資料。

boolean

將網域值 (水平軸) 的順序反轉。

object (ChartData)

這個系列中要視覺化呈現的資料。

object (WaterfallChartColumnStyle)

此系列中所有含正值的資料欄樣式。

object (WaterfallChartColumnStyle)

此系列中所有負值欄的樣式。

object (WaterfallChartColumnStyle)

此系列中所有小計欄的樣式。

boolean

設為 True 可隱藏系列結尾的子總欄。根據預設，每個資料系列的結尾都會顯示小計欄。如果將這個欄位設為 true，系統就會隱藏該系列的子總欄。

object (WaterfallChartCustomSubtotal)

這個系列中顯示的自訂小計欄。子總計的定義順序不拘。每個資料點只能定義一個小計。

object (DataLabel)

這個系列叢書的資料標籤相關資訊。

string

資料欄圖例的標籤。

object (Color)

資料欄的顏色。已淘汰：請改用 colorStyle。

object (ColorStyle)

資料欄的顏色。如果同時設定了 color，這個欄位的優先順序會高於 color。

integer

時間序列中資料點的索引，從零開始。如果 dataIsSubtotal 為 true，則此索引的資料點為小計。否則，系統會在含有此索引的資料點後方顯示小計。系列可在任意索引中包含多個小計，但小計不會影響資料點的索引。舉例來說，如果序列有三個資料點，則其索引一律會是 0、1 和 2，無論序列中有多少個小計或與哪些資料點相關皆然。

string

小計欄的標籤。

boolean

如果 subtotalIndex 中的資料點是小計，則為「是」。如果為 false，系統會計算並顯示小計，並顯示在資料點之後。

object (ChartData)

包含樹狀圖單元格標籤的資料。

object (ChartData)

包含樹狀圖單元格父項標籤的資料。

object (ChartData)

用來決定每個樹狀圖資料單元大小的資料。這項資料應為數值。系統不會算繪對應的儲存格，因為該儲存格不含數字或缺少資料。如果未指定 colorData，系統也會使用這項資料來決定資料儲存格背景顏色。

object (ChartData)

用來決定每個樹狀圖資料儲存格背景顏色的資料。這是選填欄位。如果未指定，系統會使用 sizeData 來判斷背景顏色。如果指定了這項屬性，資料應為數值。colorScale 會決定資料對應值如何對應至資料儲存格背景顏色。

object (TextFormat)

圖表中所有標籤的文字格式。不支援連結欄位。

integer

要在樹狀圖圖表中顯示的資料層級數量。這些層級是互動式層級，並會顯示標籤。若未指定，預設值為 2。

integer

除了標示的層級之外，樹狀圖圖表會顯示的其他資料層級數量。這些層級不會提供互動功能，且不會顯示標籤。若未指定，預設會使用 0。

number

最小可能資料值。值低於此值的儲存格會與值等於此值的儲存格使用相同的顏色。如未指定，則預設為 colorData 的實際最小值，或 sizeData 的實際最小值 (如果未指定 colorData)。

number

資料的最大值。值大於這個值的儲存格會與值為此值的儲存格使用相同的顏色。如未指定，則預設為 colorData 的實際最大值，或 sizeData 的最大值 (如果未指定 colorData)。

object (Color)

標頭儲存格的背景顏色。已淘汰：請改用 headerColorStyle。

object (ColorStyle)

標頭儲存格的背景顏色。如果同時設定了 headerColor，這個欄位的優先順序會高於 headerColor。

object (TreemapChartColorScale)

樹狀圖圖表中資料儲存格使用的色彩比例。系統會根據資料儲存格的顏色值，為資料儲存格指派顏色。這些色彩值來自 colorData，如果未指定 colorData，則來自 sizeData。色彩值小於或等於 minValue 的儲存格將會以 minValueColor 做為背景顏色。色彩值大於或等於 maxValue 的儲存格將會以 maxValueColor 做為背景顏色。色彩值介於 minValue 和 maxValue 之間的儲存格，背景顏色會是介於 minValueColor 和 maxValueColor 之間的漸層，漸層的中點則是 midValueColor。缺少或非數字顏色值的儲存格，背景顏色會設為 noDataColor。

boolean

設為 True 可隱藏工具提示。

object (Color)

背景顏色為小於或等於 minValue 的儲存格。如果未指定，預設值為 #dc3912。已淘汰：請改用 minValueColorStyle。

object (ColorStyle)

背景顏色為小於或等於 minValue 的儲存格。如果未指定，預設值為 #dc3912。如果同時設定了 minValueColor，這個欄位的優先順序會高於 minValueColor。

object (Color)

儲存格背景顏色，其顏色值介於 minValue 和 maxValue 之間的中點。如果未指定，預設值為 #efe6dc。已淘汰：請改用 midValueColorStyle。

object (ColorStyle)

儲存格背景顏色，其顏色值介於 minValue 和 maxValue 之間的中點。如果未指定，預設值為 #efe6dc。如果同時設定了 midValueColor，這個欄位的優先順序會高於 midValueColor。

object (Color)

背景顏色為儲存格顏色值大於或等於 maxValue。如果未指定，預設值為 #109618。已淘汰：請改用 maxValueColorStyle。

object (ColorStyle)

背景顏色為儲存格顏色值大於或等於 maxValue。如果未指定，預設值為 #109618。如果同時設定了 maxValueColor，這個欄位的優先順序會高於 maxValueColor。

object (Color)

沒有關聯色彩資料的儲存格背景顏色。如果未指定，預設值為 #000000。已淘汰：請改用 noDataColorStyle。

object (ColorStyle)

沒有關聯色彩資料的儲存格背景顏色。如果未指定，預設值為 #000000。如果同時設定了 noDataColor，這個欄位的優先順序會高於 noDataColor。

object (ChartData)

評量板鍵/值的資料。

object (ChartData)

評量圖表基準值的資料。這是選填欄位。

enum (ChartAggregateType)

分數卡圖表中關鍵和基準圖表資料的匯總類型。資料來源圖表不支援這個欄位。請改用 keyValueData 或 baselineValueData 的 ChartData.aggregateType 欄位，製作資料來源圖表。這是選填欄位。

object (KeyValueFormat)

鍵值的格式設定選項。

object (BaselineValueFormat)

基準值的格式選項。只有在指定 baselineValueData 時，才需要這個欄位。

number

用於量化分數卡鍵和基準值的值。舉例來說，係數 10 可用於將圖表中的所有值除以 10。這是選填欄位。

enum (ChartNumberFormatSource)

分數卡圖表中使用的數字格式來源。這是選填欄位。

object (ChartCustomNumberFormatOptions)

評量圖表中數字鍵/基準值的自訂格式選項。只有在 numberFormatSource 設為 CUSTOM 時，系統才會使用這個欄位。這是選填欄位。

object (TextFormat)

鍵值的文字格式設定選項。不支援連結欄位。

object (TextPosition)

指定鍵值的水平文字位置。這是選填欄位。如未指定，系統會使用預設位置。

enum (ComparisonType)

鍵值與基準值的比較類型。

object (TextFormat)

基準值的文字格式設定選項。不支援連結欄位。

object (TextPosition)

指定基準值的水平文字位置。這是選填欄位。如未指定，系統會使用預設位置。

string

附加在基準值後方的說明。這是選填欄位。

object (Color)

當基準值代表關鍵值的正向變化時，要使用的顏色。這是選填欄位。已淘汰：請改用 positiveColorStyle。

object (ColorStyle)

當基準值代表關鍵值的正向變化時，要使用的顏色。這是選填欄位。如果同時設定了 positiveColor，這個欄位的優先順序會高於 positiveColor。

object (Color)

當基準值代表關鍵值的負向變化時，要使用的顏色。這是選填欄位。已淘汰：請改用 negativeColorStyle。

object (ColorStyle)

當基準值代表關鍵值的負向變化時，要使用的顏色。這是選填欄位。如果同時設定了 negativeColor，這個欄位的優先順序會高於 negativeColor。

string

要附加至圖表屬性前端的自訂前置字串。這是選填欄位。

string

要附加至圖表屬性的自訂後置字元。這是選填欄位。

object (Color)

邊框的顏色。已淘汰：請改用 colorStyle。

object (ColorStyle)

邊框的顏色。如果同時設定了 color，這個欄位的優先順序會高於 color。