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，這個欄位的優先順序會優先採用。

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)

A 罩杯 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 也會設定這個欄位，這個欄位的優先順序最高。

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 也會設定這個欄位，這個欄位的優先順序最高。

object (PointStyle)

序列資料點的點樣式。本優惠僅適用於 chartType 為 AREA, LINE，或 SCATTER。 COMBO 如果 series chart type 為 AREA, LINE，或 SCATTER。如果留空，系統會使用系列叢書的預設值。

enum (PieChartLegendPosition)

要繪製圓餅圖圖例的位置。

object (ChartData)

涵蓋圓餅圖的網域資料。

object (ChartData)

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

boolean

如果圓餅圖為 3D，則為「是」。

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 也會設定這個欄位，這個欄位的優先順序最高。

integer

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

integer

說明框的最小半徑大小 (以像素為單位)。如果是特定值，則欄位必須是正值。

object (TextFormat)

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

object (CandlestickDomain)

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

object (CandlestickData)

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

object (ChartData)

CandlestickDomain 的資料。

boolean

設為 True 代表網域值的順序 (水平軸)。

object (CandlestickSeries)

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

object (CandlestickSeries)

每根 K 線的開盤/初始值的範圍資料 (垂直軸)。這是蠟燭身體的底部。如果低於接近值，K 線就會填滿。否則，蠟燭會以空心顯示。

object (CandlestickSeries)

每根蠟燭的收尾/最終值範圍資料 (縱軸)。這是 K 線圖的實體頂端。如果大於開放值，K 線就會填滿。否則，蠟燭會以空心顯示。

object (CandlestickSeries)

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

object (ChartData)

K 線圖的資料。

enum (OrgChartNodeSize)

機構圖表節點大小。

object (Color)

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

object (ColorStyle)

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

object (Color)

所選機構圖表節點的顏色。已淘汰：請改用 selectedNodeColorStyle。

object (ColorStyle)

所選機構圖表節點的顏色。如果 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%。圖表仍會包含這些值，並且加入第一個或最後一個值區，而不是所屬值區。必須介於 0.0 和 0.5 之間。

object (Color)

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

object (ColorStyle)

代表各值區中序列的資料欄顏色。這是選填欄位。如果 barColor 也會設定這個欄位，這個欄位的優先順序最高。

object (ChartData)

這個直方圖系列的資料。

object (WaterfallChartDomain)

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

object (WaterfallChartSeries)

這個刊登序列圖表所要呈現的資料。

enum (WaterfallChartStackedType)

堆疊類型。

boolean

如果將第一個值視為總計，則為 True。

boolean

設為 True 則會隱藏資料欄之間的連接線。

object (LineStyle)

連接線的線條樣式。

object (DataLabel)

控制是否要在堆疊圖表中顯示額外資料標籤，這些標籤會沿著網域軸，將每個值的所有堆疊值加總為總值。stackedType 必須是 STACKED 且兩者皆非 CUSTOM Nor 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 也會設定這個欄位，這個欄位的優先順序最高。

integer

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

string

小計欄的標籤。

boolean

若資料點的資料點為 True 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 未指定任何 IP 位址。

object (Color)

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

object (ColorStyle)

標頭儲存格的背景顏色。如果 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，這個欄位的優先順序會優先採用。

object (Color)

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

object (ColorStyle)

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

object (Color)

色彩值大於或等於 maxValue。如果未指定，預設值為 #109618。已淘汰：使用 maxValueColorStyle。

object (ColorStyle)

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

object (Color)

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

object (ColorStyle)

沒有關聯色彩資料的儲存格背景顏色。如果未指定，預設值為 #000000。如果同時設定了 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 也會設定這個欄位，這個欄位的優先順序最高。

object (Color)

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

object (ColorStyle)

要使用的顏色，在基準值代表鍵/值發生負值的情況下。這是選填欄位。如果同時設定了 negativeColor，這個欄位的優先順序會優先採用。

string

要加到圖表屬性前面的自訂前置字元。這是選填欄位。

string

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

object (Color)

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

object (ColorStyle)

邊框的顏色。如果 color 也會設定這個欄位，這個欄位的優先順序最高。