选择 Google 幻灯片 API 范围

本文档包含 Google 幻灯片 API 专属授权和 身份验证信息。在阅读本文档之前,请务必阅读 Google Workspace 的常规身份验证和授权信息,请访问 了解身份验证和授权

配置 OAuth 2.0 以进行授权

配置 OAuth 权限请求页面并选择范围 指定向用户显示哪些信息,以及注册 以便日后发布

Google 幻灯片 API 范围

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

用户安装应用时,系统会要求用户验证使用的范围 。通常,您应选择范围最狭窄的范围 尽可能避免请求您的应用不需要的范围。用户数更多 随时向有限且明确说明的范围授予访问权限。

我们建议您尽可能使用非敏感范围,因为它按文件授予权限 访问权限范围,并限制对应用所需特定功能的访问权限。

该幻灯片 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 范围的详细信息,请参阅 OAuth 2.0 Scopes for Google API 中所述。