Charts

{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  },
  "border": {
    object (EmbeddedObjectBorder)
  }
}

integer

圖表的 ID。

object (ChartSpec)

圖表的規格。

object (EmbeddedObjectPosition)

圖表的位置。

object (EmbeddedObjectBorder)

圖表的邊框。

{
  "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.
}

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)

評量表圖表規格。

{
  "horizontalAlignment": enum (HorizontalAlign)
}

enum (HorizontalAlign)

文字的水平對齊設定。

{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}

string

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

object (DataExecutionStatus)

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

{
  "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)
  }
}

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 Nor placement 可以在 totalDataLabel。

{
  "position": enum (BasicChartAxisPosition),
  "title": string,
  "format": {
    object (TextFormat)
  },
  "titleTextPosition": {
    object (TextPosition)
  },
  "viewWindowOptions": {
    object (ChartAxisViewWindowOptions)
  }
}

enum (BasicChartAxisPosition)

這個軸的位置。

string

這個軸的標題。設定後，這個值會覆寫從資料標頭推測出的任何標題。

object (TextFormat)

標題的格式，只有在軸未與網域建立關聯的情況下，這個變數才算有效。不支援連結欄位。

object (TextPosition)

軸標題文字位置。

object (ChartAxisViewWindowOptions)

這個軸的檢視視窗選項。

{
  "viewWindowMin": number,
  "viewWindowMax": number,
  "viewWindowMode": enum (ViewWindowMode)
}

number

這個檢視視窗要顯示的最小值。如未設定，系統會自動決定適合資料使用的最小值。

number

這個檢視視窗顯示的最大數值。如未設定，系統會自動決定適合資料使用的最大值。

enum (ViewWindowMode)

檢視畫面視窗的模式。

{
  "domain": {
    object (ChartData)
  },
  "reversed": boolean
}

object (ChartData)

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

boolean

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

{
  "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.
}

object (ChartGroupRule)

如果 ChartData 傳回資料來源圖表的網域，則將資料分組的規則。僅適用於資料來源圖表。

enum (ChartAggregateType)

資料來源一系列圖表的匯總類型。僅適用於資料來源圖表。

object (ChartSourceRange)

資料的來源範圍，

object (DataSourceColumnReference)

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

{
  "sources": [
    {
      object (GridRange)
    }
  ]
}

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

{

  // 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.
}

object (ChartDateTimeRule)

A 罩杯 ChartDateTimeRule。

object (ChartHistogramRule)

A 罩杯 ChartHistogramRule

{
  "type": enum (ChartDateTimeRuleType)
}

enum (ChartDateTimeRuleType)

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

{
  "minValue": number,
  "maxValue": number,
  "intervalSize": number
}

number

項目放入值區的最小值。小於最小值的值會歸到單一特徵分塊。如果省略，則是由最低商品值決定。

number

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

number

建立的值區大小。必須為正數。

{
  "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)
    }
  ]
}

object (ChartData)

此圖表系列中以視覺化方式呈現的資料。

enum (BasicChartAxisPosition)

指定這個序列值範圍的小軸。舉例來說，如果要繪製歷來股票圖表，「數量」建議您將系列叢書向右固定，並將價格固定在左側，因為交易量規模與價格規模不同。為圖表指定的軸不是有效次要軸並會發生錯誤 type。

enum (BasicChartType)

這個系列的類型。本優惠僅適用於 chartType 為 COMBO。不同的類型會變更系列的視覺化呈現方式。僅限 LINE, AREA和 COLUMN 支援。

object (LineStyle)

這個系列的線條樣式。本優惠僅適用於 chartType 為 AREA, LINE，或 SCATTER。 COMBO 如果 series chart type 為 AREA 或 LINE。

object (DataLabel)

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

object (Color)

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

object (ColorStyle)

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

object (PointStyle)

與此系列相關聯的點的樣式。本優惠僅適用於 chartType 為 AREA, LINE，或 SCATTER。 COMBO 如果 series chart type 為 AREA, LINE，或 SCATTER。如果空白，系統會使用預設的點樣式。

