Google Calendar API — Events list

Google Calendar 官方 Events:list 通过 GET 列出指定日历事件，支持分页、时间过滤和增量同步；访问范围依日历权限及授权scope，未连接账户或读取事件。

根据公开资料整理 · 尚未被提供者认领。提交者名称和样例测试不是提供者授权、本站认证或持续可用承诺。

整理进度：已整理 · 语义分类：日历事件列表与增量同步读取 · 证据等级：公开文档，未实测。

公开来源正文附件（安全文本） · 0a0533fa00319cb14cd52de9d68c3a9f6356f2ccdd58788a12c47d105b60c932

本次官方参考页明确 GET https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events，且不得提供请求体。calendarId为目标日历标识，primary仅表示已登录用户的主日历。页面标注Authorization optional并列可用授权scopes；这不等于可匿名读取任意私人日历。成功响应包含items事件列表、日历信息及分页/同步token，实际可见详情依accessRole。

NavoNavo 是公共能力目录，保留来源、适用条件与使用说明。继续按条件查找 · 认识目录与机器入口

固定版本的深度资料

名片 cap-3a49cabb02f5149fc02aa41e · 版本 2 · 保存此版本引用

尚未深检；没有深度profile，条件保持未知，不表示不支持。

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

稳定标识: cap-3a49cabb02f5149fc02aa41e
名片版本: 2
资料更新: 2026-10-24T18:49:36.9607111+00:00
原作者 / 提供者: 未知
可用状态: 未知；收录不代表正在接单或有实时库存。
本站收费: 免费；第三方条件另行核对。

输入

calendarId路径参数；可选q、eventTypes、singleEvents、orderBy、时区与事件筛选。
maxResults默认250，最多2500；pageToken用于后续分页。
timeMin是事件结束时间的排他下界，timeMax是事件开始时间的排他上界，均需带时区RFC3339且timeMin<timeMax。
syncToken用于增量变更；不能与q、orderBy、timeMin/timeMax、updatedMin、iCalUID及指定extended-property过滤同用。

输出

日历事件集合，含kind、etag、summary/description、updated、timeZone、accessRole、items及可用defaultReminders。
有后续页时返回nextPageToken，最后页才提供nextSyncToken用于后续增量同步。
accessRole影响详情可见性，例如reader可见私人事件存在但细节隐藏；不会因本API说明获得额外权限。

使用方式

类型: HTTP 接口
入口: 原使用入口
HTTP 方法: GET

鉴权：OAuth 授权。页注明授权可选，同时列出calendar.readonly、calendar.events.readonly等scope；实际是否需要和能看到什么依目标日历/访问权限。账户授权及凭据由使用者自行提供，不推定当前已连接或公开读取私人日历。

运行前提

提供可访问的calendarId；primary须在对应已登录用户上下文理解。
若需授权，取得本方法接受的至少一个适用scope和实际日历权限。
GET不含请求体，按nextPageToken完整分页；增量同步遵守参数互斥。

公开请求示例

{
  "credential_requirement": "\u6309\u76EE\u6807\u65E5\u5386\u6743\u9650\u7531\u4F7F\u7528\u8005\u81EA\u884C\u63D0\u4F9B\u9002\u7528\u6388\u6743",
  "documentation_text": "\u5B98\u65B9\u8BF7\u6C42\u6A21\u677F\uFF08\u672A\u6267\u884C\uFF09\uFF1AGET https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events\uFF0C\u4E0D\u63D0\u4F9B\u8BF7\u6C42\u4F53\u3002calendarId\u4E0E\u9002\u7528\u8D26\u6237\u6388\u6743\u7531\u4F7F\u7528\u8005\u81EA\u884C\u63D0\u4F9B\u3002",
  "method": "GET",
  "request_body": null,
  "url_template": "https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events"
}

代码仓库不是正在运行的 API；网页可打开不证明业务成功。外部命令仅为资料，执行、资料分享和付费需另行授权。

第三方价格与条款

未知。本次Events:list参考页未给收费、免费额度、速率或项目/用户配额，Usage limits导航未读取。

价格来源 · 未知

资料去向

提供者服务器。日历标识、筛选与授权发送至Google Calendar服务，结果可能包含私人事件和参与者信息，范围由日历accessRole/scopes决定。日志保留、驻留和客户端保存条件未由本页确认。

限制

分页可能少于maxResults甚至空items仍有nextPageToken，不能据空页提前结束。
orderBy=startTime仅在singleEvents=true时可用，默认顺序未指定但稳定。
syncToken过期返回410，客户端需按正式同步规则重建全量；本次未操作任何本地日历缓存。
增量结果包含删除事件，不允许同步时showDeleted=false，其他参数需与初次同步一致。
文档内容/样例许可不等同实际日历事件数据的使用许可。
本次只读列表契约，不涉及创建/更新/删除事件或邀请。

仍需核对

实际账户/scope、日历访问角色及匿名条件未知。
项目启用条件、价格、速率及配额未知。
具体日历事件、可见详情、分页与同步运行结果未验证。
数据保存、驻留与事件使用条件未知。
未连接账户、列事件、修改日历、邀请任何人或清除缓存。

提交者报告的验证

仅查阅资料 · 未测试

仅读取公开来源；未调用所述工具。

日期: 2026-10-24T18:45:14.2459955+00:00
软件版本: 未知

实际检查

来源HTTPS响应可读取

未验证范围

功能、鉴权、安装、输出质量、长期可用性均未由本站测试。

公开证据

这是有条件的提交者观察。HTTP、安装、执行、输出核对和用户验收分别判断；不计算总体成功率或商业收入。

来源与贡献者

主要公开来源

Events: list | Google Calendar | Google for Developers · 官方文档 · 2026-10-24T18:45:14.2459955+00:00

提交者自述：NAVONAVO public material importer。名称未经身份核验，不等于原作者或执行方。

本次来源读取范围

{
  "url": "https://developers.google.com/workspace/calendar/api/v3/reference/events/list",
  "final_url": "https://developers.google.com/workspace/calendar/api/v3/reference/events/list",
  "status_code": 200,
  "title": "Events: list \u00A0|\u00A0 Google Calendar \u00A0|\u00A0 Google for Developers",
  "description": null,
  "checked_at": "2026-10-24T18:45:14.2459955\u002B00:00",
  "warnings": [
    "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
  ]
}

公开使用观察

暂无公开记录，不代表失败。

有依据的更正与异议

暂无公开记录，不代表失败。

补充观察或有依据的更正

通过同一公开投稿 API 或 MCP 工具提交。只发公开的必要事实，不上传私人任务、身份或凭据。提交者观察不增加商业调用和收益。

更正接口：POST /api/v1/contributions/corrections；观察接口：POST /api/v1/contributions/observations。

{
  "request_id": "replace-with-unique-request-id",
  "public_intake": true,
  "service_id": "cap-3a49cabb02f5149fc02aa41e",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://developers.google.com/workspace/calendar/api/v3/reference/events/list"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

字段、版本冲突和观察分阶段契约 · AI 简明接入说明

完整机器记录 · 收录另一项公开能力

补充公开更正或观察

只提交获准公开的必要事实，不填写私人任务、客户资料或凭据。更正是建议，观察是有条件的提交者报告，不自动变成已核事实、商业调用或收入。

提出有来源的摘要更正

报告有条件的公开观察

结构化表单需要JavaScript；不会以其他格式自动发送。仍可使用原HTTP或MCP接口。