配额慷慨且按用户隔离
必须走 OAuth，不能用简单 API key 操作用户数据
到 console.cloud.google.com 启用 Calendar API，配置 OAuth 凭证。用户授权后拿 access_token，调 calendars.list / events.insert 等端点。需要 scope：https://www.googleapis.com/auth/calendar 或更窄的 calendar.events。
可用率 · 30 天窗口
关于这个 API
Google Calendar API 提供完整的日历编程能力：管理日历列表、创建与修改事件、订阅变更、处理 ACL 共享。在 Google Workspace 生态中它常与 Gmail、Drive、Meet API 联用——例如自动在事件中插入 Meet 会议链接，或把 Drive 附件挂到事件上。
事件模型最值得注意的点是 recurring events：一组重复事件由一个 master event 加上具体的实例组成。修改时要明确是改整个系列、改单次实例、还是把后续都改成新规则——API 通过 sendUpdates、updateMode 等参数区分。时区处理也是高频坑：每个事件可指定独立时区，跨区域协调时应优先用 IANA 时区名而非 UTC offset。
你可以做什么
- 1为应用嵌入"加入到 Google Calendar"按钮
- 2同步外部排班系统到日历
- 3搭建会议预约工具自动创建事件
- 4订阅他人公开日历做监控
- 5推送提醒到 Google Calendar 触发通知
优劣对比
优点
- 配额慷慨且按用户隔离
- webhook（push notifications）实时推送变更
- 与 Workspace 其他 API 共享 OAuth scope 模型
- recurring events、time zones 处理完备
注意事项
- 必须走 OAuth，不能用简单 API key 操作用户数据
- recurring event 修改需理解 instance vs series 区别
- 部分写操作有更严格速率限制
示例请求
curl https://google.com/<endpoint> \
-H "Authorization: Bearer $ACCESS_TOKEN"快速开始
到 console.cloud.google.com 启用 Calendar API，配置 OAuth 凭证。用户授权后拿 access_token，调 calendars.list / events.insert 等端点。需要 scope：https://www.googleapis.com/auth/calendar 或更窄的 calendar.events。
常见问题
API 调用免费吗？+
免费使用；配额按 quota units 计算，普通应用极难触达。
如何监听日历变更？+
用 events.watch 订阅 webhook（push notifications），Google 会向你配置的 HTTPS 端点推送变更。
能修改用户私有事件吗？+
需要用户授予对应 OAuth scope，且事件 ACL 允许；只读 scope 无法写入。
怎么处理跨时区事件？+
事件中的 timeZone 字段用 IANA 名称（如 Asia/Shanghai），不要用 UTC offset，否则 DST 切换会出错。
技术细节
- 认证方式
- oauth
- 计费
- free
- 协议
- REST
- SDK
- python, javascript, java, go, ruby
- 响应时间
- 48 ms
- 上次巡检
- 2026/5/12 07:37:30
接口端点
从 OpenAPI spec 自动解析。显示 12 / 37 个未弃用端点。
/calendarscalendars/calendars/{calendarId}calendars/calendars/{calendarId}calendars/calendars/{calendarId}calendars/calendars/{calendarId}calendars/calendars/{calendarId}/aclacl/calendars/{calendarId}/aclacl/calendars/{calendarId}/acl/{ruleId}acl/calendars/{calendarId}/acl/{ruleId}acl/calendars/{calendarId}/acl/{ruleId}acl/calendars/{calendarId}/acl/{ruleId}acl/calendars/{calendarId}/acl/watchacl另有 25 个端点未显示，详见 OpenAPI spec。
更多来自 Google 的 API
Google Workspace Admin SDK API 程序化管理 Workspace 组织：用户、组、设备、域名、审计日志、组织单元。
AdMob API 可读取 accounts、apps、adUnits 与 adSources，并生成 mediation 与 network 报表。
AdSense Host API 支持 accounts、adclients、adunits、reports 和 adcode 生成，适合托管式广告平台集成。
Apigee API 可管理 API proxy、deployments、attributes 与 organizations，适合把 API 网关运维接入自动化流程。
Google BigQuery API 是 GCP 旗舰数据仓库的 REST 接口：执行 SQL 查询、管理 datasets/tables、流式插入、ML 内置。
Binary Authorization API 用于管理 attestors、IAM policy 与镜像验证流程，面向 GKE 和 Anthos 的发布门禁。
Business Profile Performance API 能拉取 location 指标时间序列和 search keyword impressions，服务 Google 商家资料分析。
Chrome Management API 管理企业 Chrome 浏览器和 Chrome OS 设备：策略下发、扩展程序管控、用户活动报告。