本文档包含 Google Workspace Events API 专属的授权和身份验证信息。在阅读本文档之前，请务必参阅 了解身份验证和授权，了解 Google Workspace 的一般身份验证和授权信息。
配置 OAuth 2.0 以进行授权
配置 OAuth 权限请求页面并选择范围，以定义向用户和应用审核者显示哪些信息，并注册应用以便以后发布。
Google Workspace Events API 权限范围
如需定义授予应用的访问权限级别，您需要确定并声明授权范围。授权范围是 OAuth 2.0 URI 字符串，其中包含 Google Workspace 应用名称、它访问的数据类型以及访问权限级别。范围是您的应用请求处理 Google Workspace 数据（包括用户的 Google 账号数据）的请求。
在用户安装您的应用时，系统会要求用户验证该应用使用的范围。通常，您应尽可能选择最窄的范围，并避免请求应用不需要的范围。用户更乐意向描述清晰的有限范围授予访问权限。
我们建议您尽可能使用非敏感镜，因为它会授予文件级访问权限范围，并缩小对应用所需特定功能的访问权限。
Google Workspace Events API 使用支持订阅的 Google Workspace 应用中的范围。如果您的应用已使用订阅所需的范围，则无需添加其他范围即可使用 Google Workspace Events API。
下表显示了 Google Workspace Events API 支持的范围：
| 范围代码 | 说明 | 用法 | ||
|---|---|---|---|---|
| Google Chat | ||||
https://www.googleapis.com/auth/chat.bot |
允许 Google Chat 应用查看对话和发送消息。可使用 Chat 应用提供的所有功能。 | 非敏感 | ||
https://www.googleapis.com/auth/chat.memberships |
查看、添加和移除 Google Chat 对话中的成员。 | 敏感 |
||
https://www.googleapis.com/auth/chat.memberships.readonly |
查看 Google Chat 对话中的成员。 | 敏感 |
||
https://www.googleapis.com/auth/chat.spaces |
在 Google Chat 中创建对话和聊天室，以及查看或更新元数据（包括历史记录设置）。 | 敏感内容 | ||
https://www.googleapis.com/auth/chat.spaces.readonly |
查看 Google Chat 中的聊天和聊天室。 | 敏感 |
||
https://www.googleapis.com/auth/chat.messages.reaction 秒 |
在 Chat 中查看、添加和删除对消息的回应。 | 敏感 |
||
https://www.googleapis.com/auth/chat.messages.reactions.readonly |
在 Chat 中查看对消息的回应。 | 敏感 |
||
https://www.googleapis.com/auth/chat.messages |
查看、撰写、发送、更新和删除消息，以及添加、查看和删除对消息的回应。 | 受限 | ||
https://www.googleapis.com/auth/chat.messages.readonly |
在 Google Chat 中查看消息和回应。 | 受限 |
||
| Google Meet | ||||
https://www.googleapis.com/auth/meetings.space.created |
允许应用创建、修改和读取与您的应用创建的会议室相关的元数据。 | 敏感 |
||
https://www.googleapis.com/auth/meetings.space.readonly |
允许应用读取用户有权访问的任何会议室的元数据。 | 敏感 |
||
上表中的“使用情况”列表示每个范围的敏感度，具体定义如下：
非敏感 - 这些镜重提供最小范围的授权访问权限，并且只需进行基本应用验证。如需了解此要求，请参阅准备验证的步骤。
敏感 - 这些范围可提供对用户授权给应用的特定 Google 用户数据的访问权限。您需要完成额外的应用验证。如需了解此要求，请参阅请求敏感镜区的应用应执行的步骤
受限 - 这些范围可提供对 Google 用户数据的广泛访问权限，并且您需要完成受限范围验证流程。如需了解此要求，请参阅 Google API 服务：用户数据政策和针对特定 API 范围的其他要求。如果您在服务器上存储（或传输）受限范围的数据，则必须接受安全评估。
如果您的应用需要访问任何其他 Google API，您也可以添加这些范围。如需详细了解 Google API 范围，请参阅使用 OAuth 2.0 访问 Google API。
如需详细了解特定 OAuth 2.0 范围，请参阅适用于 Google API 的 OAuth 2.0 范围。
OAuth 验证
如需使用某些 OAuth 范围，您的应用可能需要完成 Google 的 OAuth 验证流程。请参阅 OAuth API 验证常见问题解答，确定您的应用何时应进行验证以及需要进行哪种类型的验证。另请参阅 Google 云端硬盘附加服务条款。
必需的身份验证类型
本部分介绍了哪些类型的身份验证是必需的或受支持的，并提供了 Google Workspace Events API 的每种方法支持的范围。
对于 Google Chat 事件的订阅，Google Workspace Events API 支持用户身份验证和应用身份验证，以调用其某些方法。如果 API 方法支持这两种凭据，则调用中使用的凭据类型会影响返回的结果。例如，如果您使用用户身份验证调用 subscriptions.list() 方法，该 API 会返回经过身份验证的用户可以访问的订阅列表。如果您使用应用身份验证，该 API 会返回应用可以访问的订阅列表。如需详细了解 Chat 身份验证类型，请参阅对 Chat 扩展应用和 Google Chat API 请求进行身份验证和授权。
下表显示了每种 Google Workspace Events API 方法所需或支持的范围和身份验证类型：
| 方法 | 需要或支持用户身份验证 | 支持应用身份验证（仅限 Google Chat 应用） | 支持的授权范围 | |
|---|---|---|---|---|
| 创建订阅 | — |
|
||
| 订阅 |
使用用户身份验证时，此方法要求订阅的范围至少支持一种事件类型。
使用应用身份验证（仅限 Google Chat 应用）：
|
|||
| 列出订阅 |
使用用户身份验证时，此方法要求订阅的范围至少支持一种事件类型。
使用应用身份验证（仅限 Google Chat 应用）：
|
|||
| 更新订阅 | — |
|
||
| 重新激活订阅 | — |
|
||
| 删除订阅 |
使用用户身份验证时，此方法要求订阅的范围至少支持一种事件类型。
使用应用身份验证（仅限 Google Chat 应用）：
|
|||
按事件类型划分的范围
使用用户身份验证调用 Google Workspace Events API 时，您必须指定一个或多个与订阅的事件类型对应的范围。
下表显示了每种事件类型支持的授权范围：
| 事件 | 事件类型 | 支持的授权范围 | ||||||
|---|---|---|---|---|---|---|---|---|
| Google Chat | ||||||||
| 发布或更新消息。 |
|
|
||||||
| 添加或删除了回应，或更改了多个回应。 |
|
|
||||||
| 创建、更新或移除会员资格，或更改多个会员资格。 |
|
|
||||||
| 更新或删除聊天室。 |
|
|
||||||
| Google Meet | ||||||||
| 会议开始或结束。 |
|
|
||||||
| 参与者加入或离开会议。 |
|
|
||||||
| 系统生成了录音。 |
|
|
||||||
| 系统生成了转写内容。 |
|
|
||||||