メインコンテンツへスキップ
見出し画像

Googleカレンダーから稼働時間を自動集計するGAS|案件別の稼働表・月次報告書・請求明細PDFをGmail下書きまで(コピペ用テンプレート)

    「月末になると、カレンダーを1日ずつさかのぼって、稼働時間を数えている」
    「案件ごとに分けて、時給をかけて、報告書を作るだけで1〜2時間かかる」

    副業やフリーランスのエンジニア、業務委託で時間単価の仕事をしていると、月末にこの作業がやってきます。

    ・Googleカレンダーに作業の予定を入れているのに、集計は手で電卓
    ・案件が2つ3つあると、どの予定がどの案件か、見分けるのに時間がかかる
    ・会議と作業が重なっている日、日付をまたいだ夜間作業の数え方に毎回迷う
    ・15分単位・30分単位の丸めや、税込・税抜の計算をまちがえないか不安
    ・稼働報告書と請求の明細を、毎月ほぼ同じ形で作り直している

    この記事は、その月末の作業を、Googleカレンダー・スプレッドシート・GAS(Google Apps Script)で自動にするテンプレートです。

    読むとできること:カレンダーの予定から、稼働表と報告書の下書きまで

    予定のタイトルを「【案件名】作業内容」のように書いておくだけで、あとはボタン1つ(または毎月1日の自動実行)で、次のところまで進みます。

    ・予定を案件ごとに判定(タイトルの【案件名】・キーワード・予定の色)
    ・終日の予定、辞退した会議、「非稼働」「移動」などの予定は数えない
    ・重なった時間は二重に数えず、警告を出す。日をまたぐ予定は日付ごとに分ける
    ・15分/30分単位で丸め、「案件別・日別」「月別」の稼働表を作る
    ・案件ごとの合計・時給×時間・消費税を並べた「月次報告書」を作る
    ・請求先ごとに報告書をPDFにして、Gmailの「下書き」に添付する(送信はしない)

    案件が判定できなかった予定は「未分類」シートに出るので、案件名を入れて再集計すれば反映されます。

    画像

    無料で出回っている情報との違い

    「GAS カレンダー 集計」で調べると、予定の時間を足し合わせるだけの短いコードは無料でも見つかります。1つの案件だけなら、それで足りることもあります。ただ、毎月の請求に使うとなると、困るのは「足し算」より、その前後の細かいところです。このテンプレートは、そこを最初から入れています。

    1. 案件の判定をシートで決める:「案件ルール」シートに、案件名・判定のしかた(括弧/キーワード/色)・時給・請求先・送付先を書くだけ。コードは触りません

    2. 数えない予定を決めてある:終日の予定・辞退した予定・不在の予定・非稼働キーワードは除外し、明細に「なぜ除外したか」を残します

    3. 重なりと日またぎ:同じ時間に入っている予定は、あとの予定から重なった分を引いて警告列に書きます。23時〜翌2時のような予定は日付ごとに分け、月をまたぐ分は翌月に回します

    4. 何度実行しても増えない:予定のID+開始時刻をキーにして上書きします。予定を直してから再集計しても、行が二重になりません。手で書いたメモ欄は残ります

    5. 丸めと端数の選択:丸めは15分/30分/なし、切り捨て・四捨五入・切り上げ、「予定ごと/日ごと/月ごと」から選べます。金額の1円未満の扱い、時給が税込か税抜か、消費税を出すかどうかも設定で決めます

    6. 送らない・二重に作らない:作るのはGmailの下書きだけ。最初はテストモードで、下書きの宛先は自分になります。同じ月・同じ案件の下書きは二重に作りません

    7. 止まり方を決めてある:GASの1回6分の制限に合わせて、上限の秒数を超えたら途中で止め、次の実行で続きから作ります

    コードはNode.jsで、カレンダー・スプレッドシート・Gmailをまねした環境を作り、98項目のテスト(案件判定、丸め、重なりの控除、除外、月の境目、請求額の端数処理、再実行で重複しないこと、下書きなど)を通してあります。Googleの実際の環境ではまだ動かしていないので、設置したら最初にテストモードで確かめてください(手順は有料部分に書いています)。

    こんな方に向いています

    ・Googleカレンダーに作業時間を入れている、副業・フリーランスのエンジニアや業務委託の方
    ・時給(時間単価)で請求していて、毎月、稼働報告書を出している方
    ・案件が複数あって、月末の集計と報告書づくりに時間をとられている方

    向いていない方

    ・Googleカレンダーに作業の予定を入れていない方(先に予定を入れる習慣が必要です)
    ・固定額・成果物ごとの請求で、時間を数える必要がない方
    ・会社の勤怠システムに入力する決まりがある方(このテンプレートは勤怠システムとはつながりません)

    有料部分に入っているもの

    ・コード全文(コピーして貼るだけ。約690行・コメントは日本語)
    ・「設定」「案件ルール」シートの書き方(記入例つき)と、予定タイトルの書き方のコツ
    ・テストモードでの確かめ方、未分類の直し方、重なり警告の見方
    ・月次報告書・PDF・Gmail下書きの作り方と、本番への切りかえ方
    ・毎月1日の自動実行の設定と、毎月の流れ
    ・任意:Gemini APIで「作業内容のコメント」を下書きする方法(既定はオフ)
    ・よくあるつまずきQ&A、カスタマイズ例、請求・税の扱いの注意

    ほかのテンプレートは、悩み別のカタログにまとめています。自分に合う記事を探すときに使ってください。

    ここから有料(980円)

     
     
    エンジニアです。Gmailやスプレッドシートの面倒な作業を、GASで少しラクに。ひとりで働く方や小さなお店に向けて、自動化テンプレートと使い方をまとめています。記事選びに迷ったら、固定のカタログをご覧ください。 ※アフィリエイト広告(Amazonアソシエイト含む)を掲載。

    あなたへのおすすめ