google-apps-script - Google App Script Execution API 的正确范围？

Question

我希望通过 Execution API 运行 Google App Script 来自动化一些 HR 工作.在不深入细节的情况下，我想将员工评估数据作为参数传递到 App 脚本中。该脚本然后将使用此数据来编译“员工评论”GDoc。

到目前为止，我已经使用 Execution API 运行了一个简单的测试应用程序脚本.例如，我可以成功运行一个记录字符串或与电子表格交互的简单函数。到目前为止，一切都很好。

但我在尝试写入 GDoc 时遇到了问题(不幸的是，这对我的任务来说是不可或缺的)。这是我的配对脚本:

// TODO: Eventually, we'll pass these variables as arguments
var docId = "MY-DOC-ID";

// Find the team member review doc
var doc = DocumentApp.openById(docId);

// Replace placeholder text
var docBody = doc.getActiveSection();
docBody.replaceText('{{DATE}}', "Date set by App Script!!!");
doc.saveAndClose();

当我在应用程序脚本网络用户界面中按下“运行”按钮时，此脚本会起作用。但是当我尝试通过 Execution API 运行时，我得到:

{
  "error": "unauthorized_client",
  "error_description": "Unauthorized client or scope in request."
}

显然我没有提供正确的范围？按照文档，我可以在 Project Properties > Scopes 中找到必要的范围:

但是当我尝试添加该范围时，它不起作用。正如我所说，其他范围(例如 https://www.googleapis.com/auth/spreadsheets )工作得很好。也许 auth/documents 范围不再受支持，或者他们的 API 中存在错误？

问题

1. 正确的范围是什么？我可以看到 a big list here但我没看到https://www.googleapis.com/auth/documents ，那么呢？
2. 还有其他建议吗？例如，是否可以直接使用 Google 客户端 API 写入 Google 文档(即不使用应用脚本)？

Answer 1

呵呵。我想出了解决问题的办法。虽然这是一个愚蠢的错误，但它仍然值得发布，因为它可能会在未来避免其他人的困惑。

首先，简要介绍一下我的设置。我正在使用 Service Account 向 Google Client API 进行身份验证.此外，在使用服务帐户设置时很常见，我冒充了我们组织内的用户(特别是我自己的帐户)。

我遗漏的步骤(事后看来很明显)...

1. 以您要模拟的人的身份登录 App Script 网络用户界面。
2. 按播放按钮手动运行脚本
3. 如果模拟用户尚未授予访问所需范围的权限，系统将提示您这样做。
4. 授予访问权限后(特别针对 https://www.googleapis.com/auth/documents 范围)，我的授权错误消失了。

所以教训:确保您模拟的帐户已授予您脚本所需的所有范围的访问权限。