object (BasicSeriesDataPointStyleOverride)

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

{
  "width": integer,
  "type": enum (LineDashType)
}

integer

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

enum (LineDashType)

線條的虛線類型。

{
  "type": enum (DataLabelType),
  "textFormat": {
    object (TextFormat)
  },
  "placement": enum (DataLabelPlacement),
  "customLabelData": {
    object (ChartData)
  }
}

enum (DataLabelType)

資料標籤的類型。

object (TextFormat)

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

enum (DataLabelPlacement)

資料標籤相對於加上標籤資料的位置。

object (ChartData)

要用於自訂標籤的資料。僅適用於以下情況： type 設為 CUSTOM。這項資料的長度必須與套用這個資料標籤的序列或其他元素相同。此外，如果序列已分割成多個來源範圍，則來源資料必須來自來源資料中的下一欄。舉例來說，如果序列是 B2:B4、E6:E8，則資料必須來自 C2:C4,F6:F8。

{
  "size": number,
  "shape": enum (PointShape)
}

number

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

enum (PointShape)

點形狀。如果留空或未指定值，系統會使用預設形狀。

{
  "index": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "pointStyle": {
    object (PointStyle)
  }
}

integer

序列資料點以零為基準的索引。

object (Color)

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

object (ColorStyle)

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

object (PointStyle)

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

{
  "legendPosition": enum (PieChartLegendPosition),
  "domain": {
    object (ChartData)
  },
  "series": {
    object (ChartData)
  },
  "threeDimensional": boolean,
  "pieHole": number
}

enum (PieChartLegendPosition)

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

object (ChartData)

涵蓋圓餅圖網域的資料。

object (ChartData)

涵蓋圓餅圖的一連串資料。

boolean

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

number

圓餅圖中的孔洞大小。

{
  "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)
  }
}

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)

說明圖示內的文字格式。不支援加上刪除線、底線和連結。

{
  "domain": {
    object (CandlestickDomain)
  },
  "data": [
    {
      object (CandlestickData)
    }
  ]
}

object (CandlestickDomain)

K 線圖的網域資料 (橫軸)。系統會將字串資料視為離散標籤，其他資料則會視為連續值。

object (CandlestickData)

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

{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}

object (ChartData)

CandlestickDomain 資料，

boolean

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

{
  "lowSeries": {
    object (CandlestickSeries)
  },
  "openSeries": {
    object (CandlestickSeries)
  },
  "closeSeries": {
    object (CandlestickSeries)
  },
  "highSeries": {
    object (CandlestickSeries)
  }
}

object (CandlestickSeries)

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

object (CandlestickSeries)

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

object (CandlestickSeries)

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

object (CandlestickSeries)

各 K 線的最高/最大值範圍資料 (垂直軸)。也就是上影線的頂端。

{
  "data": {
    object (ChartData)
  }
}

object (ChartData)

K 線圖的資料。

{
  "nodeSize": enum (OrgChartNodeSize),
  "nodeColor": {
    object (Color)
  },
  "nodeColorStyle": {
    object (ColorStyle)
  },
  "selectedNodeColor": {
    object (Color)
  },
  "selectedNodeColorStyle": {
    object (ColorStyle)
  },
  "labels": {
    object (ChartData)
  },
  "parentLabels": {
    object (ChartData)
  },
  "tooltips": {
    object (ChartData)
  }
}

enum (OrgChartNodeSize)

機構圖表節點大小。

object (Color)

機構圖表節點的顏色。已淘汰：使用 nodeColorStyle。

object (ColorStyle)

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

object (Color)

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

object (ColorStyle)

所選機構圖表節點的顏色。如果 selectedNodeColor 也會設定這個欄位，這個欄位的優先順序最高。

object (ChartData)

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

object (ChartData)

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

object (ChartData)

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

{
  "series": [
    {
      object (HistogramSeries)
    }
  ],
  "legendPosition": enum (HistogramChartLegendPosition),
  "showItemDividers": boolean,
  "bucketSize": number,
  "outlierPercentile": number
}

object (HistogramSeries)

