Google Apps Script入門 | 第32回.グラフ | Google Apps Script(GAS)の入門解説です



最終更新日:2016-12-21

第32回.グラフ

Google Apps Script で、スプレッドシートにグラフを挿入します。

スクリプトであまり凝ったレイアウトのグラフを作成しようとすると、結構大変になりますので、

そのような場合は、手動で作成したグラフをスクリプトで変更する等の工夫も必要です。



以下のきわめて単純な表をサンプルとして解説します。




グラフを扱うメソッドの概要

Sheetのメソッドを使います。

メソッド 簡単な説明
getCharts() シートのグラフの配列を返します。
insertChart(chart) シートに新しいグラフを追加します。
newChart() シートに新しいグラフを作成するためのビルダーを返します。
removeChart(chart) シートからグラフを削除します。
updateChart(chart) シート上のグラフを更新します。

グラフを新規作成・変更・削除する場合の概要は、以下の順にメソッドを使用します。

グラフを新規に作成する場合
・newChart()でEmbeddedChartBuilderを生成
・Builderのメソッドで各種設定
・insertChart(chart)でシートにグラフを挿入
グラフを変更する場合
・getCharts()でchart(グラフ)を取得
・chartのメソッドmodify()でEmbeddedChartBuilderを生成
・Builderのメソッドで各種設定
・updateChart(chart)でシートのグラフを変更
グラフを削除する場合
・getCharts()でchart(グラフ)を取得
・removeChart(chart)でシートのグラフを削除
EmbeddedChartBuilder
方法 簡単な説明
addRange(range) このビルダーによって表されるグラフに範囲を追加します。
asAreaChart() AreaChartするグラフの種類を設定し、返します。
asBarChart() BarChartコントロールにグラフの種類を設定し、返します
asColumnChart() ColumnChartのにグラフの種類を設定し、返します
asLineChart() 折れ線グラフにグラフの種類を設定し、返します
asPieChart() 円グラフにグラフの種類を設定し、返します
asScatterChart() ScatterChartするグラフの種類を設定し、返します
asTableChart() TableChartにグラフの種類を設定し、返します
build() それに対して行われたすべての変更を反映するために、グラフを作成します。
getChartType() 現在のグラフの種類を返します。
getContainer() チャートがシートに表示される場所カプセル化ContainerInfoを返します。
getRanges() 現在、このグラフのデータを提供する範囲のリストのコピーを返します。
removeRange(range) このビルダーによって表されるチャートから指定した範囲を削除します。
setChartType(type) グラフの種類を変更します。
Charts.ChartTypeの列挙型を指定します。
プロパティ 説明
AREA 面グラフ
BAR 棒グラフ
COLUMN カラムチャート
LINE 折れ線グラフ
PIE 円グラフ
SCATTER 散布図
TABLE 表チャート
setOption(option,value) このグラフの詳細オプションを設定します。
optionは、
チャートAPIのグラフギャラリーの利用可能なオプションのリストです。
setPosition(anchorRowPos,anchorColPos,offsetX,offsetY) チャートがシートに表示される場所変更、位置を設定します。


グラフを新規に作成

function mySample32_1() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var range = sheet.getRange(1, 1, 13, 2);
  var chart = sheet.newChart()
  .addRange(range)
  .setChartType(Charts.ChartType.LINE)
  .setOption('title', '売上推移')
  .setPosition(1, 4, 0, 0);
  sheet.insertChart(chart.build());
}


var chart = sheet.newChart()
これで、EmbeddedChartBuilderを生成しています。

.addRange(range); //データ範囲
.setChartType(Charts.ChartType.LINE); //折れ線グラフ
.setOption('title', '売上推移'); //タイトル
.setPosition(1, 4, 0, 0); //グラフ位置

.addRange(range) 〜 .setPosition(1, 4, 0, 0)
ここは、newChart()で生成したEmbeddedChartBuilderに対してのメソッドになっています。
従って、

行末に、;(セミコロン)を書きません

これは、

var chart = sheet.newChart();
chart.addRange(range);
chart.setChartType(Charts.ChartType.LINE);
chart.setOption('title', '売上推移');
chart.setPosition(1, 4, 0, 0);

