咨询：Google Tasks API添加扩展属性/客户端数据后无法取回的问题

可行性结论 #

Google Tasks API不支持存储clientData或private类型的extendedProperties——尽管创建任务时提交这些字段不会触发错误，但API会直接忽略它们，不会进行存储，因此后续读取任务时自然无法获取到这些数据。这是Tasks API与Contacts、Calendar API的功能差异点。

替代实现方案 #

如果需要为任务附加自定义数据，可采用以下两种可行方式：

1. 利用notes字段存储序列化后的自定义数据

Tasks API的notes字段支持存储文本内容，你可以将自定义的键值对序列化为JSON字符串存入其中，读取任务时再解析该字符串还原数据。注意notes字段的字符上限为10000，足够存储大多数场景下的自定义元数据。

示例创建请求JSON：

{
    "title": "Test Task to Google",
    "notes": "{\"ABCCoCreated\": \"yes\", \"isABCCo\": \"yes\"}",
    "due": "2024-05-13T07:00:00-07:00",
    "status": "needsAction"
}

读取任务后，只需将返回结果中的notes字段内容解析为JSON对象，即可获取自定义属性。

2. 维护外部存储关联任务ID

如果自定义数据量较大或需要更复杂的存储结构，可以在自己的数据库中建立任务ID与自定义数据的映射关系：

• 创建任务成功后，记录API返回的任务id
• 将该id与你的自定义数据关联存储在外部数据库中
• 读取任务时，通过返回的id查询外部数据库获取对应的自定义数据

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