Google App ScriptはGoogleスプレッドシートなどで使えるプログラミング言語になります。マクロ的な使い方もできますし、外部サービスと連携したり、GETやPOSTを使ったWeb APIインタフェースを追加することもできます。
Google App Script用SDKはv8エンジン版を開発中です(v8エンジン非対応版は開発停止中)。今回は更新時の専用オペレーションに対応したので、その使い方を紹介します。
コードについて
コードはNCMBMania/ncmb_gas: Google Apps Script(v8対応版)のコードです。にアップロードしてあります。TypeScriptで書かれています。
コードは google/clasp: 🔗 Command Line Apps Script Projects を使ってGoogle Apps Script用のコードに変換しています。
使い方
スクリプトのIDは 1Z8Lezd0OS6qm9W0EVQxBGx1gztqD14kXPfQxycr_rc2atOfKujiWZe7I
になります。基本的に最新版を使うようにしてください。
初期化
以下はプリフィックスをNCMBとした場合のコードです。
const ncmb = NCMB.init('APPLICATION_KEY', 'CLIENT_KEY');
データストアの使い方
まずはベーシックなデータストアの使い方です。
const test = ncmb.Object('Test'); test .set('msg', 'こんにちは、世界!') .save();
更新時の専用オペレーションとは
データを保存した後は次のような機能が利用できます。SDKを使っている場合は、データ作成前にも擬似的に利用できます。
- インクリメンタル
- 配列に値を追加
- 配列に値を追加(ユニークなもののみ)
- 配列から値を削除
これらを実現するメソッドを追加しました。
// インクリメンタル item.setIncrement('number', 2) // 配列に値を追加 item.add('array', [4, 2]) // 配列に値を追加(ユニークなもののみ) item.addUnique('array', 2) // 配列から値を削除 item.remove('array', 2)
なお、データストアに反映するためには save
メソッドで保存する必要があります。
まとめ
小さな機能ですが、データストアをより便利に使ってもらう際に便利な機能になるはずです。ぜひGoogle Apps Script上でお使いください!