如何配置Google Calendar将新事件数据发送至Google Pub/Sub主题？

前提条件 #

• 已启用Google Calendar API和Cloud Pub/Sub API
• 拥有目标日历的管理权限，以及目标Pub/Sub主题的编辑权限

具体操作步骤 #

1. 创建Calendar推送通知通道 #

你需要通过Calendar API的watch方法，建立特定日历与Pub/Sub主题的关联，让日历事件变更（新增、更新、删除）自动推送到主题。推荐用gcloud命令行快速完成：

运行以下命令，替换所有占位符为你的实际信息：

gcloud calendar channels watch \
  --calendar-id="你的目标日历ID" \
  --topic="projects/你的GCP项目ID/topics/你的Pub/Sub主题名" \
  --id="随机生成的唯一通道ID（比如cal-pubsub-001）" \
  --type="events" \
  --address="https://pubsub.googleapis.com/v1/projects/你的GCP项目ID/topics/你的Pub/Sub主题名:publish"

如果习惯用HTTP API调用，发送POST请求到https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events/watch，请求体示例如下（同样替换占位符）：

{
  "id": "唯一通道ID",
  "type": "web_hook",
  "address": "https://pubsub.googleapis.com/v1/projects/你的GCP项目ID/topics/你的Pub/Sub主题名:publish",
  "token": "可选的自定义验证令牌，用于校验通知合法性"
}

注意：请求必须携带具备https://www.googleapis.com/auth/calendar权限的OAuth 2.0凭据。

2. 配置Pub/Sub主题权限 #

给Calendar API的服务账号授予主题发布权限，确保它能推送消息：

• 打开GCP控制台的Pub/Sub主题页面，找到你的目标主题
• 进入「权限」标签页，点击「添加成员」
• 输入服务账号：calendar-notifications@system.gserviceaccount.com
• 选择角色：「Pub/Sub > Pub/Sub Publisher」
• 保存设置

3. 验证配置效果 #

在目标日历中新增一个测试事件，等待1-2分钟后，查看Pub/Sub主题的消息列表，应该能看到包含事件元数据（开始/结束时间、标题等）的推送消息。如果没收到，检查以下几点：

• 通道ID是否唯一（重复ID会导致旧通道被覆盖）
• 权限配置是否正确，服务账号是否获得了发布权限
• Calendar API和Pub/Sub API是否已在GCP项目中启用

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