Google Calendar事件无法删除及API创建时409错误解决求助

我之前也碰到过一模一样的情况——用API创建事件时触发409冲突，结果事件莫名出现在日历里，却在网页端找不到删除选项。给你几个实用的解决办法：

一、先搞清楚问题根源 #

你调用POST /calendars/{calendarId}/events时返回409，是因为你创建事件时手动指定了id参数，而这个ID已经在目标日历中存在了。有时候API会因为网络或状态同步问题，返回冲突的同时却悄悄创建了事件，就导致了这种网页端无法操作的“幽灵”事件。

二、用API删除异常事件（最靠谱的方案） #

既然网页端搞不定，咱们直接用API来操作，分两步走：

1. 获取目标事件的ID #

先调用事件列表接口，定位到这个异常事件的ID。用PHP实现的话，代码如下：

<?php
require __DIR__ . '/vendor/autoload.php'; // 确保引入Google API客户端库

// 初始化客户端，和你创建事件时的配置保持一致
$client = new Google\Client();
$client->setApplicationName('你的应用名称');
$client->setScopes([Google\Service\Calendar::CALENDAR]);
$client->setAuthConfig('credentials.json');
$client->setAccessType('offline');

$service = new Google\Service\Calendar($client);
$calendarId = 'mycalendar_nrfo11fd4vi2a83ir85b8b2rp0@group.calendar.google.com';

// 过滤条件：根据事件标题、时间范围缩小搜索范围
$optParams = [
  'q' => '你的事件标题', // 替换成你创建的事件的标题
  'timeMin' => date('c', strtotime('-7 days')), // 搜索最近7天的事件
  'maxResults' => 10,
  'singleEvents' => true,
  'orderBy' => 'startTime',
];
$results = $service->events->listEvents($calendarId, $optParams);

if (empty($results->getItems())) {
  print "没找到对应事件\n";
} else {
  foreach ($results->getItems() as $event) {
    // 输出事件ID和标题，找到你要删除的那个
    printf("事件ID：%s，标题：%s\n", $event->getId(), $event->getSummary());
  }
}
?>

运行这段代码，就能拿到目标事件的ID了。

2. 调用删除接口移除事件 #

拿到ID后，用下面的代码删除：

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

// 同样的客户端配置
$client = new Google\Client();
$client->setApplicationName('你的应用名称');
$client->setScopes([Google\Service\Calendar::CALENDAR]);
$client->setAuthConfig('credentials.json');
$client->setAccessType('offline');

$service = new Google\Service\Calendar($client);
$calendarId = 'mycalendar_nrfo11fd4vi2a83ir85b8b2rp0@group.calendar.google.com';
$eventId = '你刚刚获取到的事件ID'; // 替换成实际ID

try {
  $service->events->delete($calendarId, $eventId);
  print "事件删除成功！\n";
} catch (Exception $e) {
  printf("删除失败：%s\n", $e->getMessage());
}
?>

三、避免以后再踩坑 #

• 尽量不要手动指定事件id，让Google自动生成唯一ID，从根源上避免ID冲突。
• 如果业务必须自定义id，创建前先调用事件列表接口检查这个ID是否已存在，确认无冲突后再提交创建请求。

四、如果API删除也失败？ #

可以试试这两个排查方向：

• 确认你的API客户端拥有该日历的编辑权限（授权时要请求CALENDAR或CALENDAR_EVENTS权限）。
• 检查Google Calendar的回收站，不过这种异常事件大概率不会出现在那里，还是优先用API解决。

内容的提问来源于stack exchange，提问作者user3574492