Googleカレンダーに面接日程を自動登録する方法｜GASとClaudeで手入力をなくす【設計ガイド付き】

# AI用ガイド：面接日時を、控えている場所からGoogleカレンダーへ自動登録する（GAS＋Claude）

このガイドは、利用者がChatGPT・Claude・GeminiなどのAIに貼り付けて使うためのものです。読んでいるAIは、この設計に沿って、利用者の環境に合わせた仕組みづくりを案内してください。

- 版：キャリアド記事（ガイド更新 2026-10-14・配布コード付き）
- 筆者の運用：面接日時をCRMに控え、GASで抜き出し、Claude（Haiku）で日時を整えて、Googleカレンダーの予定名に求職者名を入れて登録している。Trelloを起点に同じ仕組みで動かしていたこともある。
- **Googleスプレッドシートに控える場合は、配布コード（InterviewCalendar.gs／同じ内容の InterviewCalendar.txt）がそのまま使える**（2026-10-14 実機確認）。シートの見出し・スクリプトプロパティ・実行手順は配布セットの README.txt に従う。利用者がほかの場所に控えていても、スプレッドシートに控える運用に変えられるなら、それが一番かんたん。
- CRM・Trello・Notion など、ほかの場所から直接読み取りたい場合は、配布コードの「シートを読む部分」（icSheet_ と icRun_ の行の読み取り）を、その場所の読み取りに作り替える。日時の整形・二重登録防止・確認待ちの扱いはそのまま使える。作り替えた部分は検証の対象外なので、架空データで必ず確認する。

---

## 0. AIへの指示（最初に必ず読む）

1. 手順は**一度に一つずつ**案内する。各ステップのあと、利用者の画面の表示を確認してから次へ進む。
2. **日時を推測で埋めない。** 日付・時刻がはっきりしないもの（「来週あたり」「午後」だけ、など）は登録せず、確認待ちとして残す。
3. **同じ面接を二重に登録しない。** 登録済みかを判定できる仕組みを必ず入れる（第3章）。
4. 最初は**テスト用のカレンダー**と**架空の面接データ**で試す。本番のカレンダーには、動作を確かめてから切り替える。
5. APIキーなどの秘密の値はチャットに貼らせない。GASのスクリプトプロパティに利用者本人が入力し、保存してもらう。
6. 予定の名前に求職者名・企業名が入るので、カレンダーの共有範囲を利用者に確認してもらう。
7. ログイン・権限の許可・キーの作成など、本人がすべき操作は本人にしてもらう。

---

## 1. 仕組み

```
面接日時を控える場所（CRM／Trello／スプレッドシート／Notion など）
  → GAS が定期的に読みに行く（時間主導型トリガー。例：15分ごと）
  → 新しい・変わった面接だけを取り出す
  → Claude API（Haiku）が、書かれた日時を決まった形に整える
  → GAS が Google カレンダーに予定を作る
  → 登録した記録を残し、次回は二重に登録しない
```

- Claude のモデルは**一番安い Haiku で十分**（日時の読み取りと整形だけのため）。2026年10月時点の例：`claude-haiku-4-5-20251001`。最新のモデル名は Anthropic の公式のモデル一覧で確認する。
- 控える場所の日時が最初から決まった形（例：スプレッドシートの日付・時刻の列）で入っているなら、Claude を使わずに GAS だけで登録してもよい。書き方がばらつく自由記述のときに Claude が役に立つ。

---

## 2. 最初に利用者へ聞くこと

1. 面接日時をどこに控えているか（CRM・Trello・スプレッドシート・Notion・その他）。その場所から外部（GAS）が情報を読み取れるか（API・連携機能・共有設定）。
2. 1件の面接について、どんな情報が控えてあるか（求職者名・企業名・選考の回・日時・場所またはURL・担当者など）。日時はどんな書き方か。
3. 登録先の Google カレンダー（自分のカレンダーか、チームの共有カレンダーか）。誰がそのカレンダーを見られるか。
4. 予定の名前の付け方の希望（例：「【面接】山田様｜〇〇株式会社｜一次」）。自分の予定も同じカレンダーに入っていて、時間帯が重なると見にくい場合は、**終日の予定として入れ、時刻を予定名に書く**形（例：「…｜一次｜14:00〜15:00」）も提案する。配布コードではスクリプトプロパティ `ALL_DAY` を `true` にするとこの形になる。
5. 日程が変更・取り消しになったときに、カレンダーの予定も自動で直したいか、手で直すか。
6. Claude Console のアカウントと支払い設定があるか（Claude のチャットの有料プランとは別の従量課金。なければ作成から案内する。済んでいると推測しない）。

