Charts

EmbeddedChart

工作表中嵌入的圖表。

JSON 表示法 
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  },
  "border": {
    object (EmbeddedObjectBorder)
  }
}
欄位
chartId

integer

圖表的 ID。
spec

object (ChartSpec)

圖表的規格。
position

object (EmbeddedObjectPosition)

圖表的位置。
border

object (EmbeddedObjectBorder)

圖表的邊框。

ChartSpec

圖表的規格。

JSON 表示法 
{
  "title": string,
  "altText": string,
  "titleTextFormat": {
    object (TextFormat)
  },
  "titleTextPosition": {
    object (TextPosition)
  },
  "subtitle": string,
  "subtitleTextFormat": {
    object (TextFormat)
  },
  "subtitleTextPosition": {
    object (TextPosition)
  },
  "fontName": string,
  "maximized": boolean,
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "dataSourceChartProperties": {
    object (DataSourceChartProperties)
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "hiddenDimensionStrategy": enum (ChartHiddenDimensionStrategy),

  // Union field chart can be only one of the following:
  "basicChart": {
    object (BasicChartSpec)
  },
  "pieChart": {
    object (PieChartSpec)
  },
  "bubbleChart": {
    object (BubbleChartSpec)
  },
  "candlestickChart": {
    object (CandlestickChartSpec)
  },
  "orgChart": {
    object (OrgChartSpec)
  },
  "histogramChart": {
    object (HistogramChartSpec)
  },
  "waterfallChart": {
    object (WaterfallChartSpec)
  },
  "treemapChart": {
    object (TreemapChartSpec)
  },
  "scorecardChart": {
    object (ScorecardChartSpec)
  }
  // End of list of possible types for union field chart.
}
欄位
title

string

圖表的標題。
altText

string

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

object (TextFormat)

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

object (TextPosition)

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

string

圖表的副標題。
subtitleTextFormat

object (TextFormat)

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

subtitleTextPosition

object (TextPosition)

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

string

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

boolean

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

backgroundColor
(deprecated)

object (Color)

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

object (ColorStyle)

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

object (DataSourceChartProperties)

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

object (FilterSpec)

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

object (SortSpec)

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

enum (ChartHiddenDimensionStrategy)

決定圖表如何使用隱藏的資料列或資料欄。
聯集欄位 chart。特定圖表規格，必須設定一個值。chart 只能是下列其中一個：
basicChart

object (BasicChartSpec)

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

object (PieChartSpec)

圓餅圖規格。
bubbleChart

object (BubbleChartSpec)

泡泡圖規格。
candlestickChart

object (CandlestickChartSpec)

K 線圖規格。
orgChart

object (OrgChartSpec)

組織圖規格。
histogramChart

object (HistogramChartSpec)

直方圖規格。
waterfallChart

object (WaterfallChartSpec)

瀑布圖規格。
treemapChart

object (TreemapChartSpec)

樹狀圖圖表規格。
scorecardChart

object (ScorecardChartSpec)

評量圖表規格。

TextPosition

文字的位置設定。

JSON 表示法 
{
  "horizontalAlignment": enum (HorizontalAlign)
}
欄位
horizontalAlignment

enum (HorizontalAlign)

文字的水平對齊設定。

DataSourceChartProperties

資料來源圖表的屬性。

JSON 表示法 
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
欄位
dataSourceId

string

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

object (DataExecutionStatus)

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

BasicChartSpec

基本圖表的規格。如需支援圖表清單，請參閱 BasicChartType。

JSON 表示法 
{
  "chartType": enum (BasicChartType),
  "legendPosition": enum (BasicChartLegendPosition),
  "axis": [
    {
      object (BasicChartAxis)
    }
  ],
  "domains": [
    {
      object (BasicChartDomain)
    }
  ],
  "series": [
    {
      object (BasicChartSeries)
    }
  ],
  "headerCount": integer,
  "threeDimensional": boolean,
  "interpolateNulls": boolean,
  "stackedType": enum (BasicChartStackedType),
  "lineSmoothing": boolean,
  "compareMode": enum (BasicChartCompareMode),
  "totalDataLabel": {
    object (DataLabel)
  }
}
欄位
chartType

enum (BasicChartType)

圖表類型。
legendPosition

enum (BasicChartLegendPosition)

圖例的位置。
axis[]

object (BasicChartAxis)

圖表上的軸。
domains[]

object (BasicChartDomain)

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

object (BasicChartSeries)

這張圖表所顯示的資料。

headerCount

integer

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

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

boolean

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

interpolateNulls

boolean

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

stackedType

enum (BasicChartStackedType)

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

lineSmoothing

boolean

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

enum (BasicChartCompareMode)

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

object (DataLabel)

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

BasicChartType

圖表的呈現方式。

列舉
BASIC_CHART_TYPE_UNSPECIFIED 預設值，請勿使用。
BAR 長條圖。
LINE 折線圖。
AREA 面積圖。
COLUMN 柱狀圖。
SCATTER 散布圖。
COMBO 組合圖。
STEPPED_AREA 階梯狀面積圖。

BasicChartLegendPosition

圖表圖例的位置。

列舉
BASIC_CHART_LEGEND_POSITION_UNSPECIFIED 預設值，請勿使用。
BOTTOM_LEGEND 圖例會顯示在圖表底部。
LEFT_LEGEND 圖例會顯示在圖表左側。
RIGHT_LEGEND 圖例會顯示在圖表右側。
TOP_LEGEND 圖例會顯示在圖表頂端。
NO_LEGEND 系統不會算繪圖例。

BasicChartAxis

圖表的軸。每個 axis position 最多只能在圖表中顯示一個軸。

JSON 表示法 
{
  "position": enum (BasicChartAxisPosition),
  "title": string,
  "format": {
    object (TextFormat)
  },
  "titleTextPosition": {
    object (TextPosition)
  },
  "viewWindowOptions": {
    object (ChartAxisViewWindowOptions)
  }
}
欄位
position

enum (BasicChartAxisPosition)

這個軸的位置。
title

string

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

object (TextFormat)

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

object (TextPosition)

軸標題文字位置。
viewWindowOptions

object (ChartAxisViewWindowOptions)

這個軸的檢視區塊選項。

BasicChartAxisPosition

圖表軸線的位置。

列舉
BASIC_CHART_AXIS_POSITION_UNSPECIFIED 預設值，請勿使用。
BOTTOM_AXIS 在圖表底部算繪的軸。對於大多數圖表，這是標準主要軸。長條圖的輔助軸。
LEFT_AXIS 在圖表左側顯示的軸。對於大多數圖表，這會是次要軸。對於長條圖，這是標準主要軸。
RIGHT_AXIS 在圖表右側顯示的軸。對於大多數圖表，這會是次要軸。對於長條圖來說，這是不尋常的主軸。

ChartAxisViewWindowOptions

這些選項可定義圖表的「檢視窗格」，例如軸中顯示的值。

JSON 表示法 
{
  "viewWindowMin": number,
  "viewWindowMax": number,
  "viewWindowMode": enum (ViewWindowMode)
}
欄位
viewWindowMin

number

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

number

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

enum (ViewWindowMode)

檢視畫面的模式。

ViewWindowMode

檢視畫面的模式。它定義了如何處理檢視畫面的最小值和最大值。

列舉
DEFAULT_VIEW_WINDOW_MODE 這個圖表類型在試算表編輯器中使用的預設檢視視窗模式。在大多數情況下，如果已設定，預設模式就等同於 PRETTY。
VIEW_WINDOW_MODE_UNSUPPORTED 請勿使用。表示 API 不支援目前設定的模式。
EXPLICIT 如有指定，則會完全遵循最小值和最大值。如未指定值，則會改回 PRETTY 值。
PRETTY 選擇可讓圖表看起來不錯的最大值和最小值。在這個模式中，系統會忽略 min 和 max。

BasicChartDomain

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

JSON 表示法 
{
  "domain": {
    object (ChartData)
  },
  "reversed": boolean
}
欄位
domain

object (ChartData)

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

boolean

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

ChartData

網域或系列叢書中包含的資料。

JSON 表示法 
{
  "groupRule": {
    object (ChartGroupRule)
  },
  "aggregateType": enum (ChartAggregateType),

  // Union field type can be only one of the following:
  "sourceRange": {
    object (ChartSourceRange)
  },
  "columnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field type.
}
欄位
groupRule

object (ChartGroupRule)

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

enum (ChartAggregateType)

資料來源圖表序列的匯總類型。僅支援資料來源圖表。
聯集欄位 type。所包含的資料類型，必須設定一個值。type 只能是下列其中一個：
sourceRange

object (ChartSourceRange)

資料的來源範圍。
columnReference

object (DataSourceColumnReference)

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

ChartSourceRange

圖表的來源範圍。

JSON 表示法 
{
  "sources": [
    {
      object (GridRange)
    }
  ]
}
欄位
sources[]

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

ChartGroupRule

資料來源圖表的網域 ChartData 的選用設定，可為網域中的值定義值區，而非個別顯示每個值。

舉例來說，繪製資料來源圖表時，您可以針對網域指定直方圖規則 (應僅包含數值)，將其值分組成桶。圖表序列中屬於同一個分組的任何值，都會根據 aggregateType 進行匯總。

JSON 表示法 
{

  // Union field rule can be only one of the following:
  "dateTimeRule": {
    object (ChartDateTimeRule)
  },
  "histogramRule": {
    object (ChartHistogramRule)
  }
  // End of list of possible types for union field rule.
}
欄位
聯集欄位 rule。要套用至 ChartData 的規則。rule 只能是下列其中一個：
dateTimeRule

object (ChartDateTimeRule)

ChartDateTimeRule。
histogramRule

object (ChartHistogramRule)

A ChartHistogramRule

ChartDateTimeRule

可讓您根據日期或時間值的所選部分，將來源資料欄中的日期時間值分類。

JSON 表示法 
{
  "type": enum (ChartDateTimeRuleType)
}
欄位
type

enum (ChartDateTimeRuleType)

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

ChartDateTimeRuleType

可用的日期時間分組規則類型。

列舉
CHART_DATE_TIME_RULE_TYPE_UNSPECIFIED 預設類型，請勿使用。
SECOND 將日期分組為秒，從 0 到 59。
MINUTE 將日期分組為 0 到 59 之間的分鐘。
HOUR 使用 24 小時制 (從 0 到 23) 將日期分組。
HOUR_MINUTE 使用 24 小時制將日期分組，例如 19:45。
HOUR_MINUTE_AMPM 使用 12 小時制將日期分組，依小時和分鐘分組，例如下午 7 點 45 分。系統會根據試算表語言代碼翻譯上午/下午標示。
DAY_OF_WEEK 依星期幾 (例如星期日) 分組日期。系統會根據試算表語言代碼翻譯星期幾。
DAY_OF_YEAR 依年內日期 (1 到 366) 分組。請注意，2 月 29 日之後的日期在閏年和平年會落在不同的區塊。
DAY_OF_MONTH 依月內日期 (1 到 31) 分組。
DAY_MONTH 依照日期和月份分組，例如 11 月 22 日。月份會根據試算表語言代碼進行翻譯。
MONTH 將日期依月份分組，例如 11 月。月份會根據試算表語言代碼進行翻譯。
QUARTER 將日期依季別分組，例如 Q1 (代表 1 月至 3 月)。
YEAR 依年份分組日期，例如 2008 年。
YEAR_MONTH 將日期依年和月分組，例如 2008 年 11 月。系統會根據試算表語言代碼轉譯月份。
YEAR_QUARTER 將日期依年份和季度分組，例如 2008 Q4。
YEAR_MONTH_DAY 將日期依年、月、日分組，例如 2008-11-22。

ChartHistogramRule

可將來源資料欄中的數值整理成固定大小的值區。

JSON 表示法 
{
  "minValue": number,
  "maxValue": number,
  "intervalSize": number
}
欄位
minValue

number

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

number

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

number

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

ChartAggregateType

圖表序列的匯總類型。

列舉
CHART_AGGREGATE_TYPE_UNSPECIFIED 預設值，請勿使用。
AVERAGE 平均匯總函式。
COUNT 計數匯總函式。
MAX 最大匯總函式。
MEDIAN 中位數匯總函式。
MIN 最小匯總函式。
SUM 匯總函式 Sum。

BasicChartSeries

圖表中的單一資料序列。舉例來說，如果要繪製一段時間內的股票價格圖表，可能會有多個資料列，分別代表「開盤價」、「最高價」、「最低價」和「收盤價」。

JSON 表示法 
{
  "series": {
    object (ChartData)
  },
  "targetAxis": enum (BasicChartAxisPosition),
  "type": enum (BasicChartType),
  "lineStyle": {
    object (LineStyle)
  },
  "dataLabel": {
    object (DataLabel)
  },
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "pointStyle": {
    object (PointStyle)
  },
  "styleOverrides": [
    {
      object (BasicSeriesDataPointStyleOverride)
    }
  ]
}
欄位
series

object (ChartData)

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

targetAxis

enum (BasicChartAxisPosition)

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

enum (BasicChartType)

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

object (LineStyle)

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

object (DataLabel)

這個系列叢書的資料標籤相關資訊。
color
(deprecated)

object (Color)

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

object (ColorStyle)

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

object (PointStyle)

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

object (BasicSeriesDataPointStyleOverride)

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

LineStyle

用來描述線條樣式的屬性。

JSON 表示法 
{
  "width": integer,
  "type": enum (LineDashType)
}
欄位
width

integer

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

enum (LineDashType)

線條的虛線類型。

LineDashType

線條的虛線類型。

列舉
LINE_DASH_TYPE_UNSPECIFIED 預設值，請勿使用。
INVISIBLE 無虛線類型，等同於不顯示線條。
CUSTOM 線條的自訂虛線。目前不支援修改確切的自訂虛線樣式。
SOLID 實線。
DOTTED 虛線。
MEDIUM_DASHED 虛線長度為「中等」。
MEDIUM_DASHED_DOTTED 以「中等」虛線和圓點交替的線條。
LONG_DASHED 虛線線段的長度為「長」。
LONG_DASHED_DOTTED 以「長」破折號和圓點交替排列的線條。

DataLabel

一組資料標籤的設定。資料標籤是顯示在資料集 (例如折線圖上的點) 旁的註解，可提供資料代表內容的其他資訊，例如圖表中該點後方值的文字表示方式。

JSON 表示法 
{
  "type": enum (DataLabelType),
  "textFormat": {
    object (TextFormat)
  },
  "placement": enum (DataLabelPlacement),
  "customLabelData": {
    object (ChartData)
  }
}
欄位
type

enum (DataLabelType)

資料標籤的類型。
textFormat

object (TextFormat)

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

enum (DataLabelPlacement)

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

object (ChartData)

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

DataLabelType

資料標籤的類型。

列舉
DATA_LABEL_TYPE_UNSPECIFIED 未指定資料標籤類型，系統會根據圖表中資料標籤的內容進行解讀。
NONE 系統不會顯示資料標籤。
DATA 資料標籤會使用序列資料中的值顯示。
CUSTOM 系統會使用 customLabelData 所指示的自訂資料來源的值，顯示資料標籤。

DataLabelPlacement

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

列舉
DATA_LABEL_PLACEMENT_UNSPECIFIED 算繪器會自動決定位置。
CENTER 水平和垂直置中於列或欄內。
LEFT 資料點左側。
RIGHT 資料點右側。
ABOVE 資料點上方。
BELOW 資料點下方。
INSIDE_END 在結尾的橫條或欄內 (正值為頂端，負值為底端)。
INSIDE_BASE 底部的列或欄內。
OUTSIDE_END 在結尾處的橫條或欄外。

PointStyle

圖表中資料點的樣式。

JSON 表示法 
{
  "size": number,
  "shape": enum (PointShape)
}
欄位
size

number

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

enum (PointShape)

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

PointShape

點的形狀。

列舉
POINT_SHAPE_UNSPECIFIED 預設值。
CIRCLE 圓形。
DIAMOND 鑽石形狀。
HEXAGON 六邊形。
PENTAGON 五邊形。
SQUARE 正方形。
STAR 星形。
TRIANGLE 三角形。
X_MARK X 形圖案。

BasicSeriesDataPointStyleOverride

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

JSON 表示法 
{
  "index": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "pointStyle": {
    object (PointStyle)
  }
}
欄位
index

integer

系列資料點的索引，從零開始。
color
(deprecated)

object (Color)

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

object (ColorStyle)

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

object (PointStyle)

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

BasicChartStackedType

堆疊圖表時，系統會將範圍 (垂直軸) 值彼此堆疊，而非從水平軸顯示。舉例來說，兩個值 20 和 80 會從 0 繪製，其中 80 與水平軸的距離為 80 個單位。如果是堆疊，則會從 20 顯示 80，將其從水平軸移開 100 個單位。

列舉
BASIC_CHART_STACKED_TYPE_UNSPECIFIED 預設值，請勿使用。
NOT_STACKED 系列叢書不會堆疊。
STACKED 序列值會堆疊，每個值會從下方值的頂端垂直顯示。
PERCENT_STACKED 垂直堆疊會拉伸至圖表頂端，且各個值會以百分比排列。

BasicChartCompareMode

比較模式類型，描述游標懸停在資料和圖表區域時，工具提示和資料醒目顯示的行為。

列舉
BASIC_CHART_COMPARE_MODE_UNSPECIFIED 預設值，請勿使用。
DATUM 只有已聚焦的資料元素會醒目顯示，並顯示在工具提示中。
CATEGORY 所有屬於相同類別 (例如網域值) 的資料元素都會醒目顯示，並顯示在工具提示中。

PieChartSpec

圓餅圖。

JSON 表示法 
{
  "legendPosition": enum (PieChartLegendPosition),
  "domain": {
    object (ChartData)
  },
  "series": {
    object (ChartData)
  },
  "threeDimensional": boolean,
  "pieHole": number
}
欄位
legendPosition

enum (PieChartLegendPosition)

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

object (ChartData)

涵蓋圓餅圖網域的資料。
series

object (ChartData)

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

boolean

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

number

圓餅圖中洞的大小。

PieChartLegendPosition

圖表圖例的位置。

列舉
PIE_CHART_LEGEND_POSITION_UNSPECIFIED 預設值，請勿使用。
BOTTOM_LEGEND 圖例會顯示在圖表底部。
LEFT_LEGEND 圖例會顯示在圖表左側。
RIGHT_LEGEND 圖例會顯示在圖表右側。
TOP_LEGEND 圖例會顯示在圖表頂端。
NO_LEGEND 系統不會算繪圖例。
LABELED_LEGEND 每個圓形區塊都會附上標籤。

BubbleChartSpec

泡泡圖。

JSON 表示法 
{
  "legendPosition": enum (BubbleChartLegendPosition),
  "bubbleLabels": {
    object (ChartData)
  },
  "domain": {
    object (ChartData)
  },
  "series": {
    object (ChartData)
  },
  "groupIds": {
    object (ChartData)
  },
  "bubbleSizes": {
    object (ChartData)
  },
  "bubbleOpacity": number,
  "bubbleBorderColor": {
    object (Color)
  },
  "bubbleBorderColorStyle": {
    object (ColorStyle)
  },
  "bubbleMaxRadiusSize": integer,
  "bubbleMinRadiusSize": integer,
  "bubbleTextStyle": {
    object (TextFormat)
  }
}
欄位
legendPosition

enum (BubbleChartLegendPosition)

圖表圖例的繪製位置。
bubbleLabels

object (ChartData)

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

object (ChartData)

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

object (ChartData)

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

object (ChartData)

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

object (ChartData)

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

number

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

object (Color)

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

object (ColorStyle)

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

integer

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

bubbleMinRadiusSize

integer

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

bubbleTextStyle

object (TextFormat)

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

BubbleChartLegendPosition

圖表圖例的位置。

列舉
BUBBLE_CHART_LEGEND_POSITION_UNSPECIFIED 預設值，請勿使用。
BOTTOM_LEGEND 圖例會顯示在圖表底部。
LEFT_LEGEND 圖例會顯示在圖表左側。
RIGHT_LEGEND 圖例會顯示在圖表右側。
TOP_LEGEND 圖例會顯示在圖表頂端。
NO_LEGEND 系統不會算繪圖例。
INSIDE_LEGEND 圖例會在圖表區域內顯示。

CandlestickChartSpec

K 線圖。

JSON 表示法 
{
  "domain": {
    object (CandlestickDomain)
  },
  "data": [
    {
      object (CandlestickData)
    }
  ]
}
欄位
domain

object (CandlestickDomain)

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

object (CandlestickData)

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

CandlestickDomain

CandlestickChart 的網域。

JSON 表示法 
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
欄位
data

object (ChartData)

CandlestickDomain 的資料。
reversed

boolean

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

CandlestickData

K 線圖資料，每個資料都包含一系列的最低價、開盤價、收盤價和最高價。

JSON 表示法 
{
  "lowSeries": {
    object (CandlestickSeries)
  },
  "openSeries": {
    object (CandlestickSeries)
  },
  "closeSeries": {
    object (CandlestickSeries)
  },
  "highSeries": {
    object (CandlestickSeries)
  }
}
欄位
lowSeries

object (CandlestickSeries)

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

openSeries

object (CandlestickSeries)

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

object (CandlestickSeries)

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

object (CandlestickSeries)

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

CandlestickSeries

CandlestickData 的系列。

JSON 表示法 
{
  "data": {
    object (ChartData)
  }
}
欄位
data

object (ChartData)

CandlestickSeries 的資料。

OrgChartSpec

組織圖。組織圖需要在 labels 中使用一組專屬標籤，並可視需要加入 parentLabels 和 tooltips。parentLabels 針對每個節點，包含標示父節點的標籤。tooltips 針對每個節點，包含選用的工具提示。

舉例來說，如要描述組織架構圖，其中 Alice 為執行長，Bob 為總裁 (向 Alice 負責)，Cathy 為業務副總裁 (同樣向 Alice 負責)，請將 labels 包含「Alice」、「Bob」、「Cathy」，parentLabels 包含「"Alice"」、「"Alice"」和「"Alice"」，tooltips 則包含「執行長」、「總裁」、「業務副總裁」。

JSON 表示法 
{
  "nodeSize": enum (OrgChartNodeSize),
  "nodeColor": {
    object (Color)
  },
  "nodeColorStyle": {
    object (ColorStyle)
  },
  "selectedNodeColor": {
    object (Color)
  },
  "selectedNodeColorStyle": {
    object (ColorStyle)
  },
  "labels": {
    object (ChartData)
  },
  "parentLabels": {
    object (ChartData)
  },
  "tooltips": {
    object (ChartData)
  }
}
欄位
nodeSize

enum (OrgChartNodeSize)

組織結構圖節點的大小。

nodeColor
(deprecated)

object (Color)

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

object (ColorStyle)

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

object (Color)

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

object (ColorStyle)

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

object (ChartData)

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

parentLabels

object (ChartData)

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

object (ChartData)

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

OrgChartNodeSize

組織結構圖節點的大小。

列舉
ORG_CHART_LABEL_SIZE_UNSPECIFIED 預設值，請勿使用。
SMALL 組織結構圖節點的縮小大小。
MEDIUM 中等組織結構圖節點大小。
LARGE 大型組織結構圖節點大小。

HistogramChartSpec

直方圖。直方圖會將資料項目分組成值區，並以堆疊項目的資料欄顯示每個值區。直方圖可用來顯示資料集的分布情形。每個項目欄代表該項目所屬的範圍。您可以自動選擇或明確指定區間數。

JSON 表示法 
{
  "series": [
    {
      object (HistogramSeries)
    }
  ],
  "legendPosition": enum (HistogramChartLegendPosition),
  "showItemDividers": boolean,
  "bucketSize": number,
  "outlierPercentile": number
}
欄位
series[]

object (HistogramSeries)

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

enum (HistogramChartLegendPosition)

圖例的位置。
showItemDividers

boolean

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

number

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

number

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

HistogramSeries

包含序列顏色和資料的直方圖序列。

JSON 表示法 
{
  "barColor": {
    object (Color)
  },
  "barColorStyle": {
    object (ColorStyle)
  },
  "data": {
    object (ChartData)
  }
}
欄位
barColor
(deprecated)

object (Color)

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

object (ColorStyle)

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

object (ChartData)

這個直方圖序列的資料。

HistogramChartLegendPosition

圖表圖例的位置。

列舉
HISTOGRAM_CHART_LEGEND_POSITION_UNSPECIFIED 預設值，請勿使用。
BOTTOM_LEGEND 圖例會顯示在圖表底部。
LEFT_LEGEND 圖例會顯示在圖表左側。
RIGHT_LEGEND 圖例會顯示在圖表右側。
TOP_LEGEND 圖例會顯示在圖表頂端。
NO_LEGEND 系統不會算繪圖例。
INSIDE_LEGEND 圖例會在圖表區域內顯示。

WaterfallChartSpec

瀑布圖。

JSON 表示法 
{
  "domain": {
    object (WaterfallChartDomain)
  },
  "series": [
    {
      object (WaterfallChartSeries)
    }
  ],
  "stackedType": enum (WaterfallChartStackedType),
  "firstValueIsTotal": boolean,
  "hideConnectorLines": boolean,
  "connectorLineStyle": {
    object (LineStyle)
  },
  "totalDataLabel": {
    object (DataLabel)
  }
}
欄位
domain

object (WaterfallChartDomain)

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

series[]

object (WaterfallChartSeries)

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

enum (WaterfallChartStackedType)

堆疊類型。
firstValueIsTotal

boolean

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

boolean

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

object (LineStyle)

連接線的線條樣式。
totalDataLabel

object (DataLabel)

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

WaterfallChartDomain

瀑布圖的網域。

JSON 表示法 
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
欄位
data

object (ChartData)

WaterfallChartDomain 的資料。
reversed

boolean

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

WaterfallChartSeries

刊登序列圖表的單一資料序列。

JSON 表示法 
{
  "data": {
    object (ChartData)
  },
  "positiveColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "negativeColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "subtotalColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "hideTrailingSubtotal": boolean,
  "customSubtotals": [
    {
      object (WaterfallChartCustomSubtotal)
    }
  ],
  "dataLabel": {
    object (DataLabel)
  }
}
欄位
data

object (ChartData)

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

positiveColumnsStyle

object (WaterfallChartColumnStyle)

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

object (WaterfallChartColumnStyle)

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

object (WaterfallChartColumnStyle)

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

boolean

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

object (WaterfallChartCustomSubtotal)

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

object (DataLabel)

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

WaterfallChartColumnStyle

瀑布圖欄的樣式。

JSON 表示法 
{
  "label": string,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
欄位
label

string

資料欄圖例的標籤。
color
(deprecated)

object (Color)

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

object (ColorStyle)

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

WaterfallChartCustomSubtotal

刊登序列圖表系列的自訂小計欄。

JSON 表示法 
{
  "subtotalIndex": integer,
  "label": string,
  "dataIsSubtotal": boolean
}
欄位
subtotalIndex

integer

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

label

string

小計欄的標籤。
dataIsSubtotal

boolean

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

WaterfallChartStackedType

堆疊類型的瀑布圖選項。

列舉
WATERFALL_STACKED_TYPE_UNSPECIFIED 預設值，請勿使用。
STACKED 對應相同網域 (水平軸) 值的值會垂直堆疊。
SEQUENTIAL 系列叢書會沿著水平軸分散開來。

TreemapChartSpec

樹狀圖。

JSON 表示法 
{
  "labels": {
    object (ChartData)
  },
  "parentLabels": {
    object (ChartData)
  },
  "sizeData": {
    object (ChartData)
  },
  "colorData": {
    object (ChartData)
  },
  "textFormat": {
    object (TextFormat)
  },
  "levels": integer,
  "hintedLevels": integer,
  "minValue": number,
  "maxValue": number,
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "colorScale": {
    object (TreemapChartColorScale)
  },
  "hideTooltips": boolean
}
欄位
labels

object (ChartData)

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

object (ChartData)

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

object (ChartData)

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

object (ChartData)

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

object (TextFormat)

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

integer

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

hintedLevels

integer

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

number

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

number

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

object (Color)

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

object (ColorStyle)

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

object (TreemapChartColorScale)

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

boolean

設為 True 可隱藏工具提示。

TreemapChartColorScale

樹狀圖圖表的色階。

JSON 表示法 
{
  "minValueColor": {
    object (Color)
  },
  "minValueColorStyle": {
    object (ColorStyle)
  },
  "midValueColor": {
    object (Color)
  },
  "midValueColorStyle": {
    object (ColorStyle)
  },
  "maxValueColor": {
    object (Color)
  },
  "maxValueColorStyle": {
    object (ColorStyle)
  },
  "noDataColor": {
    object (Color)
  },
  "noDataColorStyle": {
    object (ColorStyle)
  }
}
欄位
minValueColor
(deprecated)

object (Color)

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

object (ColorStyle)

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

object (Color)

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

object (ColorStyle)

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

object (Color)

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

object (ColorStyle)

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

object (Color)

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

object (ColorStyle)

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

ScorecardChartSpec

評量圖表。評量表圖表可用於在試算表中醒目顯示主要成效指標 (KPI)。評量表圖表可呈現總銷售額、平均成本或最暢銷的項目等資訊。您可以指定單一資料值，或匯總一組資料。您可以強調與基準值的百分比或絕對差異，例如時間變化。

JSON 表示法 
{
  "keyValueData": {
    object (ChartData)
  },
  "baselineValueData": {
    object (ChartData)
  },
  "aggregateType": enum (ChartAggregateType),
  "keyValueFormat": {
    object (KeyValueFormat)
  },
  "baselineValueFormat": {
    object (BaselineValueFormat)
  },
  "scaleFactor": number,
  "numberFormatSource": enum (ChartNumberFormatSource),
  "customFormatOptions": {
    object (ChartCustomNumberFormatOptions)
  }
}
欄位
keyValueData

object (ChartData)

評量板鍵/值的資料。
baselineValueData

object (ChartData)

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

enum (ChartAggregateType)

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

object (KeyValueFormat)

鍵值的格式設定選項。
baselineValueFormat

object (BaselineValueFormat)

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

number

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

enum (ChartNumberFormatSource)

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

object (ChartCustomNumberFormatOptions)

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

KeyValueFormat

鍵值的格式設定選項。

JSON 表示法 
{
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  }
}
欄位
textFormat

object (TextFormat)

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

object (TextPosition)

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

BaselineValueFormat

基準值的格式選項。

JSON 表示法 
{
  "comparisonType": enum (ComparisonType),
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  },
  "description": string,
  "positiveColor": {
    object (Color)
  },
  "positiveColorStyle": {
    object (ColorStyle)
  },
  "negativeColor": {
    object (Color)
  },
  "negativeColorStyle": {
    object (ColorStyle)
  }
}
欄位
comparisonType

