GetTeamAvailability¶
在受限的 UTC 时间窗口内，检查你和当前团队成员的個人忙碌时间。即使 userIds 选择了特定成员，也始终包含你本人。省略 userIds 可查询整个团队，或使用 ListTeamMembers 中的 ID 来指定特定人员。空列表仅检查你本人。返回合并后的忙碌时间区间，不包含事件标题，同时提供覆盖范围和未知原因。已订阅同事的事件不会占用某个人的时间，除非他们出席或包含在该日历中。仅当每个被请求人员的数据完整且最新时，common freeWindows 才会出现。当 freeWindows 缺失时，应报告不确定性，绝不要根据缺失的忙碌块推断空闲时间。空闲窗口仅覆盖请求的时间范围；不应用工作时间。建议以天或周为单位；最大时间跨度为 370 天，且限定在过去一年到未来两年的范围内。此工具不授予 Google Calendar 访问权限，也不会邀请、RSVP 或修改事件。
参数¶
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
start |
string | 是 | 包含起始时间，RFC 3339 UTC（例如 2026-10-07T09:00:00Z）。 |
end |
string | 是 | 不包含结束时间，RFC 3339 UTC。必须晚于 start。 |
userIds |
string[] | 否 | 最多 100 个来自 ListTeamMembers 的 Macro 用户 ID。省略以查询整个团队；空列表仅检查你本人。未知 ID 永远不会扩大访问权限，并会隐藏 common freeWindows。 |
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 macro3/macro