使用 API 和 cURL 调用 Google App 脚本函数

Question

如果这个问题太简单，我深表歉意，但我是使用 cURL 的新手。我在 Google App Script 中创建了一个函数来合并来自两个 Google Docs 的文本。函数是这样的：

function mergeGoogleDocs(doc1, doc2) {

var BaseDoc = DocumentApp.openById(doc1);
var body = BaseDoc.getActiveSection();

var otherBody = DocumentApp.openById(doc2).getActiveSection();
var totalElements = otherBody.getNumChildren();
for( var j = 0; j < totalElements; ++j ) {
var element = otherBody.getChild(j).copy();
var type = element.getType();
if( type == DocumentApp.ElementType.PARAGRAPH )
  { 
  body.appendParagraph(element); 
  }
else if( type == DocumentApp.ElementType.TABLE )
{
body.appendTable(element);
}
else if( type == DocumentApp.ElementType.LIST_ITEM )
{
body.appendListItem(element);
}
else
{
throw new Error("Error de Formato: "+type);
}
}

}

我已经测试了脚本，如果我输入两个文档 ID，它就可以完美运行。我希望能够使用 cURL 从 Google 外部调用此函数。为此，我启用了所有必要的（凭据、范围权限、项目编号并将其实现为可执行 API）。我一直在寻找一种使用 cURL 运行该函数的方法，并且只在这个 post 中找到了这个：

curl -X POST -L \
    -H "Authorization: Bearer ### access token ###" \
    -H "Content-Type: application/json" \
    -d "{function: '### function name ###',devMode: true}" \
    "https://script.googleapis.com/v1/scripts/### script ID ###:run"

我需要包含两个document_IDs 作为参数，因此根据上一篇文章中的信息我创建了以下序列：

curl -X POST -L \
-H 'Authorization: Bearer ##access token##' \
-H "Content-Type: application/json" \
-d '{"function": "##function name##", "parameters": {"doc1":"##docID1##,"doc2":"##docID2##"}, devMode: true}' \ 
"https://script.googleapis.com/v1/scripts/### script ID ###:run"

但是当我运行该序列时，我收到以下错误消息：

{
  "done": true,
  "error": {
    "code": 3,
    "message": "ScriptError",
    "details": [
      {
        "@type": "type.googleapis.com/google.apps.script.v1.ExecutionError",
        "scriptStackTraceElements": [
          {
            "function": "##function name##",
            "lineNumber": 3
          }
        ],
        "errorMessage": "Exception: Document is missing (perhaps it was deleted, or you don't have read access?)",
        "errorType": "ScriptError"
      }
    ]
  }
}

有人可以帮我正确放置序列以使应用脚本正常工作吗？

非常感谢。

沃迪亚姆

Answer 1

我相信你的目标和你目前的情况如下。

• 您想将 ##docID1## 和 ##docID2## 的值赋予 Google Apps 脚本项目中的 mergeGoogleDocs(doc1, doc2) 函数。
• 您想使用 CURL 命令运行函数。
• 在您的情况下，在 Google Apps Script API 中使用“scripts.run”方法的准备工作已经完成。
• 您的 Google Apps 脚本运行良好。

修改点：

• 为了给function mergeGoogleDocs(doc1, doc2) {} 提供2 个参数，请将##docID1## 和##docID2## 的值赋给parameters 的数组，如"parameters": ["##docID1##", "##docID2##"]。在这种情况下，当使用 "parameters": ["##docID1##", "##docID2##"] 时，数组的每个元素都对应于 Google Apps 脚本中函数的每个参数。
• 例如，您要将##docID1##和##docID2##的值作为mergeGoogleDocs(doc1, doc2)的参数传递给函数，请设置"parameters": ["##docID1##", "##docID2##"]这样的值。
• 顺便说一句，在您的第二个 curl 命令中，当使用 {"doc1":"##docID1##,"doc2":"##docID2##"} 时，"##docID1## 没有被括起来。

当以上几点反映到你的 curl 命令时，它变成如下。

修改 curl 命令：

curl -X POST \
-H 'Authorization: Bearer ### access token ###' \
-H "Content-Type: application/json" \
-d '{"function": "##function name##", "parameters": ["##docID1##", "##docID2##"], devMode: true}' \
"https://script.googleapis.com/v1/scripts/### script ID ###:run"

注意：

• 当你想使用{"doc1":"##docID1##","doc2":"##docID2##"}作为弧度时，你也可以使用下面的curl命令。

    curl -X POST \
    -H 'Authorization: Bearer ### access token ###' \
    -H "Content-Type: application/json" \
    -d '{"function": "##function name##", "parameters": [{"doc1":"##docID1##","doc2":"##docID2##"}], devMode: true}' \
    "https://script.googleapis.com/v1/scripts/### script ID ###:run"
  

  • 在这种情况下，请在 Google Apps Script 端修改您的脚本，如下所示。

    • 来自

        function mergeGoogleDocs(doc1, doc2) {
      

    • 到

        function mergeGoogleDocs({doc1, doc2}) {
      

• 当参数只有一个时，似乎可以使用"parameters": "value"。即我确认"parameters": "value"的结果和"parameters": ["value"]的结果是一样的。

参考：

• Method: scripts.run