【初心者向けGAS】プロパティストアの概要とスクリプトプロパティの編集方法

2020.03.05 2018.05.19

photo credit: AdamCohn Red Chili Shop, Bucaramanga Colombia via photopin (license)

みなさん、こんにちは！
タカハシ(@ntakahashi0505)です。

初心者向けGoogle Apps Script入門として名言Botの作り方をお伝えしています。

前回の記事はコチラ。

【初心者向けGAS】時限式のイベントトリガーを設置して決まった時刻にBotを送信する方法

初心者向けGoogle Apps Scriptのシリーズとして、名言Botの作成の方法をお伝えしています。今回は、時限式のイベントトリガーを設置して決まった時刻にChatworkにBot送信する方法です。

インストーラブルトリガーを使って一定時間ごとにスクリプトを実行する方法についてお伝えしました。

さて、Botとしては完成と言っても良いのです。

ただ、APIトークン…コード内にベタ打ちしたくないですもん。

GASには、そういう取り扱い注意なやつを、いい感じに管理するプロパティストアという機能があるんです。

今回は、Google Apps Scriptのプロパティストアとは何か、またスクリプトプロパティの入力の方法についてお伝えします。

では、行ってみましょう！

プロパティストアとプロパティサービス
スクリプトプロパティ
まとめ
連載目次：超初心者向けGASでBotを作りながら基礎を学ぶ

プロパティストアとプロパティサービス

プロパティストアとは

GASではプロジェクトやドキュメントに紐付いてデータを格納しておくコードとは別の領域が用意されていて、それをプロパティストアといいます。

プロパティストアには、キーの役割を果たす「プロパティ」と「値」のペアを文字列形式で格納することができます。

ちょっとGASとかJavaScriptに詳しい方なら、オブジェクトと同じような形式だと気づくでしょう。

プロパティストアに格納するデータの例

で、どんなデータを格納すると良いかというと、例えば、現在連載中の名言BotのスクリプトでいうとAPIトークン。

記事内には「ここにAPIトークンを入力してください」ってしていたんですけど、全世界に晒すわけにはいかない、とっても厳重注意のやつですもん。

ブログ書いてなくても、うっかりコピペして晒してしまったりとかあるかも知れませんよね。

ってことは、コード内にベタで書きたくないわけです。

APIトークン以外にも、あとは

スクリプト内で使用するスプレッドシートやファイルのID
Gmailでメールを送信するメールアドレス
外部のデータベースに接続するための情報

といった情報も同様にベタ書きしたくないです。

こういったデータをコードではない管理しやすいところに保管することができる、その場所がプロパティストアというわけです。

プロパティストアの種類

プロパティストアには３つの種類があります。

以下表にまとめました。扱うデータの性質や用途によって、どれを使うかセレクトをします。

プロパティストア	場所	スクリプトエディタでの編集
スクリプトプロパティ	プロジェクト	可
ユーザープロパティ	プロジェクト×ユーザー	不可
ドキュメントプロパティ	ドキュメント	不可

スクリプトプロパティはスクリプトエディタのメニューから編集が可能ですが、その他のプロパティストアは編集できません。

ではどこで編集するかというと、後述する方法でGASのスクリプトから操作をするのです。

プロパティサービスとは

そして、そのプロパティストアのデータをGASから操作することができ、それがプロパティサービスです。

プロパティストアに登録してあるデータをプロパティをキーにして取得してきたり、またはデータの入力や編集をしたりといったことが可能です。

スクリプトプロパティ

プロパティストアにはいくつか種類がありますが、今回はプロジェクトにひもづく形でデータを保管できるスクリプトプロパティについてお伝えします。

スクリプトプロパティは、スクリプトエディタから入力・編集が可能ですよ。

練習として、Chatwork APIのトークンをスクリプトプロパティとして格納してみましょう。

プロジェクトのプロパティを開く

まず、スクリプトエディタのメニューで「ファイル」→「プロジェクトのプロパティ」を選択します。

すると「プロジェクトのプロパティ」というダイアログが開きます。

このダイアログでは、プロジェクトに関連する色んな情報を確認することができるのですが、「スクリプトのプロパティ」というタブをクリックすると、スクリプトプロパティを確認できます。

スクリプトプロパティを入力する

当然、デフォルトではスクリプトプロパティとしては何のデータも格納されていません。

「＋行を追加」をクリックしてみてください。

すると、プロパティと値についてそれぞれクリックすると編集ができるようになります。

プロパティには「CW_TOKEN」、値には皆さん自身のAPIトークンを入力して「保存」しましょう。

これで、スクリプトプロパティにプロパティと値のペアを入力することができました。

オーナー権限がないと

ただ、スクリプトプロパティの使用については一点注意があります。

そのスクリプトのオーナー権限があるアカウントでないと、上記の手順でプロパティストアの編集ができません。

複数人でスクリプトを管理・活用する場合は、権限も意識して作業をすすめてくださいね。

まとめ

以上、Google Apps Scriptのプロパティストアの概要とスクリプトプロパティの編集方法についてお伝えしました。

コード内に書くべきではない情報があるよということと、GASではそれらを格納するためにプロパティストアという機能が提供されているよということを確認していただければと思います。

次回、今回格納をしたスクリプトプロパティをGASのスクリプトから取得する方法についてお伝えします。

【初心者向けGAS】スクリプトプロパティを操作してそのデータを取り出す方法

初心者向けのシリーズとしてGoogle Apps Scriptで名言Botの作り方を解説しております。今回は、GASでPropertiesサービスを使ってスクリプトプロパティからデータを取り出す方法です。

どうぞお楽しみに！

連載目次：超初心者向けGASでBotを作りながら基礎を学ぶ

Google Apps Script（GAS）をはじめるためのメリットは山程ありますが、何を作ったらいいの？と悩んでしまうこともありますよね。そんな時に、おすすめしたいのが「Bot」の作成です。このシリーズでは、超初心者向けにGASでBotを作る方法を題材としながら、GASプログラミングの一通りの流れと書き方について学んでいきます。