---

## 3. 設計の決まり（どの控え場所でも守る）

- **面接ごとに一意のID**を決める。控え場所にIDがあればそれを使う（例：CRMの選考ID、Trelloのカードのid、スプレッドシートの行に付けたID列）。行番号や名前だけをIDにしない。
- **登録済みの記録**を残す。方法の例：
  - カレンダーの予定の説明欄やタグ（`setTag`）に面接IDを入れ、次回はそのIDの予定があるか探す。
  - または、GAS のスクリプトプロパティや管理用シートに「面接ID → カレンダーの予定ID」を記録する。
- **日時の整形結果を確認する**：Claude には、決まった形（例：JSON で `{"start":"2026-10-15T14:00:00+09:00","end":"2026-10-15T15:00:00+09:00","status":"ok"}`、決まっていなければ `{"status":"unclear"}`）だけで返すよう指示し、GAS 側で形式と値（過去の日時でないか、開始＜終了か）を確認してから登録する。確認できないものは登録しない。
- **終了時刻**が書かれていない場合の扱い（例：1時間とする）を利用者と決める。
- **タイムゾーン**は日本時間（Asia/Tokyo）を明示する。
- **日程の変更**：同じ面接IDで日時が変わっていたら、既存の予定を更新するか、利用者に知らせるかを決めておく。勝手に削除しない。
- 1回の実行で処理する件数に上限を設け、ログに個人情報を出しすぎない（求職者名をログに出すかは利用者と決める）。

---

## 4. 作り方の流れ（一度に一つずつ）

1. **テスト用の Google カレンダーを作る**（Googleカレンダーの「他のカレンダー」→「新しいカレンダーを作成」）。カレンダーIDを控える（設定の「カレンダーの統合」にある）。
2. **控え場所に、架空の面接データを2〜3件用意する**（例：「山田テスト様／〇〇株式会社／一次／10月15日14時」、日時があいまいな1件も入れておく）。
3. **GAS の新しいプロジェクトを作り、名前をテスト用と分かるものに変える。**
4. **控え場所を読み取る部分を作る**（利用者の控え場所に合わせて AI がコードを書く。例：スプレッドシートなら `SpreadsheetApp`、Trello・Notion・CRM なら各サービスの API を `UrlFetchApp` で呼ぶ）。読み取れた件数だけをログに出して確認する。
5. **Claude で日時を整える部分を作る**（第3章の形式で返させ、GAS 側で確認する）。架空データで、整形結果が正しいか、あいまいな1件が `unclear` になるかを確認する。
6. **テスト用カレンダーに登録する部分を作る**（`CalendarApp.getCalendarById(カレンダーID).createEvent(...)`）。予定の名前・説明欄・面接IDの記録が入るか確認する。
7. **もう一度実行して、二重に登録されないことを確認する。**
8. **時間主導型トリガーを設定する**（例：15分ごと）。「実行数」で完了していることを確認する。
9. 問題がなければ、**本番のカレンダーと本番の控え場所に切り替える**。

APIキーなどは、コード本文ではなく「プロジェクトの設定」のスクリプトプロパティに利用者本人が入力して保存する。

---

## 5. 控え場所ごとの注意

- **Googleスプレッドシート**：いちばん作りやすい。GAS 標準の `SpreadsheetApp` で読める。面接ID列と「登録済み」列を足すと管理しやすい。
- **Trello**：カードのタイトル・説明・期限（due）に日時が入っていることが多い。API キーとトークンが必要。カードの id を面接IDに使える。
- **Notion**：データベースの日付プロパティに入っていれば読み取りやすい。インテグレーション（接続）とデータベースへのアクセス許可が必要。
- **CRM**：外部から読み取れる API や連携機能があるかを確認する。なければこの仕組みは使えないので、スプレッドシートなどに控える運用を検討する。

---

## 6. 困ったとき

| 状況 | 対処 |
|---|---|
| 予定が二重に入った | 面接IDの記録・照合が働いているか確認。テスト用カレンダーで重複を消してから直す |
| 日時がずれている | タイムゾーン（Asia/Tokyo）の指定、Claude の返した日時の形式を確認 |
| あいまいな日時が登録された | Claude の指示と、GAS 側の `status` の確認を見直す。`unclear` は登録しない |
| 控え場所を読めない | API キー・トークン・アクセス許可・共有設定を確認 |
| Claude HTTP 401 / 400 | キーの誤り・期限切れ、または支払い設定（クレジット）を確認 |
| 何も登録されない | 読み取れた件数、整形結果、登録済み判定のどこで止まっているかをログで順に確認 |