调用Google Keep API创建笔记时返回无效参数错误排查

常见问题排查点 #

• 请求体字段不规范：Google Keep API要求创建笔记的请求必须包含title或textContent至少一项，且字段名必须严格匹配官方定义（比如是textContent而非text_content这类下划线命名）。错误示例可能是字段名写错，正确的请求结构应该是：

  note_payload = {
      "title": "测试标题",
      "textContent": "笔记正文内容"
  }
  

• 权限范围缺失：确认你的OAuth 2.0客户端已申请https://www.googleapis.com/auth/keep权限，只读权限无法执行创建操作。
• 端点或版本错误：确保调用的是v1版本的正确端点https://keep.googleapis.com/v1/notes，不要使用旧版本或错误的路径。
• 无效枚举值：如果设置了color这类枚举字段，必须使用API允许的值（比如LIGHT_BLUE、PINK等），自定义值会触发无效参数错误。
• 多余或无效字段：请求体中不要加入API文档未定义的字段，比如随意添加tags或其他未支持的属性。

调试技巧 #

1. 打印请求体：在调用API前，输出你构造的请求字典，直观检查字段名和值是否符合要求。
2. 用工具直接测试：用Postman或curl构造相同请求体调用API，排除Python代码的序列化问题。
3. 核对官方示例：对比Google Keep API官方提供的创建笔记示例代码，检查自己的请求结构是否一致。

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