Article:

スプレッドシートをjsonとして出力するボタンを作る

2021/06/17

はじめに

こんにちは。ととがんまです。最近はこんな感じのゲームを作り始めました。

自分のVRMモデルがモクモクと作業してるところ見守るタイプの疑似拡大再生産箱庭ゲームができそう pic.twitter.com/wpCyMnAaWj
— ととがんま (@totegamma) May 8, 2021

このゲームを作るに当たり、こんな感じでアイテムや設置物等の情報をスプレッドシートで練っていました。

で、いざこれをjsonにしてゲーム内に持ち込みたいなーと思ってもアイテム数が多すぎてちょっと手打ちは大変です。しかも今後微調整したくなること間違いなしですから自動で書き出せると良いですね。

今回は、これをGoogle Apps Script(GAS)を用いて実現します。 GASはGoogleの様々なサービスと連携して使えるスクリプトで、実態はほぼほぼjavascriptです。

今回解説する問題

このようなスプレッドシート

を、このjsonに射影します。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28


{
    "items": [
        {
            "item1": "スペード",
            "item2": "ダイア",
            "item3": "クラブ",
            "item4": "ハート"
        },
        {
            "item1": "葉",
            "item2": "鈴",
            "item3": "ドングリ",
            "item4": "ハート"
        },
        {
            "item1": "盾",
            "item2": "鈴",
            "item3": "ドングリ",
            "item4": "バラ"
        },
        {
            "item1": "剣",
            "item2": "貨幣",
            "item3": "棍棒",
            "item4": "カップ"
        }
    ]
}

手順

まず、スクリプトを紐付けたいスプレッドシートを開き、「ツール>スクリプトエディタ」を選択します。

すると、新しいタブでApps Scriptの編集画面が開きます。

ここに自由にコーディングします。

使いそうな機能をまとめたサンプルコードを以下に示します。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32


function jsonOutput() {

	// 読み込み元のシートを名前で参照する
	var sheet = SpreadsheetApp.getActive().getSheetByName('シート1');

	var items = [];

	//A列の要素を2行目から順に見ていき、空要素までたどり着いたらやめる。
	for (var itr = 2; true; ++itr) {
		// getRange(row, col, numrows, numcols)
		// (row, col)番目のセルから、下方向にnumrows、右方向にnumcolsだけデータを取って.getValues()で二次元配列として返す。
		// このサンプルではnumrows=1としているので[0]でスライスして行だけの1次元配列を返している。
		var row = sheet.getRange(itr, 1, 1, 4).getValues()[0];
		if (row[0] == "") break;

		// 好きな形に射影する
		items.push({
			"item1": (row[0]) ? row[0] : "N/A",
			"item2": (row[1]) ? row[1] : "N/A",
			"item3": (row[2]) ? row[2] : "N/A",
			"item4": (row[3]) ? row[3] : "N/A"
		});
	}

	// 出力先のシート
	var newSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("ScriptOutput");
	if (!newSheet) { // シートがなければ新しく作る
		newSheet = SpreadsheetApp.getActiveSpreadsheet();
		newSheet.insertSheet("ScriptOutput");
	}
	newSheet.getRange("A1").setValue({"items": JSON.stringify(items)});
}