选择 Google Calendar API 范围

本文档包含 Google Calendar API 专用授权和身份验证信息。在阅读本文档之前,请务必参阅 了解身份验证和授权,了解 Google Workspace 的一般身份验证和授权信息。

配置 OAuth 2.0 以进行授权

配置 OAuth 权限请求页面并选择范围,以定义向用户和应用审核者显示哪些信息,并注册应用以便以后发布。

Calendar API 权限范围

如需定义授予应用的访问权限级别,您需要确定并声明授权范围。授权范围是 OAuth 2.0 URI 字符串,其中包含 Google Workspace 应用名称、它访问的数据类型以及访问权限级别。范围是您的应用请求处理 Google Workspace 数据(包括用户的 Google 账号数据)的请求。

在用户安装您的应用时,系统会要求用户验证该应用使用的范围。通常,您应尽可能选择最窄的范围,并避免请求应用不需要的范围。用户更乐意向描述清晰的有限范围授予访问权限。

Calendar API 支持以下范围:

范围 含义
https://www.googleapis.com/auth/calendar 查看、修改、共享以及永久删除您使用 Google 日历可以访问的所有日历。
https://www.googleapis.com/auth/calendar.readonly 查看和下载您使用 Google 日历可以访问的任何日历。
https://www.googleapis.com/auth/calendar.events 查看和修改您在所有日历上的活动。
https://www.googleapis.com/auth/calendar.events.readonly 查看您在所有日历上的活动。
https://www.googleapis.com/auth/calendar.settings.readonly 查看您的日历设置。
https://www.googleapis.com/auth/calendar.addons.execute 作为日历插件运行。