Puoi cercare i dispositivi corrispondenti a determinati attributi con il metodo
mobiledevices.list
dell'API Directory. Questo metodo accetta il parametro query, che è una query di ricerca che combina una o più clausole di ricerca. Ogni clausola di ricerca è composta da tre parti:
Campo
Attributo del dispositivo per cui viene eseguita la ricerca. Ad esempio, serial.
Operatore
Test eseguito sui dati per trovare una corrispondenza. Ad esempio, l'operatore :
verifica se un attributo di testo corrisponde a un valore.
Valore
I contenuti dell'attributo sottoposto a test. Ad esempio, serialNumber.
Più clausole sono separate da spazi e sono unite implicitamente da un operatoreAND.
Esempi
Tutte le query utilizzano il metodo mobiledevices.list, che ha una richiesta HTTP simile alla seguente (interruzioni di riga incluse per la leggibilità):
GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile
?query=query parameters
I parametri query devono essere codificati nell'URL. Ad esempio, la queryquery=brand:goo* è codificata in URL come query=brand%3goo*.
Tutti gli esempi in questa pagina mostrano parametri query non codificati.
Le librerie client gestiscono automaticamente questa codifica URL.
Cercare i dispositivi corrispondenti a un prefisso del numero di serie
serial:525*
Cerca i dispositivi con indirizzo email che inizia con fred
[null,null,["Ultimo aggiornamento 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"]]