调用Google Apps Script API创建部署时遭遇500内部错误求助

针对你遇到的调用https://script.googleapis.com/v1/projects/{scriptId}/deployments接口返回500内部错误的问题，结合同类问题的排查经验，可从以下几个方向尝试解决：

• 检查脚本项目本身的有效性
  先手动在Google Apps Script编辑器中尝试创建部署，如果手动操作也失败，说明脚本存在语法错误、未保存的草稿内容，或者有未解决的外部引用（比如缺失的服务依赖）。这类脚本本身的问题会导致API调用返回模糊的500错误，先修复脚本后再重试API。

• 验证请求体参数的正确性
  确保POST请求体包含必填参数且格式符合要求：

  • 必须指定versionNumber（对应已保存的脚本版本号）或使用manifest指定头部版本；
  • deploymentConfig中的字段需符合规范，比如description长度不能超过限制；
    示例合法请求体：

  {
    "versionNumber": 1,
    "deploymentConfig": {
      "description": "测试部署",
      "manifest": {}
    }
  }
  

  同时确认请求头已设置Content-Type: application/json。

• 确认GCP项目关联的一致性
  在Apps Script编辑器的「项目设置」中查看脚本关联的GCP项目ID，确保和你用来调用API的GCP项目完全一致。如果两者不匹配，即使GCP配置了权限，也会导致API调用失败。

• 检查调用账号的权限范围
  确保发起API请求的账号拥有该Apps Script项目的编辑权限，仅配置GCP的API启用和服务账号权限是不够的，还需要账号本身对脚本项目有足够的操作权限。

• 排查临时服务故障
  500错误本身属于服务端内部问题，可能是Google服务的临时波动。可以间隔一段时间后重试，或者在Google Workspace状态页面确认是否有相关服务故障通知。

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