OAuth 客户端验证

请求某些敏感 OAuth 范围的 Google OAuth 客户端需要接受 Google 的验证。

注意： 如果 Apps 脚本项目的所有者和用户属于同一 Google Workspace 网域或客户，则无需进行验证。

如果您不验证脚本项目的 OAuth 客户端，当您网域外的用户尝试授权您的脚本时，系统会向其显示未经验证的应用界面。 未经验证的授权流程允许这些用户授权未经验证的应用并使用这些应用，但前提是他们确认自己了解相关风险。未经验证的应用用户的总数也设置了上限。

有关详细信息，请参阅以下文章：

• 未经验证的应用
• OAuth 应用验证常见问题解答
• Google API 服务：用户数据政策

 

图 1：未经验证的应用界面

图 2：未经验证的应用授权流程

 

此变更适用于 Google OAuth Web 客户端，包括所有 Apps 脚本项目使用的客户端。通过向 Google 验证您的应用，您可以从授权流程中移除“未经验证的应用”屏幕，并让用户确信您的应用不是恶意应用。

未经验证的应用

插件、Web 应用和其他部署（例如使用 Apps Script API 的应用）可能需要进行验证。

注意： 插件不再作为插件审核流程的一部分进行验证，必须在发布插件之前进行验证。

适用性

如果应用使用敏感的 OAuth 范围，则未经验证的应用屏幕可能会在授权流程中显示。该流程的存在（以及由此产生未经验证的应用授权流程）取决于应用是从哪个账号发布的，以及哪个账号尝试使用该应用。例如，在特定 Google Workspace 组织内部发布的应用不会导致该网域中的账号出现未经验证的应用授权流程，即使该应用尚未经过验证也是如此。

下表说明了哪些情况会导致未经验证的应用授权流程：

	客户已通过验证	发布者是客户 A 的 Google Workspace 账号	脚本位于客户 A 的共享云端硬盘中	发布者是 Gmail 账号
用户是客户 A 的 Google Workspace 账号	正常身份验证流程	正常身份验证流程	正常身份验证流程	未经验证的身份验证流程
用户是客户 A 的 Google Workspace 账号，但不是客户 A 的账号	正常身份验证流程	未经验证的身份验证流程	未经验证的身份验证流程	未经验证的身份验证流程
用户是 Gmail 账号^1	正常身份验证流程	未经验证的身份验证流程	未经验证的身份验证流程	未经验证的身份验证流程

¹ 任何 Gmail 账号，包括用于发布应用的账号。

用户数上限

可以通过未经验证的应用流程授权应用的用户数量设有上限，以限制可能的滥用行为。如需了解详情，请参阅 OAuth 应用用户限制。

申请验证

您可以申请验证应用使用的 OAuth 客户端及其关联的 Cloud Platform (GCP) 项目。应用通过验证后，您的用户将不再看到表明应用未经验证的屏幕。此外，您的应用将不再受用户上限的限制。

要求

如需提交 OAuth 客户端以供验证，您必须满足以下要求：

1. 您必须拥有一个网域中的网站。该网站必须托管可公开访问的页面，其中应描述您的应用及其隐私权政策。您还必须在 Google 上验证您对网站的所有权。

   注意： 您无需通过此网域中的账号发布应用，但网域所有者必须是脚本项目的编辑者或所有者。

2. 脚本项目使用的 Google Cloud 项目必须是您拥有修改权限的标准 Google Cloud 项目。如果您的脚本使用的是默认 Google Cloud 项目，则必须切换到标准 Google Cloud 项目。

此外，您还必须提供以下必需素材资源：

• 应用名称。应用的名称；此名称会显示在同意屏幕上。该名称应与应用在其他位置（例如已发布应用的 Google Workspace Marketplace 详情）中使用的名称一致。
• 应用徽标。要在同意屏幕中使用的应用徽标 JPEG、PNG 或 BMP 图片。文件大小不得超过 1MB。
• 支持电子邮件地址。此电子邮件地址会显示在权限请求页面上，供用户在需要应用支持时联系。可以是您的电子邮件地址，也可以是您拥有或管理的 Google 群组。
• 范围。您的应用使用的所有范围的列表。您可以在 Apps 脚本编辑器中查看您的范围。
• 已获授权的网域。此列表包含与您的应用相关的信息。您的应用的所有链接（例如必需的隐私权政策页面）都必须托管在已获授权的网域中。
• 应用首页网址。描述应用的首页的位置。此位置必须托管在已获授权的网域上。
• 应用隐私权政策网址。描述应用隐私权政策的网页的位置。此位置必须托管在已获授权的网域上。

除了上述必需的素材资源外，您还可以选择提供指向说明应用服务条款的网页的应用服务条款网址。如果提供，此位置信息必须位于授权网域中。

步骤

1. 如果您尚未执行此操作，请验证您用于托管脚本项目的隐私权政策和其他信息的所有授权网域的所有权。网域的经过验证的所有者必须是脚本项目的 Editor 或 Owner。
2. 在 Apps 脚本项目中，点击概览图标 。 在项目 OAuth 范围下，复制脚本项目使用的范围。

3. 使用您收集的文字和网址素材资源，为应用的 Google Cloud 项目完成 OAuth 权限请求页面。

   1. 列出托管您应用信息（例如隐私权政策）的已获授权的网域。

   2. 如需添加应用范围，请点击添加或移除范围。随即显示的对话框会尝试自动检测您在 Google Cloud 控制台中启用的 API（例如高级服务）的范围。您可以选中相应复选框，从此列表中选择范围。

      此自动检测到的列表并不总是包含 Apps 脚本内置服务使用的范围。您必须在手动添加范围下输入这些范围。

      完成后，点击更新。

4. 输入所有必需信息后，点击保存。

5. 点击提交以供验证，开始验证请求。

大多数验证申请会在 24 到 72 小时内收到回复。 您可以在 OAuth 同意屏幕表单顶部查看验证状态。当您的 OAuth 客户端通过验证后，您的应用即通过验证。

注意： 如果您的应用已通过验证，但您后来决定改用其他 Google Cloud 项目，则必须重复执行这些步骤，才能使应用保持已验证状态。