调用Google API实现邮件合并出现400不支持操作错误如何解决？

错误本质 #

你调用documents().batchUpdate接口触发的400报错，核心是当前操作的文档不满足接口执行条件，或者请求内容包含文档不支持的操作。

修复步骤 #

• 确认操作的文档为Google Docs原生格式
  如果你操作的是上传的本地docx/doc文件，没有转换为Google Docs格式，接口会直接拒绝请求。你可以手动打开copy_id对应的文档链接，查看地址是否为docs.google.com/document/d/开头，如果文件菜单中有「转换为Google Docs」选项，先完成转换再调用接口。
• 核对账号权限
  确认你API认证使用的账号（普通谷歌账号或服务账号）对该文档拥有编辑权限，仅有查看/评论权限会触发该报错。如果使用服务账号调用，需要把服务账号邮箱添加到文档的共享列表，授予编辑权限。
• 排查请求列表reqs的合法性
  先打印reqs变量的完整内容，排查是否存在以下不支持的操作：
  1. 对开启了建议模式的文档执行内容插入、删除操作
  2. 请求包含修改页眉页脚、批注、受保护内容的操作，而该文档开启了内容保护限制
  3. 插入的特殊格式内容（如自定义表格、特殊编码的图片）超出了文档兼容模式的支持范围
     你可以先用最简单的测试请求验证接口是否能正常调用：

  # 测试用请求，替换你原来的reqs即可
  test_reqs = [
    {
      'insertText': {
        'location': {'index': 1},
        'text': '接口测试文本'
      }
    }
  ]
  DOCS.documents().batchUpdate(body={'requests': test_reqs}, documentId=copy_id, fields='').execute()
  

  如果测试请求能正常执行，说明你原本的reqs请求内容存在问题，逐行校验每个请求项的参数即可。
• 核对文档ID正确性
  确认你传入的copy_id和DOCS_FILE_ID都是Google Docs的文档ID，不要误传Sheets ID、Drive文件夹ID，文档ID是文档地址栏中d/和/edit之间的字符串。

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