icsファイルとは？GASでの生成方法について

GAS(GoogleAppsScript)

2024.01.04

この記事は約5分で読めます。

icsファイルとは
スプレッドシートからicsファイルを生成する
ログで出力される
まとめ

icsファイルとは

icsファイルは、iCalendarフォーマットで構造化されたカレンダーデータを含むファイルです。iCalendarは、イベントや予定などのカレンダー関連の情報を共有するための標準フォーマットです。ICSは「iCalendarファイル」の略であり、通常は拡張子が「.ics」です。

sample.ics

ICSファイルには、イベントのタイトル、開始日時、終了日時、場所、参加者などの情報が含まれます。これは異なるカレンダーアプリケーションやプラットフォーム間で予定を共有するために使用されます。例えば、会議や予定を共有する際に、ICSファイルをメールに添付して送信したり、ウェブカレンダーサービスでダウンロードしたりすることがあります。

BEGIN:VCALENDAR
VERSION:2.0
BEGIN:VEVENT
SUMMARY:会議
DTSTART:20231220T100000Z
DTEND:20231220T113000Z
LOCATION:会議室A
DESCRIPTION:月次会議
END:VEVENT

ICSファイルの利点は、異なるカレンダーアプリケーションやプラットフォーム間での互換性があることです。この形式は、さまざまなデバイスやアプリケーションで共通のカレンダーデータを利用できるようにします。

スプレッドシートからicsファイルを生成する

以下は、Google Apps Scriptを使用してGoogleスプレッドシートからイベント情報を取得し、それをICS形式で生成する簡単な例です。

スプレッドシートをics形式で取得するスクリプトです。

function generateICS() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var data = sheet.getDataRange().getValues();

  // ICS ヘッダ
  var icsContent = "BEGIN:VCALENDAR\nVERSION:2.0\n";

  for (var i = 1; i < data.length; i++) {
    var event = {
      'summary': data[i][0], // イベント名
      'start': new Date(data[i][1]), // 開始日時
      'end': new Date(data[i][2]), // 終了日時
      'location': data[i][3], // 場所
      'description': data[i][4], // 説明
    };

    // ICS イベント
    icsContent += "BEGIN:VEVENT\n";
    icsContent += "SUMMARY:" + event.summary + "\n";
    icsContent += "DTSTART:" + formatDate(event.start) + "\n";
    icsContent += "DTEND:" + formatDate(event.end) + "\n";
    icsContent += "LOCATION:" + event.location + "\n";
    icsContent += "DESCRIPTION:" + event.description + "\n";
    icsContent += "END:VEVENT\n";
  }

  // ICS フッタ
  icsContent += "END:VCALENDAR\n";

  // ICS ファイルの内容をログに表示
  Logger.log(icsContent);
}

// 日時のフォーマットを変換するヘルパー関数
function formatDate(date) {
  return Utilities.formatDate(date, Session.getScriptTimeZone(), "yyyyMMdd'T'HHmmss'Z'");
}

[rml_read_more]

ログで出力される

ログには、以下のように出力されます。

情報	BEGIN:VCALENDAR
VERSION:2.0
BEGIN:VEVENT
SUMMARY:会議
DTSTART:20231220T100000Z
DTEND:20231220T113000Z
LOCATION:会議室A
DESCRIPTION:月次会議
END:VEVENT
BEGIN:VEVENT
SUMMARY:プロジェクト発表
DTSTART:20231221T140000Z
DTEND:20231221T160000Z
LOCATION:カンファレンス室
DESCRIPTION:新規プロジェクトの進捗発表
END:VEVENT
BEGIN:VEVENT
SUMMARY:昼食会
DTSTART:20231222T120000Z
DTEND:20231222T130000Z
LOCATION:レストランA
DESCRIPTION:チームメンバーとのランチ会
END:VEVENT
END:VCALENDAR

この生成されたテキストをics形式で保存して、例えば特定のURLに配置することで、Googleカレンダーなどからインポートできます。

サンプル：
https://cal.eguweb.tech/sample.ics