Google Apps Scriptで実行したユーザーごとのスプレッドシートを新規作成する

photo credit: arbyreed Frozen Food via photopin (license)

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

本記事はApps Script Advent Calendar 2017の参加をしておりまして、本当はGoogle Home関連の何かを書きたかったのですが、あんまりナイスな技が思いつかなかったのと、せっかくなので12/23に発売される拙著の中から何か紹介できれば…ということで、このネタに変更しました。

さて、チームでスプレッドシートを使用している場合、各人ごとのスプレッドシートを作成して、それを中央管理的なスプレッドシートやそれにバインドしたスクリプトで集計したりするような使い方をしたいことがありますね。

例えば、勤怠管理だったり、経費精算だったりがそのような使い方をすることがあると思います。

ただ、その場合、ユーザーごとのスプレッドシートを作り、そのすべてのスプレッドシートIDを調べて管理する必要が出てきます。

そんなときに便利なのが、ユーザーごとに異なるデータを管理することができるユーザープロパティです。

今回は、GASのユーザープロパティについて、またユーザーごとのスプレッドシートを作成してそのIDをユーザープロパティで管理するスクリプトを紹介します。

ユーザープロパティとは
ユーザーごとにスプレッドシートを作成するスクリプト
まとめ

ユーザープロパティとは

ユーザープロパティは、プロジェクトにデータを格納することができる領域で、ユーザーごとに別々のデータを保管することができます。

また、実行者であるユーザー自身のユーザープロパティにのみアクセスすることができるというものです。

ユーザープロパティはプロパティストアの一つで、ほかにプロジェクトに紐づいてデータを格納するスクリプトプロパティ、ドキュメントに紐づいてデータを格納するドキュメントプロパティがあります。

スクリプトプロパティ：プロジェクト単位で格納、スクリプトエディタで編集可能
ユーザープロパティ：ユーザー単位で格納
ドキュメントプロパティ：ドキュメント単位で格納

プロパティストアには、キーと値のペアの形式でデータを格納します。

つまり、例えば

USER_ID: 101
SPREAD_SHEET_ID: ‘XXXXXXXX’
E_MAIL: ‘〇〇@example.com’

というような形です。

ユーザーごとにスプレッドシートを作成するスクリプト

ユーザーごとにスプレッドシートを作成するスクリプトはこちらです。

例えば、チームのユーザーにこのスクリプトがバインドしているスプレッドシートを共有して、各自がメニューなどからスクリプトを実行することで、各自のスプレッドシートを作成することができます。

function createSS() {
  var userProperties = PropertiesService.getUserProperties();
  var spreadSheetId = userProperties.getProperty('SPREAD_SHEET_ID');
  if(spreadSheetId) {
    throw('既にスプレッドシートが存在しています: ' + spreadSheetId);
  } else {
    var newSpreadSheet = SpreadsheetApp.create('スタッフごとのスプレッドシート');
    userProperties.setProperty('SPREAD_SHEET_ID', newSpreadSheet.getId());
  }
}