這項服務可讓使用者透過 Google 圖表工具 建立圖表,並在伺服器端算繪。如要在網頁瀏覽器中算繪圖表,請改用 Google Charts API。
這個範例會建立基本資料表、使用資料填入面積圖,並以圖片形式新增至網頁:
function doGet() {
var data = Charts.newDataTable()
.addColumn(Charts.ColumnType.STRING, 'Month')
.addColumn(Charts.ColumnType.NUMBER, 'In Store')
.addColumn(Charts.ColumnType.NUMBER, 'Online')
.addRow(['January', 10, 1])
.addRow(['February', 12, 1])
.addRow(['March', 20, 2])
.addRow(['April', 25, 3])
.addRow(['May', 30, 4])
.build();
var chart = Charts.newAreaChart()
.setDataTable(data)
.setStacked()
.setRange(0, 40)
.setTitle('Sales per Month')
.build();
var htmlOutput = HtmlService.createHtmlOutput().setTitle('My Chart');
var imageData = Utilities.base64Encode(chart.getAs('image/png').getBytes());
var imageUrl = "data:image/png;base64," + encodeURI(imageData);
htmlOutput.append("Render chart server side: <br/>");
htmlOutput.append("<img border=\"1\" src=\"" + imageUrl + "\">");
return htmlOutput;
}類別
| 名稱 | 簡短說明 |
|---|---|
Area | 面積圖的建構工具。 |
Bar | 長條圖的建構工具。 |
Chart | 圖表物件,可轉換為靜態圖片。 |
Chart | 列舉來源中隱藏維度在圖表中的表示方式。 |
Chart | 列舉圖表中多個來源範圍的表示方式。 |
Chart | 顯示目前為 Chart 設定的選項,例如高度、顏色等。 |
Chart | Charts 服務支援的圖表類型。 |
Charts | 在指令碼中建立圖表的進入點。 |
Column | 直條圖的建構工具。 |
Column | Data 中資料欄的有效資料類型列舉。 |
Curve | 圖表中曲線樣式的列舉。 |
Data | 圖表使用的資料表。 |
Data | DataTable 物件的建構工具。 |
Data | 介面適用於可將資料表示為 Data 的物件。 |
Data | 用於顯示圖表資料的資料檢視定義。 |
Data | Data 物件的建構工具。 |
Line | 折線圖的建構工具。 |
Match | 列舉字串值的比對方式。 |
Number | 數字範圍篩選器控制項的建構工具。 |
Orientation | 物件方向的列舉。 |
Picker | 列舉如何在挑選器小工具中顯示所選值。 |
Pie | 圓餅圖的建構工具。 |
Point | 列舉線條中點的樣式。 |
Position | 圖表中的圖例位置列舉。 |
Scatter | 散布圖的建構工具。 |
String | 字串篩選器控制項的建構工具。 |
Table | 表格圖表的建構工具。 |
Text | 文字樣式設定物件。 |
Text | 用於建立 Text 物件的建構工具。 |
AreaChartBuilder
方法
BarChartBuilder
方法
Chart
方法
| 方法 | 傳回類型 | 簡短說明 |
|---|---|---|
get | Blob | 以轉換為指定內容類型的 Blob 形式,傳回這個物件內的資料。 |
get | Blob | 將這個物件內的資料以 Blob 形式傳回。 |
get | Chart | 傳回這張圖表的選項,例如高度、顏色和座標軸。 |
ChartHiddenDimensionStrategy
屬性
| 屬性 | 類型 | 說明 |
|---|---|---|
IGNORE_BOTH | Enum | 預設值;圖表會略過所有隱藏的欄和列。 |
IGNORE_ROWS | Enum | 圖表只會略過隱藏的資料列。 |
IGNORE_COLUMNS | Enum | 圖表只會略過隱藏的資料欄。 |
SHOW_BOTH | Enum | 圖表不會略過隱藏的欄或列。 |
ChartMergeStrategy
屬性
| 屬性 | 類型 | 說明 |
|---|---|---|
MERGE_COLUMNS | Enum | 預設值。 |
MERGE_ROWS | Enum | 圖表會合併多個範圍的資料列。 |
ChartOptions
方法
| 方法 | 傳回類型 | 簡短說明 |
|---|---|---|
get(option) | Object | 傳回這張圖表的已設定選項。 |
get | Object | 傳回這張圖表的已設定選項。 |
ChartType
屬性
| 屬性 | 類型 | 說明 |
|---|---|---|
TIMELINE | Enum | 時間線圖。 |
AREA | Enum | 面積圖 |
BAR | Enum | 長條圖 |
BUBBLE | Enum | 泡泡圖。 |
CANDLESTICK | Enum | K 線圖。 |
COLUMN | Enum | 柱狀圖 |
COMBO | Enum | 組合圖 |
GAUGE | Enum | 度量圖。 |
GEO | Enum | 地理圖。 |
HISTOGRAM | Enum | 直方圖 |
RADAR | Enum | 雷達圖。 |
LINE | Enum | 折線圖 |
ORG | Enum | 組織圖。 |
PIE | Enum | 圓餅圖 |
SCATTER | Enum | 散佈圖 |
SPARKLINE | Enum | 走勢圖。 |
STEPPED_AREA | Enum | 階梯狀面積圖。 |
TABLE | Enum | 表格圖 |
TREEMAP | Enum | 樹狀圖。 |
WATERFALL | Enum | 瀑布圖。 |
Charts
屬性
| 屬性 | 類型 | 說明 |
|---|---|---|
Chart | Chart | 列舉來源中隱藏維度在圖表中的表示方式。 |
Chart | Chart | 列舉圖表中多個來源範圍的表示方式。 |
Chart | Chart | 圖表服務支援的圖表類型列舉。 |
Column | Column | Data 中資料欄的有效資料類型列舉。 |
Curve | Curve | 圖表中曲線樣式的列舉。 |
Point | Point | 列舉線條中點的樣式。 |
Position | Position | 圖表中的圖例位置列舉。 |
方法
| 方法 | 傳回類型 | 簡短說明 |
|---|---|---|
new | Area | 如要開始建構面積圖,請參閱 Google Chart Tools 說明文件。 |
new | Bar | 按照 Google Chart Tools 說明文件中的步驟,開始建構長條圖。 |
new | Column | 按照 Google Chart Tools 說明文件中的步驟,開始建立柱狀圖。 |
new | Data | 建立空白資料表,可手動設定值。 |
new | Data | 建立新的資料檢視定義。 |
new | Line | 按照 Google Chart Tools 說明文件中的步驟,開始建構折線圖。 |
new | Pie | 開始建構圓餅圖,詳情請參閱 Google Chart Tools 說明文件。 |
new | Scatter | 如要開始建構散布圖,請參閱 Google Chart Tools 說明文件。 |
new | Table | 按照 Google Chart Tools 說明文件中的步驟,開始建構表格圖表。 |
new | Text | 建立新的文字樣式建構工具。 |
ColumnChartBuilder
方法
ColumnType
屬性
| 屬性 | 類型 | 說明 |
|---|---|---|
DATE | Enum | 對應日期值。 |
NUMBER | Enum | 對應至數值。 |
STRING | Enum | 對應字串值。 |
CurveStyle
屬性
| 屬性 | 類型 | 說明 |
|---|---|---|
NORMAL | Enum | 沒有彎曲的直線。 |
SMOOTH | Enum | 線條的角度會變得平滑。 |
DataTable
DataTableBuilder
方法
| 方法 | 傳回類型 | 簡短說明 |
|---|---|---|
add | Data | 在資料表中新增資料欄。 |
add | Data | 在資料表中新增資料列。 |
build() | Data | 建構並傳回資料表。 |
set | Data | 在表格中設定特定值。 |
DataTableSource
方法
| 方法 | 傳回類型 | 簡短說明 |
|---|---|---|
get | Data | 將這個物件內的資料傳回為 DataTable。 |
DataViewDefinition
DataViewDefinitionBuilder
方法
| 方法 | 傳回類型 | 簡短說明 |
|---|---|---|
build() | Data | 建構並傳回使用這個建構工具建構的資料檢視定義物件。 |
set | Data | 設定要納入資料檢視畫面的資料欄索引,並指定角色資料欄資訊。 |
LineChartBuilder
方法
MatchType
屬性
| 屬性 | 類型 | 說明 |
|---|---|---|
EXACT | Enum | 僅比對完全相符的值 |
PREFIX | Enum | 從值的開頭開始比對前置字串 |
ANY | Enum | 符合任何子字串 |
方法
| 方法 | 傳回類型 | 簡短說明 |
|---|---|---|
get | String | 傳回要在選項 JSON 中使用的比對類型名稱。 |
NumberRangeFilterBuilder
方法
| 方法 | 傳回類型 | 簡短說明 |
|---|---|---|
set | Number | 設定範圍下限允許的最大值。 |
set | Number | 設定範圍下限允許的最小值。 |
set | Number | 設定滑桿方向。 |
set | Number | 設定是否要在滑桿旁邊顯示標籤,指出所選範圍的程度。 |
set | Number | 設定數字範圍篩選器滑桿拇指可落入的刻度數 (範圍列中的固定位置)。 |
Orientation
屬性
| 屬性 | 類型 | 說明 |
|---|---|---|
HORIZONTAL | Enum | 橫向螢幕方向。 |
VERTICAL | Enum | 直向。 |
PickerValuesLayout
屬性
| 屬性 | 類型 | 說明 |
|---|---|---|
ASIDE | Enum | 選取的值會顯示在值選擇器小工具旁的單行文字中。 |
BELOW | Enum | 選取的值會顯示在小工具下方的單行文字中。 |
BELOW_WRAPPING | Enum | 與下方類似,但無法容納在挑選器中的項目會換行。 |
BELOW_STACKED | Enum | 選取的值會顯示在小工具下方的資料欄中。 |
PieChartBuilder
方法
| 方法 | 傳回類型 | 簡短說明 |
|---|---|---|
build() | Chart | 建構圖表。 |
reverse | Pie | 反轉網域軸中數列的繪製方式。 |
set3D() | Pie | 將圖表設為 3D。 |
set | Pie | 設定圖表的背景顏色。 |
set | Pie | 設定圖表中線條的顏色。 |
set | Pie | 設定用於從外部來源 (例如 Google 試算表) 擷取資料的資料來源網址。 |
set | Pie | 使用 DataTableBuilder 設定要用於圖表的資料表。 |
set | Pie | 設定包含圖表線條和 X 軸標籤的資料表。 |
set | Pie | 設定要用於圖表的資料檢視定義。 |
set | Pie | 設定圖表的尺寸。 |
set | Pie | 設定圖例相對於圖表的位置。 |
set | Pie | 設定圖表圖例的文字樣式。 |
set | Pie | 設定這張圖表的進階選項。 |
set | Pie | 設定圖表的標題。 |
set | Pie | 設定圖表標題的文字樣式。 |
PointStyle
屬性
| 屬性 | 類型 | 說明 |
|---|---|---|
NONE | Enum | 不要顯示線條點。 |
TINY | Enum | 使用細線點。 |
MEDIUM | Enum | 使用中型線點。 |
LARGE | Enum | 使用大型線點。 |
HUGE | Enum | 使用最大的線點。 |
Position
屬性
| 屬性 | 類型 | 說明 |
|---|---|---|
TOP | Enum | 圖表上方。 |
RIGHT | Enum | 圖表右側。 |
BOTTOM | Enum | 圖表下方。 |
NONE | Enum | 不會顯示圖例。 |
ScatterChartBuilder
方法
StringFilterBuilder
方法
| 方法 | 傳回類型 | 簡短說明 |
|---|---|---|
set | String | 設定比對是否應區分大小寫。 |
set | String | 設定控制項是否應只比對確切值 (Match)、從值開頭開始比對前置字串 (Match),或比對任何子字串 (Match)。 |
set | String | 設定控制項是否應在每次按下按鍵時比對,或僅在輸入欄位「變更」時比對 (失去焦點或按下 Enter 鍵)。 |
TableChartBuilder
方法
TextStyle
方法
| 方法 | 傳回類型 | 簡短說明 |
|---|---|---|
get | String | 取得文字樣式的顏色。 |
get | String | 取得文字樣式的字型名稱。 |
get | Number | 取得文字樣式的字型大小。 |
TextStyleBuilder
方法
| 方法 | 傳回類型 | 簡短說明 |
|---|---|---|
build() | Text | 建構並傳回使用這個建構工具建立的文字樣式設定物件。 |
set | Text | 設定文字樣式的顏色。 |
set | Text | 設定文字樣式的字型名稱。 |
set | Text | 設定文字樣式的字型大小。 |