选择 Google 幻灯片 API 范围

本文档包含特定于 Google Slides API 的授权和身份验证信息。在阅读本文档之前,请务必先阅读 了解身份验证和授权,了解 Google Workspace 的一般身份验证和授权信息。

配置 OAuth 2.0 以进行授权

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

Slides API 范围

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

当应用安装完毕后,系统会要求用户验证应用使用的范围。一般来说,您应尽可能选择范围最窄的权限,并避免请求应用不需要的权限。用户更乐意向描述清晰的有限范围授予访问权限。

我们建议尽可能使用非敏感范围,因为这样可以授予每个文件的访问范围,并缩小对应用所需特定功能的访问权限。

Slides API 支持以下范围:

范围代码 说明 用法
https://www.googleapis.com/auth/presentations 查看、修改、创建和删除您使用 Google 幻灯片创建的所有演示文稿。 敏感
https://www.googleapis.com/auth/presentations.readonly 查看您使用 Google 幻灯片创建的所有演示文稿。 敏感
https://www.googleapis.com/auth/spreadsheets 查看、修改、创建和删除您使用 Google 表格创建的所有电子表格。 敏感
https://www.googleapis.com/auth/spreadsheets.readonly 查看您使用 Google 表格创建的所有电子表格。 敏感
https://www.googleapis.com/auth/drive.file 仅查看、修改、创建和删除您通过此应用使用的特定 Google 云端硬盘文件。 推荐
非敏感
https://www.googleapis.com/auth/drive 查看、修改、创建和删除您的所有 Google 云端硬盘文件。 受限
https://www.googleapis.com/auth/drive.readonly 查看和下载您的所有 Google 云端硬盘文件。 受限

下表中的“用途”列根据以下定义指明了每个范围的敏感程度:

  • 非敏感:这些范围提供的授权访问权限范围最小,仅需要进行基本应用验证。如需了解此要求,请参阅提交应用以供验证

  • 敏感:这些范围可让您的应用访问用户授权的特定 Google 用户数据。您需要完成额外的应用验证。如需了解此要求,请参阅敏感范围和受限范围要求

  • 受限:这些范围可广泛访问 Google 用户数据,因此您需要完成受限范围验证流程。如需了解此要求,请参阅 Google API 服务用户数据政策针对特定 API 范围的其他要求。 如果您在服务器上存储(或传输)受限范围的数据,则必须接受安全性评估。

如果您的应用需要访问任何其他 Google API,您也可以添加这些范围。如需详细了解 Google API 范围,请参阅使用 OAuth 2.0 访问 Google API

如需详细了解特定的 OAuth 2.0 范围,请参阅适用于 Google API 的 OAuth 2.0 范围