如何通过Google Workspace Directory API获取Linux/macOS/Windows设备列表？

核心结论 #

Google Workspace Directory API不支持直接获取Linux、macOS或Windows桌面设备的资产列表——该API的设备管理范畴仅覆盖ChromeOS设备和移动设备（iOS/Android），这也是官方文档仅提供mobiledevices.list和chromeosdevices.list接口的原因，你尝试的搜索参数无法生效也源于此。

可行替代方案 #

• Google Endpoint Verification：这是Google官方针对企业桌面设备（macOS/Windows/Linux）的管理服务，启用后可通过其对应API获取设备列表。需先在Google Admin控制台开启Endpoint Verification，调用API时可通过osType参数过滤区分不同操作系统的设备。
• 第三方MDM工具API：如果你的企业使用Jamf（macOS）、Microsoft Intune（Windows）或其他桌面MDM工具，可直接调用这些工具的API获取设备资产数据，再与Google Workspace的用户目录做关联，实现统一的资产视图。
• 自定义资产收集脚本：在目标桌面设备上部署轻量脚本，定期上报设备信息（系统版本、设备ID、关联用户等）到Google Sheets或Cloud Storage，再通过Google Workspace的Sheets API或Cloud Storage API读取汇总数据，适合没有启用官方MDM的场景。
• Google Cloud Asset Inventory：若这些桌面设备是绑定到Google Cloud身份的资源（如GCP托管的虚拟机），可通过该服务的API查询设备资产，支持按操作系统类型筛选。

内容的提问来源于stack exchange，提问作者Madhana S.K