Você pode pesquisar dispositivos que correspondam 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
de três partes:
- Campo
- Atributo do dispositivo pesquisado Por exemplo,
serial. - Operador
- Teste 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 implicitamente unidas por um operador AND.
Exemplos
Todas as consultas usam o método mobiledevices.list, que tem uma solicitação HTTP semelhante à seguinte (quebras de linha incluídas para legibilidade):
GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile
?query=query parameters
Os parâmetros query precisam ter codificação de URL. Por exemplo, a consulta
query=brand:goo* é um URL codificado como query=brand%3goo*.
Todos os exemplos nesta página mostram parâmetros query não codificados.
As bibliotecas de cliente lidam com essa codificação de URL automaticamente.
Pesquisar dispositivos que correspondam a um prefixo de número de série
serial:525*
Pesquisar dispositivos com e-mail começando com fred
email:fred* email:contact*