Google Tasks API Patch调用意外覆盖时间字段问题排查

哎，我之前也踩过这个坑！这真不是你操作错了，而是Google Tasks API的patch接口在处理时间字段时有个特殊的默认逻辑，容易让人踩雷。

问题根源 #

Google Tasks里的due（截止时间）这类字段，存储的是包含日期+时间的完整ISO格式字符串（比如2024-05-20T14:30:00Z）。当你用patch接口只传title时，API并不会默认保留原有的时间信息——它会把缺失的due字段理解为“要把任务改成全天模式”，直接把时间部分抹掉，只保留日期，就出现了你看到的情况。

解决办法 #

最靠谱的解决方式是明确指定要更新的字段，也就是用上API的updateMask参数，告诉API只处理你传入的title，完全忽略其他字段。

具体操作分两步：

1. 在请求URL里添加updateMask=title参数，明确告诉接口只更新标题字段；
2. 请求体里只传title字段即可，不用带任何其他内容。

举个curl请求的例子，一看就懂：

curl -X PATCH "https://tasks.googleapis.com/tasks/v1/lists/{你的任务列表ID}/tasks/{你的任务ID}?updateMask=title" \
  -H "Authorization: Bearer 你的访问令牌" \
  -H "Content-Type: application/json" \
  -d '{"title": "更新后的新标题"}'

如果之后需要同时更新多个字段，比如标题和备注，只要把updateMask改成updateMask=title,notes就行，用逗号分隔多个字段名。

另外还有个笨办法：每次patch时都把原任务的due字段完整传回去，但这样太麻烦，不如用updateMask来得省心。

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