このように、EmbeddedChartBuilderである変数chartを全てに指定したことと同じことになります。
少し理解しずらい記述になりますが、VBAでのWith構文と同じように考えると理解しやすいと思います。

setOption(option,value)について
optionは、
チャートAPIのグラフギャラリーの利用可能なオプションのリスト
このページの、
Configuration Options表のNameが、ここで指定するoptionになります。
非常に多くのoptionがありますので、必要になった時に調べて下さい。


グラフを変更する

function mySample32_2() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var chart = sheet.getCharts()[0];
  var newchart = chart
  .modify()
  .setChartType(Charts.ChartType.COLUMN)
  .build();
  sheet.updateChart(newchart);
}


var chart = sheet.getCharts()[0];
chart(グラフ)を取得しています。

.modify()
EmbeddedChartBuilderを生成しています。

.setChartType(Charts.ChartType.COLUMN)
棒グラフに変更しています。

.build()
設定した内容でグラフが作成されます。

sheet.updateChart(newchart)
シートに変更後のグラフを反映させます。

.modify().build()、この流れをしっかりと把握してください。


グラフを削除する

function mySample32_3() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var chart = sheet.getCharts()[0];
  sheet.removeChart(chart);
}
var chart = sheet.getCharts()[0];
chart(グラフ)を取得しています。

sheet.removeChart(chart)
chart(グラフ)を削除します。


グラフは様々な形式が作れますが、
あまり凝ったグラフを作ったとしても、「キレイだ」と言うだけでは意味がありません。
そのグラフで何を訴えたいのかを良く考えて作成しましょう。
シンプルなグラフの方が訴求力が高いという事も多いものです。




同じテーマ「Google Apps Script入門」の記事

第31回.入力規則
第33回.表示の固定
第34回.シート保護
第35回.スプレッドシートが非常に遅い、高速化するには
第36回.フォルダとファイルを扱う(DriveApp)
第37回.フォルダの一覧取得・作成・削除(Folder)
第38回.ファイルの一覧取得・削除(File)

新着記事 ・・・新着記事一覧を見る

変数とプロシージャーの命名について|ExcelマクロVBA技術解説(2月12日)
ファイルの一覧取得・削除(File)|Google Apps Script入門(1月24日)
フォルダの一覧取得・作成・削除(Folder)|Google Apps Script入門(1月24日)
フォルダとファイルを扱う(DriveApp)|Google Apps Script入門(1月24日)
スプレッドシートが非常に遅い、高速化するには|Google Apps Script入門(1月17日)
画像のトリミング(PictureFormat,Crop)|ExcelマクロVBAサンプル集(12月27日)
シート保護|Google Apps Script入門(12月24日)
表示の固定|Google Apps Script入門(12月24日)
グラフ|Google Apps Script入門(12月21日)
入力規則|Google Apps Script入門(12月13日)

アクセスランキング ・・・ ランキング一覧を見る

1.RangeとCellsの使い方|ExcelマクロVBA入門
2.最終行の取得(End,Rows.Count)|ExcelマクロVBA入門
3.徹底解説(VLOOKUP,MATCH,INDEX,OFFSET)|エクセル関数超技
4.Range以外の指定方法(Cells,Rows,Columns)|ExcelマクロVBA入門
5.セルの参照範囲を可変にする(OFFSET,COUNTA,MATCH)|エクセル関数超技
6.セルのコピー&値の貼り付け(PasteSpecial)|ExcelマクロVBA入門
7.変数とデータ型(Dim)|ExcelマクロVBA入門
8.ひらがな⇔カタカナの変換|エクセル基本操作
9.CSVの読み込み方法|ExcelマクロVBAサンプル集
10.VBAのFindメソッドの使い方には注意が必要です|ExcelマクロVBA技術解説




このサイトがお役に立ちましたら「シェア」「Bookmark」をお願いいたします。


記述には細心の注意をしたつもりですが、
間違いやご指摘がありましたら、「お問い合わせ」からお知らせいただけると幸いです。
なお、掲載のVBAコードは自己責任で使ってください。万一データ破損等の損害が発生しても責任は負いません。

↑ PAGE TOP