SharePoint Online getActivitiesByInterval接口timeSpentInSeconds始终为0问题

以下是导致timeSpentInSeconds字段始终返回0的核心原因：

• 站点级别接口不支持时长统计：/sites/{siteId}/getActivitiesByInterval这个站点级聚合接口的设计目标仅统计访问动作次数和访问者数量，不包含用户在站点内的停留时长计算。该字段仅在文件、列表项这类细粒度资源的活动统计接口（如/drives/{driveId}/items/{itemId}/getActivitiesByInterval）中才会返回有效数据。

• 数据采集逻辑的层级限制：SharePoint的使用分析数据里，用户停留时长是基于单个文件或页面的交互行为（比如打开后的持续活跃时间）来统计的，站点级别的聚合并未汇总这些细粒度的时长数据，因此返回0是接口的预期行为。

• 官方定义的字段适用范围：Microsoft Graph API的设计规范中，timeSpentInSeconds字段仅绑定到具体内容资源（文件、列表项等）的活动统计，站点作为容器级资源，暂未纳入该字段的数据采集范围。

验证建议：你可以调用某个具体文件的getActivitiesByInterval接口进行测试，正常情况下会返回非零的timeSpentInSeconds值，以此确认数据采集逻辑的有效性。

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