É 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
[null,null,["Última atualização 2025-01-27 UTC."],[[["The `mobiledevices.list` method allows you to search for devices with specific attributes using a `query` parameter."],["A search query is built with clauses consisting of a field, operator, and value, separated by whitespace and implicitly joined by `AND`."],["Queries can use wildcards like `*` for partial matches and multiple clauses can be combined for more refined searches."],["It's important to note that data updates can take up to 36 hours to be reflected in search results."],["Refer to the \"Personal device search fields\" documentation for a complete list of searchable device attributes."]]],["The `mobiledevices.list` method in the Directory API allows searching for devices using the `query` parameter. A query consists of clauses: a Field (attribute), an Operator (test), and a Value (content). Clauses are implicitly joined by `AND`. For example, `serial:525*` searches for serial numbers starting with \"525\". Multiple fields can be used in a single query, such as `email:fred* email:contact*`. Queries are URL encoded, and client libraries manage this automatically. Data updates can take up to 36 hours to reflect in search results.\n"]]
