使用Apps Script API创建文件时遇Invalid JSON payload received错误如何解决？

我来帮你拆解这个常见的API请求错误——既然你已经在清单里配置了授权范围，那问题大概率出在请求的JSON payload本身或者请求头设置上，咱们一步步排查：

• 先确保JSON结构完全符合API要求
  创建Apps Script项目的API请求有明确的必填字段，最核心的就是title，而且整个JSON的语法必须严格合规。举个正确的基础示例：

  {
    "title": "My New Script Project",
    "parentId": "your-drive-folder-id-here" // 可选，指定存储位置
  }
  

  要避免这些低级错误：用了单引号代替双引号、字段名拼写错误（比如把title写成name）、末尾多了逗号（比如"title": "Test",后面没有其他字段却留着逗号）。这些都会直接导致API解析payload失败。

• 处理payload中的特殊字符
  如果你的脚本标题或者其他字段里包含双引号、反斜杠、换行符这类特殊字符，必须正确转义。比如标题是"Daily Report" Script，要写成"\"Daily Report\" Script"，不然会打破JSON的结构规则，触发解析错误。

• 确认请求头的Content-Type设置正确
  这是很多人容易忽略的点：发送请求时必须把Content-Type头设置为application/json。比如用curl的话，要加上-H "Content-Type: application/json"；如果是用代码发送请求（比如Node.js、Python），一定要在请求头里明确这个字段。如果没设置，API会把你的payload当成普通文本处理，自然识别不了JSON格式。

• 再核对授权范围的正确性
  虽然你说已经配置了清单的授权范围，但还是要确认用的是API要求的范围：创建项目需要https://www.googleapis.com/auth/script.projects.create，如果要关联到Drive文件夹，还需要https://www.googleapis.com/auth/drive。范围不匹配的话，有时候会伴随payload错误提示，确认一下能排除这个潜在问题。

• 用简化payload做测试排查
  先发送最精简的请求，只保留必填的title字段，比如：

  {
    "title": "Minimal Test Script"
  }
  

  如果这个请求能成功，再逐步添加其他字段（比如parentId、scriptId等），这样就能快速定位是哪个字段的格式出了问题。

内容的提问来源于stack exchange，提问作者Alan Wells