文件列表API中recency与viewedByMeTime排序键的差异

两者核心区别 #

• recency：是Drive后台计算的综合活跃度排序因子，会加权多个时间维度——包括文件的创建/修改时间、你自身的查看/编辑操作时间，甚至共享文件的他人活动时间等。它的目标是优先展示你最可能关心的、近期有互动关联的文件，排序逻辑是Drive内置的加权算法，比较“智能”但不透明。
• viewedByMeTime：是精确的时间戳字段，仅记录你个人最后一次查看该文件的时间。它只和你自己的查看行为绑定，完全不考虑其他活动（比如共享文件被他人修改但你没查看），逻辑直白且精准。

viewedByMeTime 的适用范围 #

它并非专为共享驱动器设计——不管是个人驱动器里的文件，还是共享驱动器中的文件，只要你查看过，就会生成这个时间戳。在共享场景中，它可以帮你筛选或排序你自己最近看过的共享文件；在个人驱动器里，同样能用来按自身查看时间排序文件。

排序使用建议 #

• 若想获得最贴合“近期关注”的综合排序结果，用orderBy=recency desc，Drive会自动帮你权衡各类活动优先级。
• 若需要严格基于“自身最后查看时间”的精准排序，选择orderBy=viewedByMeTime desc，逻辑清晰且可控。

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