É possível pesquisar dispositivos que correspondem a determinados atributos com o método
mobiledevices.list
da API Directory. Esse método aceita o parâmetro query, que é
uma consulta de pesquisa que combina uma ou mais cláusulas de pesquisa. Cada cláusula de pesquisa é composta
por três partes:
- Campo
- Atributo do dispositivo que é pesquisado. Por exemplo,
serial. - Operador
- Teste que é realizado nos dados para fornecer uma correspondência. Por exemplo, o operador
:testa se um atributo de texto corresponde a um valor. - Valor
- O conteúdo do atributo testado. Por exemplo,
serialNumber.
Várias cláusulas são separadas por espaços em branco e são agrupadas implicitamente por um operador AND.
Exemplos
Todas as consultas usam o método mobiledevices.list, que tem uma solicitação HTTP semelhante a esta (quebras de linha incluídas para facilitar a leitura):
GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile
?query=query parameters
Os parâmetros query precisam ser codificados para uso em URLs. Por exemplo, a consulta
query=brand:goo* é codificada como URL como query=brand%3goo*.
Todos os exemplos nesta página mostram parâmetros query não codificados.
As bibliotecas de cliente processam essa codificação de URL automaticamente.
Pesquisar dispositivos que correspondem a um prefixo de número de série
serial:525*
Pesquisar dispositivos com e-mail que começa com fred
email:fred* email:contact*