Google Admin SDK Reports API：无法按start_time筛选日历审计日志，报500/400错误

问题场景与测试过程 #

我尝试使用Admin SDK Reports API获取特定用户test01@domain.com已删除的Google Calendar事件，并通过start_time参数进行筛选，调用的API端点为：
GET https://admin.googleapis.com/admin/reports/v1/activity/users/test01@domain.com/applications/calendar?eventName=delete_event&filters=start_time==63894355200

测试操作及结果：

• 使用整数值筛选：filters=start_time==63894355200，返回500内部错误；
• 使用字符串值筛选：filters=start_time=="63894355200"，返回400错误，提示“参数start_time（整数类型）的值"63894355200"无效”。

当不使用筛选获取所有删除事件时，start_time在API响应中的格式为：

{
"name": "start_time",
"intValue": "63894355200"
}

其值类型为intValue（int64）。

提出的问题 #

1. filters参数是否支持intValue（int64）类型的字段？
2. 若不支持，是否有办法通过API直接按start_time筛选，无需客户端事后处理？
3. 这是否是Reports API的已知限制？

已查阅官方activities.list文档，但文档未明确说明是否支持intValue字段的筛选。

问题解答 #

1. filters参数对intValue类型字段的支持
   目前Reports API的filters参数在处理intValue类型字段时存在兼容性问题。从测试结果来看，无论是传入纯整数还是带引号的字符串，都无法正常完成筛选，说明当前API的筛选逻辑未正确适配intValue类型的字段筛选。

2. 无需客户端事后处理的筛选方案
   暂时没有直接通过API按start_time筛选的有效方法，可尝试以下替代思路：

• 使用API顶层的startTime和endTime参数（注意区别于事件的start_time）缩小时间范围，减少返回的数据量；
• 若业务允许，先通过其他可筛选的字段过滤结果，再在客户端处理start_time的筛选。

3. 是否为已知限制
   这属于Reports API的未明确标注限制。官方文档未提及intValue类型字段的筛选支持情况，且实际测试存在功能缺陷，属于文档缺失+功能未覆盖的情况，可通过Google Cloud的Issue Tracker提交反馈。

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