如何通过PHP API向Google Calendar插入事件？遇登录问题求指导

阿华AIGC实验室

2026-5-27

问题解答：实现用户预约插入你的Google Calendar

兄弟，你的需求完全可行！你之前碰到的「Login required」错误，核心问题是Google Calendar的写入操作必须要授权——单纯用API Key根本不够，API Key只能用来访问公开数据，修改私有日历（你的个人日历属于私有资源）必须走OAuth 2.0授权流程。

为啥你的CURL请求会失败？

Google Calendar API的events.insert接口（就是你调用的插入事件接口）要求请求必须携带有效的OAuth 2.0访问令牌，但你只传了API Key，这相当于没做身份验证，自然被拒绝了。记住：API Key仅适用于不需要用户身份的公开数据读取（比如看公开日历的事件），绝对不能用来修改私有资源。

正确的实现方案（针对“把预约存到你的日历”这个需求）

因为是操作你的日历，不是用户自己的日历，最省心的方式是用Google服务账号（Service Account）——这是专门给后端服务用的授权方式，配置一次就能长期自动操作，不用每次手动登录授权。

步骤1：搞定服务账号与权限配置

登录Google Cloud Console，新建一个项目，然后启用「Google Calendar API」
进入「IAM与管理」→「服务账号」，创建一个服务账号，下载对应的JSON密钥文件（好好存着，别泄露给别人）
打开你的Google Calendar，进日历设置→「共享和权限」，把服务账号的邮箱（就是JSON密钥里的client_email字段）加进去，给它编辑权限——这步绝对不能忘，不然服务账号没资格改你的日历。

步骤2：用官方PHP客户端库实现（强烈推荐，比自己写CURL靠谱100倍）

官方库已经把授权、API调用、令牌刷新这些破事都封装好了，不用自己踩坑。

先装依赖：

composer require google/apiclient:^2.0

然后写代码示例：

<?php
require __DIR__ . '/vendor/autoload.php';

// 初始化Google客户端
$client = new Google\Client();
// 加载服务账号的密钥文件
$client->setAuthConfig('path/to/your-service-account-key.json');
// 设置权限范围：要的是日历事件的编辑权限
$client->addScope(Google\Service\Calendar::CALENDAR_EVENTS);

// 创建Calendar服务实例
$service = new Google\Service\Calendar($client);

// 构造用户预约的事件数据
$event = new Google\Service\Calendar\Event([
    'summary' => '用户预约服务', // 事件标题，你可以改成用户提交的预约主题
    'location' => 'Siliguri',
    'description' => '用户通过网站提交的预约请求',
    'start' => [
        'dateTime' => '2018-05-08T13:30:00+05:30', // 这里替换成用户选的开始时间
        'timeZone' => 'Asia/Calcutta',
    ],
    'end' => [
        'dateTime' => '2018-05-08T14:30:00+05:30', // 用户选的结束时间
        'timeZone' => 'Asia/Calcutta',
    ],
    'reminders' => [
        'useDefault' => true,
    ],
]);

// 你的日历ID（在Google Calendar设置里能找到，一般是你的邮箱或者自定义的ID）
$calendarId = 'your-calendar-id@group.calendar.google.com';

// 插入事件到你的日历
$event = $service->events->insert($calendarId, $event);
printf("预约已成功创建：%s\n", $event->htmlLink);
?>