本文档包含特定于 Alert Center API 的授权和身份验证信息。在阅读本文档之前,请务必先阅读了解身份验证和授权,熟悉 Google Workspace 的一般身份验证和授权知识。
配置 OAuth 2.0 以进行授权
配置 OAuth 权限请求页面并选择范围,以定义向用户和应用审核者显示哪些信息,并注册应用以便日后发布。
Alert Center API 范围
如需定义授予应用的访问权限级别,您需要确定并声明授权范围。授权范围是一个 OAuth 2.0 URI 字符串,其中包含 Google Workspace 应用名称、应用访问的数据类型以及访问权限级别。范围是您的应用对使用 Google Workspace 数据(包括用户的 Google 账号数据)的请求。
当您的应用安装完毕后,系统会要求用户验证该应用使用的范围。一般来说,您应尽可能选择范围最窄的权限,并避免请求应用不需要的权限。用户更乐意向描述清晰的有限范围授予访问权限。
Alert Center API 支持以下范围:
| 范围 | 含义 |
|---|---|
https://www.googleapis.com/auth/apps.alerts |
对 Alert Center API 的读写权限 |
创建服务账号
如需使用 Alert Center API,您必须使用服务账号并设置全网域授权。如需了解详情,请参阅创建访问凭据。