本文档包含特定于 Google 日历 API 的授权和身份验证信息。在阅读本文档之前,请务必阅读 Google Workspace 的常规身份验证和授权信息了解身份验证和授权。
配置 OAuth 2.0 以进行授权
配置 OAuth 同意屏幕并选择范围,以定义向用户显示的信息和应用审核者,并注册您的应用以供日后发布。
日历 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 |
作为日历插件运行。 |