直方圖的系列可以是單一一系列值，也可以是多個長度相同的序列，且包含序列名稱，後面接著要為該序列套用值區的值。

enum (HistogramChartLegendPosition)

圖表圖例的位置。

boolean

是否應在每個資料欄中的項目之間顯示水平分隔線。

number

系統預設會自動選擇區塊大小 (單一資料欄中堆疊的值範圍)，但這部分可能會在這裡遭到覆寫。例如：如果值區大小為 1.5，值區大小介於 0 至 1.5、1.5 至 3.0 之間，不得為負數。這是選填欄位。

number

離群百分位數的用途是確保離群值不會對值區大小的計算造成負面影響。舉例來說，如果將離群百分位數設為 0.05，表示計算值區時，數值的上半數和下 5%。圖表仍會包含這些值，並且會加入第一個或最後一個值區，而不是所屬值區。必須介於 0.0 至 0.5 之間。

{
  "barColor": {
    object (Color)
  },
  "barColorStyle": {
    object (ColorStyle)
  },
  "data": {
    object (ChartData)
  }
}

object (Color)

代表各值區中序列的資料欄顏色。這是選填欄位。已淘汰：使用 barColorStyle。

object (ColorStyle)

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

object (ChartData)

這個直方圖系列的資料。

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

object (WaterfallChartDomain)

刊登序列圖表的網域資料 (橫軸)。

object (WaterfallChartSeries)

這張瀑布圖以視覺化方式呈現的資料。

enum (WaterfallChartStackedType)

堆疊類型。

boolean

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

boolean

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

object (LineStyle)

連接線的線條樣式。

object (DataLabel)

控制是否要在堆疊圖表上顯示其他資料標籤，藉此加總網域軸上所有堆疊值的總價值。 stackedType 必須是 STACKED 且兩者皆非 CUSTOM Nor placement 可以在 totalDataLabel。

{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}

object (ChartData)

WaterfallChartDomain 的資料。

boolean

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

{
  "data": {
    object (ChartData)
  },
  "positiveColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "negativeColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "subtotalColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "hideTrailingSubtotal": boolean,
  "customSubtotals": [
    {
      object (WaterfallChartCustomSubtotal)
    }
  ],
  "dataLabel": {
    object (DataLabel)
  }
}

object (ChartData)

本系列文章中以視覺化方式呈現的資料。

object (WaterfallChartColumnStyle)

這個系列中所有資料欄的樣式，值為正值。

object (WaterfallChartColumnStyle)

這個系列中所有資料欄的樣式皆設為負值。

object (WaterfallChartColumnStyle)

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

boolean

設為 True 會從序列結尾隱藏小計欄。根據預設，每個數列的結尾處會顯示小計欄。將這個欄位設為 true，系統會隱藏這個序列的小計欄。

object (WaterfallChartCustomSubtotal)

本系列中的自訂小計欄。小計的定義順序並不重要。每個資料點只能定義一個小計。

object (DataLabel)

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

{
  "label": string,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}

string

資料欄圖例的標籤。

object (Color)

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

object (ColorStyle)

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

{
  "subtotalIndex": integer,
  "label": string,
  "dataIsSubtotal": boolean
}

integer

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

string

小計欄的標籤。

boolean

若資料點的資料點為 True subtotalIndex 就是小計如果為 false，系統會計算小計，並在資料點之後顯示。

{
  "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
}

object (ChartData)

包含樹狀圖儲存格標籤的資料。

object (ChartData)

包含樹狀圖儲存格的資料父項標籤。

object (ChartData)

決定每個樹狀圖資料儲存格大小的資料。這項資料必須是數字。系統不會顯示與非數值或遺漏資料相對應的儲存格。如果 colorData 未指定，此資料也會用於決定資料儲存格的背景顏色。

object (ChartData)

決定每個樹狀圖資料儲存格背景顏色的資料。這是選填欄位。如未指定 sizeData 用於決定背景顏色。如有指定，資料應為數字。 colorScale 會決定此資料中的值如何對應至資料儲存格背景顏色。

object (TextFormat)

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

integer

要在樹狀圖上顯示的資料層級數量。這些為互動式等級，會與標籤一起顯示。如未指定，預設值為 2。

