這項服務可讓使用者使用 Google 圖表工具建立圖表,並在伺服器端顯示。如果您想在網路瀏覽器中算繪圖表,請改用 Google 圖表 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 | 在指令碼中建立圖表的進入點。 |
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 物件的建構工具。 |
Area Chart Builder
方法
Bar Chart Builder
方法
Chart
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
get | Blob | 將此物件內的資料傳回為轉換為指定內容類型的 Blob。 |
get | Blob | 將此物件內的資料以 blob 格式傳回。 |
get | Chart | 傳回這張圖表的選項,例如高度、顏色和軸。 |
Chart Hidden Dimension Strategy
屬性
屬性 | 類型 | 說明 |
---|---|---|
IGNORE_BOTH | Enum | 預設值;圖表會略過所有隱藏的資料欄和資料列。 |
IGNORE_ROWS | Enum | 圖表只會略過隱藏的資料列。 |
IGNORE_COLUMNS | Enum | 圖表只會略過隱藏的資料欄。 |
SHOW_BOTH | Enum | 圖表不會略過隱藏的資料欄或資料列。 |
Chart Merge Strategy
屬性
屬性 | 類型 | 說明 |
---|---|---|
MERGE_COLUMNS | Enum | 預設值。 |
MERGE_ROWS | Enum | 圖表會合併多個區間的資料列。 |
Chart Options
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
get(option) | Object | 傳回這張圖表的已設定選項。 |
get | Object | 傳回這張圖表的已設定選項。 |
Chart Type
屬性
屬性 | 類型 | 說明 |
---|---|---|
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 圖表工具說明文件所述。 |
new | Bar | 開始建立長條圖,如 Google 圖表工具說明文件所述。 |
new | Column | 開始建立資料欄圖表,如 Google 圖表工具說明文件所述。 |
new | Data | 建立空白資料表格,可手動設定值。 |
new | Data | 建立新的資料檢視定義。 |
new | Line | 開始建立折線圖,如 Google 圖表工具說明文件所述。 |
new | Pie | 開始建立圓餅圖,如 Google 圖表工具說明文件所述。 |
new | Scatter | 開始建構散布圖,如 Google 圖表工具說明文件所述。 |
new | Table | 開始建立表格圖表,如 Google 圖表工具說明文件所述。 |
new | Text | 建立新的文字樣式建構工具。 |
Column Chart Builder
方法
Column Type
屬性
屬性 | 類型 | 說明 |
---|---|---|
DATE | Enum | 對應至日期值。 |
NUMBER | Enum | 對應至數值。 |
STRING | Enum | 對應字串值。 |
Curve Style
屬性
屬性 | 類型 | 說明 |
---|---|---|
NORMAL | Enum | 沒有曲線的直線。 |
SMOOTH | Enum | 線條的角度會經過平滑處理。 |
Data Table
Data Table Builder
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
add | Data | 在資料表中新增資料欄。 |
add | Data | 在資料表中新增資料列。 |
build() | Data | 建構並傳回資料表。 |
set | Data | 在表格中設定特定值。 |
Data Table Source
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
get | Data | 將這個物件內的資料以 DataTable 的形式傳回。 |
Data View Definition
Data View Definition Builder
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
build() | Data | 使用此建構工具建構並傳回資料檢視定義物件。 |
set | Data | 設定要納入資料檢視畫面的資料欄索引,以及指定角色欄位資訊。 |
Line Chart Builder
方法
Match Type
屬性
屬性 | 類型 | 說明 |
---|---|---|
EXACT | Enum | 僅比對完全相符的值 |
PREFIX | Enum | 從值開頭開始比對前置字串 |
ANY | Enum | 比對任何子字串 |
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
get | String | 傳回要在選項 JSON 中使用的比對類型名稱。 |
Number Range Filter Builder
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
set | Number | 設定範圍下限的最大允許值。 |
set | Number | 設定範圍下限的最小允許值。 |
set | Number | 設定滑桿方向。 |
set | Number | 設定是否要在滑桿旁邊顯示所選範圍的範圍標籤。 |
set | Number | 設定數字範圍篩選器滑桿可落在的刻度數量 (範圍列中的固定位置)。 |
Orientation
屬性
屬性 | 類型 | 說明 |
---|---|---|
HORIZONTAL | Enum | 水平方向。 |
VERTICAL | Enum | 直向。 |
Picker Values Layout
屬性
屬性 | 類型 | 說明 |
---|---|---|
ASIDE | Enum | 所選值會顯示在值挑選器小工具旁的單一文字行中。 |
BELOW | Enum | 選取的值會顯示在小工具下方的單行文字中。 |
BELOW_WRAPPING | Enum | 與下方類似,但無法在挑選器中顯示的項目會換行。 |
BELOW_STACKED | Enum | 選取的值會顯示在小工具下方的資料欄中。 |
Pie Chart Builder
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
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 | 設定圖表標題的文字樣式。 |
Point Style
屬性
屬性 | 類型 | 說明 |
---|---|---|
NONE | Enum | 不要顯示線條點。 |
TINY | Enum | 使用極小的線條點。 |
MEDIUM | Enum | 使用中等大小的線條點。 |
LARGE | Enum | 使用大型線條點。 |
HUGE | Enum | 使用最大尺寸的線條點。 |
Position
屬性
屬性 | 類型 | 說明 |
---|---|---|
TOP | Enum | 在圖表上方。 |
RIGHT | Enum | 位於圖表右側。 |
BOTTOM | Enum | 圖表下方。 |
NONE | Enum | 不會顯示圖例。 |
Scatter Chart Builder
方法
String Filter Builder
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
set | String | 設定比對作業是否要區分大小寫。 |
set | String | 設定控制項是否只應比對完全相符的值 (Match )、從值開頭開始的前置字串 (Match ) 或任何子字串 (Match )。 |
set | String | 設定控件是否應在每次按下按鍵時或僅在輸入欄位「變更」時 (失去焦點或按下 Enter 鍵) 進行比對。 |
Table Chart Builder
方法
Text Style
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
get | String | 取得文字樣式的顏色。 |
get | String | 取得文字樣式的字型名稱。 |
get | Number | 取得文字樣式的字型大小。 |
Text Style Builder
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
build() | Text | 建構並傳回使用此建構工具建構的文字樣式設定物件。 |
set | Text | 設定文字樣式的顏色。 |
set | Text | 設定文字樣式的字型名稱。 |
set | Text | 設定文字樣式的字型大小。 |