使用Google Drive API v2 Patch请求时遇404：指定属性未找到

我之前在使用Drive API v2操作文件属性时也碰到过一模一样的404问题，结合官方文档和实际排查经验，给你梳理几个关键的排查方向和解决办法：

• 先确认目标属性是否真的存在
  错误提示明确说找不到myNewPr这个私有属性，所以第一步你得先验证这个属性还在不在目标文件上。调用properties.list接口，传入你的文件ID并指定visibility=PRIVATE，看看返回的属性列表里有没有myNewPr。有可能是之前的某个操作（比如其他业务代码的删除逻辑、或者API调用时的误操作）把这个属性删掉了，也有可能你不小心传错了文件ID，导致查的是另一个没有该属性的文件。

• 别搞混Patch和Insert的用途
  这里很容易踩坑：Drive API v2的properties.patch是用来更新已存在的属性的，它本身不负责创建新属性。你之前用Patch成功添加属性，大概率是当时这个属性已经存在了（比如之前用Insert创建过），后来属性被删除后，再用Patch就会触发404。如果你的需求是“确保属性存在，不存在就创建，存在就更新”，那得做个判断逻辑：先调用list检查属性是否存在，不存在就用properties.insert创建，存在再用Patch更新。

• 核对请求参数的一致性
  检查你Patch请求里的visibility参数是不是严格等于PRIVATE，和当初创建属性时的设置完全一致。如果请求里的visibility和属性实际的可见性不匹配，API也会返回找不到属性的错误。另外，再确认一遍文件ID、访问令牌有没有传错，令牌有没有过期——过期的令牌有时候也会导致奇怪的权限相关报错。

• 实操示例参考
  给你贴几个curl命令的示例，方便你快速验证：

  1. 检查私有属性列表：

     curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
       "https://www.googleapis.com/drive/v2/files/YOUR_FILE_ID/properties?visibility=PRIVATE"
     

  2. 如果属性不存在，创建新属性：

     curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
       -H "Content-Type: application/json" \
       -X POST \
       -d '{"key": "myNewPr", "value": "your_target_value", "visibility": "PRIVATE"}' \
       "https://www.googleapis.com/drive/v2/files/YOUR_FILE_ID/properties"
     

  3. 如果属性存在，更新属性值：

     curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
       -H "Content-Type: application/json" \
       -X PATCH \
       -d '{"value": "updated_value"}' \
       "https://www.googleapis.com/drive/v2/files/YOUR_FILE_ID/properties/myNewPr?visibility=PRIVATE"
     

一般来说，按照这个流程排查，就能解决大部分类似的404问题。

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