如何通过Tasks API创建非全天任务？

核心原因：Tasks API无“全天”字段，状态是Calendar的渲染/本地偏好 #

• Google Tasks的API schema中没有专门存储“是否全天”的属性，Tasks的时间仅通过due（截止日期）、completed（完成时间）等字段定义。
• Calendar应用显示的“全天”状态，本质是它对Tasks数据的默认映射规则：当Tasks的due仅包含日期（无具体时间，格式如YYYY-MM-DD）时，Calendar会自动渲染为“全天”任务；若due包含具体时间（格式如YYYY-MM-DDTHH:MM:SSZ），则显示为对应时间点的非全天任务。

手动修改后的状态保留逻辑 #

当你在Calendar应用中取消“全天”复选框并保存时：

• 这个修改并没有同步到Tasks API的后端服务器，所以调用API返回的任务JSON完全不变。
• 该状态是Calendar客户端本地存储的自定义显示偏好，Calendar会记住你对该任务的特殊渲染设置，后续加载时优先使用这个偏好，而非默认的映射规则。

验证与解决方案 #

如果需要通过API直接控制Calendar中任务的非全天显示，只需在创建/更新任务时，给due字段设置包含具体时间的ISO格式值，示例：

{
  "title": "测试任务",
  "due": "2024-05-20T15:30:00Z"
}

此时Calendar会自动显示为非全天的具体时间任务，无需手动修改。

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