Stay organized with collections
Save and categorize content based on your preferences.
You can search for devices matching certain attributes with the
mobiledevices.list
method of the Directory API. This method accepts the query parameter which is
a search query combining one or more search clauses. Each search clause is made
up of three parts:
Field
Device attribute that is searched. For example, serial.
Operator
Test that is performed on the data to provide a match. For example, the :
operator tests if a text attribute matches a value.
Value
The content of the attribute that is tested. For example, serialNumber.
Multiple clauses are separated by whitespace and are implicitly joined by an
AND operator.
Examples
All queries use the mobiledevices.list
method, which has an HTTP request similar to the following (line breaks included for readability):
GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile
?query=query parameters
The query parameters must be URL encoded. For example, the query
query=brand:goo* is URL encoded as query=brand%3goo*.
All examples on this page show unencoded query parameters.
Client libraries handle this URL encoding automatically.
Search for devices matching an serial number prefix
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-12-19 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."]]],[]]
