Laravelと Google Calendar APIを連携させ、予約管理のダブルブッキングを防ぐ実装方法を解説。実案件のコード例と失敗談も交えて紹介します。
こんな悩みありませんか?
「電話で予約を受けたあと、Webフォームから同じ時間帯に別の予約が入ってしまった」「スタッフがGoogleカレンダーを手動で更新し忘れてダブルブッキングが発生した」「予約確認のメールを送り忘れて、お客様からクレームが来た」――こうしたトラブルを繰り返していませんか?
予約管理は、業務の根幹を支える仕組みです。それなのに、カレンダーとWebサイトが「別々のもの」として存在している限り、人為的なミスは避けられません。本記事では、LaravelとGoogle Calendar APIを連携させることで、予約の登録・確認・ブロックを完全自動化する実装手順を、実案件の経験をもとに解説します。
なぜダブルブッキングは起きるのか
ダブルブッキングの根本原因は、**「予約データの管理場所が複数ある」**という構造的な問題にあります。
典型的なパターンを整理すると、次のようになります。
- Webサイトの予約フォームはデータベースに保存される
- スタッフはGoogleカレンダーを見て業務管理している
- 電話予約はスタッフが手動でカレンダーに入力する
- この3点が同期されていないため、片方で埋まっていても「空き」と判定されてしまう
あるクライアント(神奈川県内のエステサロン)では、まさにこの問題が発生していました。予約受付フォームが「空き」と判断した時間帯に、実際はスタッフが電話予約を受けてカレンダーに登録済みだったのです。結果として月に2〜3件のダブルブッキングが常態化し、顧客信頼の損失につながっていました。
解決策として我々が選んだのが、LaravelをGoogle Calendar APIと双方向に連携させるアプローチです。予約が入ればリアルタイムにGoogleカレンダーへ反映し、逆にカレンダー上のイベントを読み取って「空き時間」を制御する、という仕組みです。
flowchart TD
A[ユーザーが予約フォームを送信] --> B[LaravelがDBに保存]
B --> C[Google Calendar APIで空き確認]
C -->|空きあり| D[Googleカレンダーにイベント登録]
D --> E[予約確認メールを自動送信]
C -->|空きなし| F[エラー返却・別の時間を提案]
G[スタッフが電話予約を入力] --> H[Googleカレンダーに直接登録]
H --> I[次回のWeb予約時に自動でブロック]実装手順:Laravel × Google Calendar API
1. Google Cloud Consoleでの準備
まずGoogle Cloud ConsoleでプロジェクトとOAuth 2.0認証情報を作成し、Google Calendar APIを有効化します。サービスアカウントを使う方法と、ユーザーOAuthを使う方法がありますが、業務用カレンダーの操作にはサービスアカウントが管理しやすくおすすめです。
ダウンロードしたJSONキーを storage/app/google-calendar-credentials.json に配置しましょう。
2. Composerでクライアントライブラリを導入
composer require google/apiclient:^2.15
3. GoogleCalendarServiceクラスの実装
<?php
namespace App\Services;
use Google\Client;
use Google\Service\Calendar;
use Google\Service\Calendar\Event;
use Google\Service\Calendar\EventDateTime;
use Carbon\Carbon;
class GoogleCalendarService
{
protected Calendar $service;
protected string $calendarId;
public function __construct()
{
$client = new Client();
$client->setAuthConfig(storage_path('app/google-calendar-credentials.json'));
$client->addScope(Calendar::CALENDAR);
$this->service = new Calendar($client);
$this->calendarId = config('services.google_calendar.calendar_id');
}
/**
* 指定時間帯に空きがあるか確認する
*/
public function isAvailable(Carbon $start, Carbon $end): bool
{
$events = $this->service->events->listEvents($this->calendarId, [
'timeMin' => $start->toRfc3339String(),
'timeMax' => $end->toRfc3339String(),
'singleEvents' => true,
]);
return count($events->getItems()) === 0;
}
/**
* 予約イベントをGoogleカレンダーに登録する
*/
public function createEvent(string $title, Carbon $start, Carbon $end, string $description = ''): string
{
$event = new Event([
'summary' => $title,
'description' => $description,
'start' => new EventDateTime([
'dateTime' => $start->toRfc3339String(),
'timeZone' => 'Asia/Tokyo',
]),
'end' => new EventDateTime([
'dateTime' => $end->toRfc3339String(),
'timeZone' => 'Asia/Tokyo',
]),
]);
$created = $this->service->events->insert($this->calendarId, $event);
return $created->getId();
}
}
4. 予約コントローラーへの組み込み
<?php
namespace App\Http\Controllers;
use App\Http\Requests\ReservationRequest;
use App\Models\Reservation;
use App\Services\GoogleCalendarService;
use Carbon\Carbon;
use Illuminate\Http\JsonResponse;
class ReservationController extends Controller
{
public function __construct(
private readonly GoogleCalendarService $calendar
) {}
public function store(ReservationRequest $request): JsonResponse
{
$start = Carbon::parse($request->start_at);
$end = $start->copy()->addMinutes($request->duration);
// ① まずGoogleカレンダーで空き確認
if (! $this->calendar->isAvailable($start, $end)) {
return response()->json([
'message' => 'ご指定の時間帯はすでに予約が入っています。別の時間をお選びください。',
], 409);
}
// ② DBに保存
$reservation = Reservation::create($request->validated() + [
'status' => 'confirmed',
]);
// ③ Googleカレンダーに登録
$eventId = $this->calendar->createEvent(
title: "{$request->customer_name} 様のご予約",
start: $start,
end: $end,
description: "電話: {$request->phone}\n備考: {$request->note}"
);
$reservation->update(['google_event_id' => $eventId]);
return response()->json(['message' => 'ご予約が完了しました。', 'id' => $reservation->id], 201);
}
}
この実装で重要なのは「空き確認 → DB保存 → カレンダー登録」の順序です。逆にしてしまうと、カレンダー登録後にDBへの保存に失敗したとき、データ不整合が生じます。
前述のエステサロンでは、このシステム導入後、ダブルブッキングがゼロ件になりました。さらに「予約確認メールの送り忘れ」もMailableと組み合わせることで完全に自動化され、スタッフの手作業が週あたり約2時間削減されたとのことです。
よくある失敗パターンと対処法
❌ 失敗1:タイムゾーンの設定ミス
最も多いのが、タイムゾーンの不一致によるズレです。Google Calendar APIはRFC3339形式の日時を要求しますが、new DateTime() をそのまま渡すとUTCとして解釈される場合があります。
対処法: CarbonのタイムゾーンをAsia/Tokyoに統一し、toRfc3339String() を使って変換する。config/app.php の timezone も Asia/Tokyo に設定しておくことが大前提です。
❌ 失敗2:レースコンディション(同時予約の競合)
空き確認とカレンダー登録の間に、別のリクエストが割り込んでしまうと、2件同時にダブルブッキングが通過してしまうことがあります。
対処法: Laravelの Cache::lock() を使って楽観的ロックをかける方法が実用的です。
$lock = Cache::lock("reservation_{$start->timestamp}", 10);
if ($lock->get()) {
try {
// 空き確認 → 保存 → カレンダー登録
} finally {
$lock->release();
}
} else {
return response()->json(['message' => '処理中です。しばらくしてから再度お試しください。'], 429);
}
❌ 失敗3:APIクォータの枯渇
Google Calendar APIは無料枠でも1日あたり100万リクエストまで使えますが、空き確認のたびにAPIを叩く設計にすると、カレンダー一覧ページなどで一気にリクエストが増えます。
対処法: isAvailable() の結果をRedisやファイルキャッシュに短時間(30秒〜1分)キャッシュし、同一時間帯へのリクエストをまとめる。ユーザーが確実に予約ボタンを押したタイミングでのみAPIを叩く設計にするだけで大幅に削減できます。
この技術、御社の業務にも活かせます
業務システム開発
Laravelを使った業務システムの構築・改修を20年以上の経験でサポートします
※ 通常1営業日以内にご返信します
まとめと次のステップ
LaravelとGoogle Calendar APIを正しく連携させることで、「カレンダーを見ながら手動で予約を管理する」運用から完全に脱却できます。ダブルブッキングのリスクが消え、スタッフの確認作業もなくなり、顧客への自動通知まで一気通貫で実現できるのが最大のメリットです。
まずは以下のチェックリストに沿って、環境構築から始めてみてください。
「実装してみたが空き判定がうまくいかない」「既存の予約システムにどう組み込めばいいか分からない」というケースも多くあります。Fivenine Designでは、こうした既存システムへのAPI連携改修も承っております。神奈川県内はもちろん、全国対応も可能ですので、まずはお気軽にご相談ください。