enum (ComparisonType)

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

object (TextFormat)

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

object (TextPosition)

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

string

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

object (Color)

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

object (ColorStyle)

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

object (Color)

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

object (ColorStyle)

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

ComparisonType

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

列舉
COMPARISON_TYPE_UNDEFINED 預設值，請勿使用。
ABSOLUTE_DIFFERENCE 使用鍵和基準值之間的絕對差異。
PERCENTAGE_DIFFERENCE 使用關鍵字和基準值之間的百分比差異。

ChartNumberFormatSource

圖表屬性可用的數字格式來源選項。

列舉
CHART_NUMBER_FORMAT_SOURCE_UNDEFINED 預設值，請勿使用。
FROM_DATA 從資料繼承數字格式。
CUSTOM 套用 ChartCustomNumberFormatOptions 指定的自訂格式。

ChartCustomNumberFormatOptions

圖表屬性專用的自訂數字格式設定選項。

JSON 表示法 
{
  "prefix": string,
  "suffix": string
}
欄位
prefix

string

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

string

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

ChartHiddenDimensionStrategy

決定圖表應如何處理隱藏的來源資料列。隱藏的資料列包括手動隱藏和篩選器隱藏的資料列。

列舉
CHART_HIDDEN_DIMENSION_STRATEGY_UNSPECIFIED 預設值，請勿使用。
SKIP_HIDDEN_ROWS_AND_COLUMNS 圖表會略過隱藏的資料列和資料欄。
SKIP_HIDDEN_ROWS 圖表只會略過隱藏的資料列。
SKIP_HIDDEN_COLUMNS 圖表只會略過隱藏的資料欄。
SHOW_ALL 圖表不會略過任何隱藏的資料列或欄。

EmbeddedObjectBorder

沿著嵌入物件繪製的邊框。

JSON 表示法 
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
欄位
color
(deprecated)

object (Color)

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

object (ColorStyle)

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