integer

除了已加上標籤的層級外，還要顯示在樹狀圖圖表中的其他資料層級數量。這些等級不具有互動性，因此會在沒有標籤的情況下顯示。如未指定，預設為 0。

number

可能的資料最小值。如果儲存格的值小於這個值，儲存格則會套用與含有這個值的儲存格相同的顏色。如未指定，則會預設為 colorData 或 sizeData 如果 colorData 未指定任何 IP 位址。

number

可能的資料值上限。如果儲存格的值大於這個值，儲存格的顏色和值也會相同。如未指定，則預設值為 colorData，也就是 sizeData 如果 colorData 未指定任何 IP 位址。

object (Color)

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

object (ColorStyle)

標題儲存格的背景顏色。如果 headerColor 也會設定這個欄位，這個欄位的優先順序最高。

object (TreemapChartColorScale)

樹狀圖圖表中資料儲存格的色階。資料儲存格會根據色彩值指派顏色。這些顏色值的來源 colorData或 sizeData 如果 colorData 未指定任何 IP 位址。色彩值小於或等於的儲存格 minValue 將 minValueColor 設為背景色彩。所含顏色值的儲存格大於或等於 maxValue 將 maxValueColor 設為背景色彩。儲存格顏色值的儲存格範圍 minValue 和 maxValue 會顯示背景顏色的 minValueColor 和 maxValueColor，漸層的中點 midValueColor。缺少或非數字色彩值的儲存格會有 noDataColor 設為背景色彩。

boolean

設為 True 即可隱藏工具提示。

{
  "minValueColor": {
    object (Color)
  },
  "minValueColorStyle": {
    object (ColorStyle)
  },
  "midValueColor": {
    object (Color)
  },
  "midValueColorStyle": {
    object (ColorStyle)
  },
  "maxValueColor": {
    object (Color)
  },
  "maxValueColorStyle": {
    object (ColorStyle)
  },
  "noDataColor": {
    object (Color)
  },
  "noDataColorStyle": {
    object (ColorStyle)
  }
}

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

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

object (ChartData)

評量表鍵/值的資料。

object (ChartData)

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

enum (ChartAggregateType)

評量表圖表中重點和基準圖表資料的匯總類型。資料來源圖表不支援這個欄位。使用 ChartData.aggregateType 欄位 keyValueData 或 baselineValueData 而非資料來源圖表這是選填欄位。

object (KeyValueFormat)

鍵值的格式選項。

object (BaselineValueFormat)

基準值的格式選項。只有在下列情況中 baselineValueData 。

number

比例評量表鍵和基準值的值。舉例來說，可使用 10 的乘數將圖表中的所有值除以 10。這是選填欄位。

enum (ChartNumberFormatSource)

評量圖表使用的數字格式來源。這是選填欄位。

object (ChartCustomNumberFormatOptions)

評量圖表中的數字鍵/基準值自訂格式設定選項。只有在出現於 numberFormatSource 設為 CUSTOM。這是選填欄位。

{
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  }
}

object (TextFormat)

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

object (TextPosition)

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

{
  "comparisonType": enum (ComparisonType),
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  },
  "description": string,
  "positiveColor": {
    object (Color)
  },
  "positiveColorStyle": {
    object (ColorStyle)
  },
  "negativeColor": {
    object (Color)
  },
  "negativeColorStyle": {
    object (ColorStyle)
  }
}

enum (ComparisonType)

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

object (TextFormat)

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

object (TextPosition)

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

string

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

object (Color)

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

object (ColorStyle)

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

object (Color)

要使用的顏色，在基準值代表鍵/值發生負值的情況下。這是選填欄位。已淘汰：使用 negativeColorStyle。

object (ColorStyle)

要使用的顏色，如果基準值代表鍵/值出現負值變化，就會使用顏色。這是選填欄位。如果 negativeColor 也會設定這個欄位，這個欄位的優先順序最高。

{
  "prefix": string,
  "suffix": string
}

string

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

string

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

{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}

object (Color)

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

object (ColorStyle)

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