生成AI活用研究
Googleカレンダーの日本の祝日をGASとExcelで取得する ～APIキー不要、XML連携ガイド～

Googleカレンダーの日本の祝日データを、iCal形式の公開URLをGASで解析し、XML形式のAPIとしてExcelに取得・展開するまでの一連のステップを、ゼロから全て教えてください。

APIキーを使わない、iCalをGASで処理する方式でお願いします。

---

### 1. GAS (Google Apps Script) の実装とデプロイ

* Google Apps Scriptプロジェクトの作成方法。
* **iCal形式の日本の祝日データを読み込み、解析し、XML形式で整形して返すGASスクリプトの具体的なコード**（特定年の祝日取得機能、および`iCal`の解析ロジックを含む）。
* GASスクリプトをWebアプリケーションとしてデプロイする詳細な手順（アクセス権限の設定と、発行されたURLの確認方法）。

---

### 2. Excelシートでの数式と設定

* GASでデプロイしたWebアプリケーションのURLをExcelで扱うための数式。
* `WEBSERVICE`関数を使ってXMLデータを取得する数式。
* 取得したXMLデータから祝日の「日付」と「名称」をそれぞれ抽出し、シートに自動的に展開（スピル）させる`FILTERXML`関数の数式。
* 特定の年（例: A1セルに入力した年）の祝日を取得するための、Excel側の数式とGAS側の連携方法。

---

この一連の作業を、詳細な手順とそのまま使えるコード、数式でガイドしてください。

// 日本の祝日カレンダーのiCal形式URL
const ICAL_URL = 'https://calendar.google.com/calendar/ical/ja.japanese%23holiday%40group.v.calendar.google.com/public/basic.ics';

/**
 * Webリクエスト（GET）を処理し、指定された年の日本の祝日データをXML形式で返します。
 * @param {Object} e - イベントオブジェクト。e.parameter.year で年を指定できます。
 * @return {ContentService.TextOutput} XML形式の祝日データ。
 */
function doGet(e) {
  let targetYearStr = '';
  if (e && e.parameter && e.parameter.year) {
    targetYearStr = e.parameter.year;
  } else {
    targetYearStr = new Date().getFullYear().toString(); // 年が指定されていない場合は当年
  }

  // 年が4桁の数字であることを確認
  if (!/^\d{4}$/.test(targetYearStr)) {
    return ContentService.createTextOutput('<holidays><error><message>Invalid year format. Please specify a 4-digit year (e.g., year=2025).</message></error></holidays>')
                         .setMimeType(ContentService.MimeType.XML);
  }

  try {
    const icsString = UrlFetchApp.fetch(ICAL_URL).getContentText();
    const events = parseICS(icsString, targetYearStr);
    const xmlOutput = convertToXML(events, targetYearStr);
    return ContentService.createTextOutput(xmlOutput).setMimeType(ContentService.MimeType.XML);
  } catch (error) {
    Logger.log('Error: ' + error.toString());
    return ContentService.createTextOutput('<holidays><error><message>Failed to retrieve or parse holiday data: ' + escapeXml(error.toString()) + '</message></error></holidays>')
                         .setMimeType(ContentService.MimeType.XML);
  }
}

/**
 * iCalendar形式の文字列を解析し、指定された年のイベントを抽出します。
 * @param {string} icsString - iCalendar形式のデータ文字列。
 * @param {string} targetYearStr - 対象の年（文字列）。
 * @return {Array<Object>} 抽出されたイベントの配列（{date: 'YYYYMMDD', name: '祝日名'}）。
 */
function parseICS(icsString, targetYearStr) {
  const holidays = [];
  const vevents = icsString.split('BEGIN:VEVENT');
  
  if (vevents.length > 1) {
    vevents.slice(1).forEach(veventData => {
      const eventLines = veventData.split(/\r\n|\r|\n/); // 改行コードの差異に対応
      let date = '';
      let summary = '';

      eventLines.forEach(line => {
        if (line.startsWith('DTSTART;VALUE=DATE:')) {
          date = line.substring('DTSTART;VALUE=DATE:'.length).trim();
        } else if (line.startsWith('SUMMARY:')) {
          summary = line.substring('SUMMARY:'.length).trim();
        }
      });

      if (date && summary && date.startsWith(targetYearStr)) {
        holidays.push({
          date: date,
          name: summary
        });
      }
    });
  }
  return holidays;
}

/**
 * 祝日データの配列をXML文字列に変換します。
 * @param {Array<Object>} holidays - 祝日データの配列。
 * @param {string} year - 対象年。
 * @return {string} XML形式の文字列。
 */
function convertToXML(holidays, year) {
  let xml = '<holidays year="' + year + '">\n';
  if (holidays.length === 0) {
    xml += '  <message>No holidays found for the specified year.</message>\n';
  } else {
    holidays.forEach(holiday => {
      xml += '  <holiday>\n';
      xml += '    <date>' + holiday.date + '</date>\n';
      xml += '    <name>' + escapeXml(holiday.name) + '</name>\n';
      xml += '  </holiday>\n';
    });
  }
  xml += '</holidays>';
  return xml;
}

/**
 * XML特殊文字をエスケープします。
 * @param {string} unsafe - エスケープ対象の文字列。
 * @return {string} エスケープされた文字列。
 */
function escapeXml(unsafe) {
  if (typeof unsafe !== 'string') {
    return '';
  }
  return unsafe.replace(/[<>&'"]/g, function (c) {
    switch (c) {
      case '<': return '&lt;';
      case '>': return '&gt;';
      case '&': return '&amp;';
      case '\'': return '&apos;';
      case '"': return '&quot;';
      default: return c;
    }
  });
}