未分類

GmailThread.getPermalinkで勤怠管理を効率化！GASで実現する自動打刻システム

GmailThread.getPermalinkで勤怠管理を効率化！GASで実現する自動打刻システム

本記事では、GAS（Google Apps Script）のGmailThread.getPermalink()関数を活用し、Gmailの特定のスレッドへのパーマリンクを取得して、勤怠管理システムを効率化する方法を解説します。手動での打刻作業を自動化し、日々の業務をよりスムーズにしましょう。

勤怠管理における課題

多くの企業で勤怠管理は依然として手作業で行われており、以下のような課題が存在します。

  • 打刻漏れが発生しやすい

  • 集計作業に時間がかかる

  • 不正打刻のリスクがある

これらの課題を解決するために、GASとGmailを連携させた自動打刻システムの導入を検討しましょう。

GmailThread.getPermalink()とは？

GmailThread.getPermalink()は、Gmailの特定のスレッドへのパーマリンク（URL）を取得するGASの関数です。このパーマリンクを利用することで、特定のメールスレッドに簡単にアクセスできます。勤怠管理においては、特定のメール（例：出勤・退勤報告メール）のスレッドIDを取得し、打刻時刻と紐付けることで、自動的に勤怠情報を記録できます。

勤怠管理システムの実装方法

ここでは、GmailThread.getPermalink()を使用した勤怠管理システムの実装例をいくつか紹介します。

1. 出勤・退勤報告メールからの自動打刻

社員が出勤・退勤時に特定の件名でメールを送信すると、GASがそのメールを検知し、GmailThread.getPermalink()でスレッドのURLを取得、スプレッドシートに打刻情報として記録するシステムです。

function recordAttendance() {
  // 設定
  const attendanceSheetId = "YOUR_SPREADSHEET_ID"; // スプレッドシートID
  const attendanceSheetName = "attendance"; // シート名
  const triggerSubject = "出勤報告"; // 出勤報告メールの件名

  // スプレッドシートを取得
  const ss = SpreadsheetApp.openById(attendanceSheetId);
  const sheet = ss.getSheetByName(attendanceSheetName);

  // Gmailを検索
  const threads = GmailApp.search("subject:" + triggerSubject + " is:unread");

  // スレッドが存在する場合
  if (threads.length > 0) {
    for (let i = 0; i < threads.length; i++) {
      const thread = threads[i];
      const permalink = thread.getPermalink();
      const messages = thread.getMessages();
      const lastMessage = messages[messages.length - 1]; // 最新のメッセージを取得
      const timestamp = lastMessage.getDate(); // タイムスタンプを取得

      // スプレッドシートに記録
      sheet.appendRow([timestamp, permalink]);

      // 既読にする
      thread.markRead();
    }
  }
}

カスタマイズ方法：triggerSubject変数を変更することで、別の件名のメールにも対応できます。また、スプレッドシートへの記録内容（社員名、部署など）を追加することも可能です。

2. Googleフォームと連携した打刻システム

Googleフォームで出勤・退勤を打刻し、そのフォームの送信時にGmailThread.getPermalink()でスレッドのURLを取得、フォームの回答と紐付けてスプレッドシートに記録するシステムです。

function onFormSubmit(e) {
  // 設定
  const attendanceSheetId = "YOUR_SPREADSHEET_ID"; // スプレッドシートID
  const attendanceSheetName = "form_responses"; // シート名
  const formResponse = e.response;
  const itemResponses = formResponse.getItemResponses();

  // タイムスタンプを取得
  const timestamp = formResponse.getTimestamp();

  // スレッドIDを生成（例：フォーム送信者のメールアドレスから）
  const respondentEmail = formResponse.getRespondentEmail();
  // メールアドレスを元にスレッドを検索 (完全一致)
  const threads = GmailApp.search("from:" + respondentEmail + " subject:'打刻' newer_than:1d");

  let permalink = "";
  if (threads.length > 0) {
    // 最新のスレッドのパーマリンクを取得
    const thread = threads[0];
    permalink = thread.getPermalink();
  }

  // スプレッドシートを取得
  const ss = SpreadsheetApp.openById(attendanceSheetId);
  const sheet = ss.getSheetByName(attendanceSheetName);

  // フォームの回答とパーマリンクをスプレッドシートに記録
  let rowData = [timestamp, permalink];
  for (let i = 0; i < itemResponses.length; i++) {
    rowData.push(itemResponses[i].getResponse());
  }
  sheet.appendRow(rowData);
}

カスタマイズ方法：Googleフォームの質問項目を自由に変更できます。また、onFormSubmit関数をトリガーに設定することで、フォーム送信時に自動的に実行されます。

3. Slackと連携した打刻システム

Slackの特定のチャンネルに投稿されたメッセージをトリガーに、GmailThread.getPermalink()でスレッドのURLを取得し、打刻情報として記録するシステムです。（Slack APIの知識が別途必要になります。）

注意：Slack APIとGASの連携には、Incoming Webhooksなどの設定が必要です。

よくある問題とトラブルシューティング

  • メールが検出されない：GmailApp.search()の検索条件が正しいか確認してください。件名、送信者、期間などを適切に設定する必要があります。

  • パーマリンクが取得できない：スレッドが存在するか、または権限の問題がないか確認してください。

  • スプレッドシートへの記録がうまくいかない：スプレッドシートID、シート名が正しいか確認してください。また、GASの実行権限が付与されているか確認してください。

カスタマイズ方法と応用例

  • 打刻時間の集計：スプレッドシートに記録された打刻時間をもとに、労働時間を自動的に集計できます。

  • 休暇申請との連携：休暇申請があった場合、その期間の打刻を自動的に除外できます。

  • レポート作成：月ごとの労働時間や残業時間を自動的に集計し、レポートを作成できます。

まとめ

GmailThread.getPermalink()を活用することで、勤怠管理を大幅に効率化できます。本記事で紹介した実装例を参考に、自社の業務に合わせた自動打刻システムを構築してみてください。

GASとGmailの連携は、勤怠管理だけでなく、様々な業務の自動化に役立ちます。ぜひ、GASの可能性を追求し、日々の業務をよりスマートにしていきましょう。

PR

CodeCampは、現役エンジニアからマンツーマンで学べるオンラインプログラミングスクールです。WebデザインやWebサービス開発、転職支援など、目的に合わせた多様なコースが選べます。
朝7時〜夜23時40分まで、365日レッスンが受けられるため、忙しい方でも自分のペースで学習を進めることが可能です。通過率8%の厳しい選考を通過した質の高い講師陣が、あなたのキャリアチェンジを強力にサポートします。
さらに、未経験者向けのカリキュラムや、学習開始から20日以内の全額返金保証制度もあるため、プログラミング学習に不安を感じている方でも安心して始めることができます。

CodeCampで理想の働き方を実現しよう