搜索设备

您可以使用 Directory API 的 mobiledevices.list 方法搜索与特定属性匹配的设备。此方法接受 query 参数，该参数是一个搜索查询，用于组合一个或多个搜索子句。每个搜索子句由三部分组成：

字段

要搜索的设备属性。例如 serial。

运算符

对数据执行的测试，以提供匹配项。例如，: 运算符用于测试文本属性是否与某个值匹配。

值

要测试的属性的内容。例如 serialNumber。

多个子句之间用空格分隔，并由 AND 运算符隐式连接。

注意 ：大多数设备数据会在 1 小时内更新，但新数据最长可能需要 36 小时才会反映在所有搜索结果中。

示例

所有查询均使用 mobiledevices.list 方法，该方法的 HTTP 请求类似于以下内容（添加了换行符以提高可读性）：

GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile
?query=query parameters

query 参数必须进行网址编码。例如，查询 query=brand:goo* 的网址编码为 query=brand%3goo*。本页面上的所有示例均显示未编码的 query 参数。客户端库会自动处理此网址编码。

搜索与序列号前缀匹配的设备

serial:525*

搜索电子邮件地址以 fred 开头的设备

email:fred* email:contact*

注意 ：如需查看移动设备字段的完整列表，请参阅个人设备搜索字段。