您可以使用 Directory API 的 mobiledevices.list
方法搜索与特定属性匹配的设备。此方法接受 query
参数,该参数是一个搜索查询,其中包含一个或多个搜索子句。每个搜索子句由三部分组成:
- 字段
- 要搜索的设备属性。例如
serial
。 - 运算符
- 对数据执行的测试,以提供匹配项。例如,
:
运算符用于测试文本属性是否与某个值匹配。 - 值
- 要测试的属性的内容。例如
serialNumber
。
多个子句之间用空格分隔,并由 AND
运算符隐式连接。
示例
所有查询均使用 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*