搜索设备

您可以使用 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*

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