Puedes buscar dispositivos que coincidan con ciertos atributos con el método mobiledevices.list de la API de Directory. Este método acepta el parámetro query, que es una búsqueda que combina una o más cláusulas de búsqueda. Cada cláusula de búsqueda consta de tres partes:
Campo
Es el atributo del dispositivo que se busca. Por ejemplo, serial
Operador
Prueba que se realiza en los datos para proporcionar una coincidencia. Por ejemplo, el operador :
verifica si un atributo de texto coincide con un valor.
Valor
Es el contenido del atributo que se prueba. Por ejemplo, serialNumber
Varias cláusulas se separan por espacios en blanco y se unen de forma implícita con un operador AND.
Ejemplos
Todas las consultas usan el método mobiledevices.list, que tiene una solicitud HTTP similar a la siguiente (se incluyen saltos de línea para facilitar la lectura):
GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile
?query=query parameters
Los parámetros query deben estar codificados como URL. Por ejemplo, la consulta query=brand:goo* se codifica como URL como query=brand%3goo*.
En todos los ejemplos de esta página, se muestran parámetros query sin codificar.
Las bibliotecas cliente controlan esta codificación de URL automáticamente.
Busca dispositivos que coincidan con un prefijo de número de serie
serial:525*
Busca dispositivos con un correo electrónico que comience con fred
[null,null,["Última actualización: 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"]]
