グラフを操作したい（newChart）
1const range = sheet.getRange("A1:B10");
2
3const chart = sheet.newChart()
4 .asBarChart()
5 .addRange(range)
6 .setNumHeaders(1) // 見出しに使う行数を設定
7 .setPosition(1, 4, 0, 0) // (行番号, 列番号, オフセットX, オフセットY)
8 .setOption("height", 300)
9 .setOption("width", 500)
10 .setOption("title", "グラフタイトル")
11 .build();
12
13sheet.insertChart(chart);
Sheet.newChartでグラフ（のビルダー）を新しく作成し、
Sheet.insertChartでシートに挿入します。
グラフの種類を変更したい（setChartType）
1const chart = sheet.newChart()
2 .setChartType(Charts.ChartType.PIE)
3 .addRange(range)
4 .build();
setChartTypeでグラフの種類を設定できます。
設定値はCharts.ChartTypeの列挙型を指定します。
プロパティ |
説明 |
|---|---|
|
時系列グラフ |
|
横棒グラフ |
|
縦棒グラフ |
|
ヒストグラム |
|
円グラフ |
|
散布図 |
1// 面グラフ
2sheet.newChart().asAreaChart()
3
4// 棒グラフ
5sheet.newChart().asBarChart()
6sheet.newChart().asColumnChart()
7
8// ヒストグラム
9sheet.newChart().asHistogramChart()
グラフを作成するときにasTYPEChartでも指定できます。
setChartTypeを使うかasTYPEChartを使うかは好みの問題です。
棒グラフにしたい（asBarChart / asColumnChart）
1const range = sheet.getRange("A1:B10");
2
3// 横棒グラフ
4const barChart = sheet.newChart()
5 .asBarChart()
6 .addRange(range)
7 .setNumHeaders(1)
8 .setOption("title", "横棒グラフ")
9 .build();
10sheet.insertChart(barChart);
11
12// 縦棒グラフ
13const columnChart = sheet.newChart()
14 .asColumnChart()
15 .addRange(range)
16 .setNumHeaders(1)
17 .setOption("title", "縦棒グラフ")
18 .build();
19sheet.insertChart(columnChart);
asBarChartで横棒グラフ、asColumnChartで縦棒グラフを作成できます。
カテゴリごとの数値を比較したいときによく使います。
散布図にしたい（asScatterChart）
1const range = sheet.getRange("A1:B10");
2
3const scatterChart = sheet.newChart()
4 .asScatterChart()
5 .addRange(range)
6 .setNumHeaders(1)
7 .setOption("title", "散布図")
8 .build();
9sheet.insertChart(scatterChart);
asScatterChartで散布図を作成できます。
2つの数値データの相関関係を確認したいときによく使います。
ヒストグラムにしたい（asHistogramChart）
1const range = sheet.getRange("A1:A10");
2
3const histogramChart = sheet.newChart()
4 .asHistogramChart()
5 .addRange(range)
6 .setNumHeaders(1)
7 .setOption("title", "ヒストグラム")
8 .build();
9sheet.insertChart(histogramChart);
asHistogramChartでヒストグラムを作成できます。
データの分布（度数分布）を確認したいときによく使います。
バブル図にしたい（Charts.ChartType.BUBBLE）
1// 1列目: ID（ラベル）, 2列目: X, 3列目: Y, 4列目: サイズ（省略可）
2const range = sheet.getRange("A1:D10");
3
4const bubbleChart = sheet.newChart()
5 .setChartType(Charts.ChartType.BUBBLE)
6 .addRange(range)
7 .setNumHeaders(1)
8 .setOption("title", "バブル図")
9 .build();
10sheet.insertChart(bubbleChart);
EmbeddedChartBuilder（sheet.newChart()）にasBubbleChartのような専用メソッドはありませんが、
setChartTypeにCharts.ChartType.BUBBLEを渡すことでバブル図を作成できます。
データの列構成は、1列目からID（ラベル）・X値・Y値の順で、 4列目に大きさ（バブルのサイズ）、5列目に系列や色を指定できます。 X値・Y値の2列は必須で、それ以外は省略可能です。