Directory API의 mobiledevices.list 메서드를 사용하여 특정 속성과 일치하는 기기를 검색할 수 있습니다. 이 메서드는 하나 이상의 검색 절을 결합한 검색어인 query 매개변수를 허용합니다. 각 검색 조건은 다음 세 부분으로 구성됩니다.
필드
검색되는 기기 속성입니다. 예를 들면 다음과 같습니다. serial
연산자
데이터에 대해 실행되어 일치를 제공하는 테스트입니다. 예를 들어 : 연산자는 텍스트 속성이 값과 일치하는지 테스트합니다.
값
테스트되는 속성의 콘텐츠입니다. 예를 들면 다음과 같습니다. serialNumber
여러 절은 공백으로 구분되며 암시적으로 AND 연산자로 연결됩니다.
예
모든 쿼리는 다음과 유사한 HTTP 요청이 있는 mobiledevices.list 메서드를 사용합니다 (가독성을 위해 줄바꿈 포함).
GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile
?query=query parameters
query 매개변수는 URL로 인코딩되어야 합니다. 예를 들어 쿼리 query=brand:goo*는 query=brand%3goo*로 URL 인코딩됩니다.
이 페이지의 모든 예시에는 인코딩되지 않은 query 매개변수가 표시됩니다.
클라이언트 라이브러리는 이 URL 인코딩을 자동으로 처리합니다.
[null,null,["최종 업데이트: 2025-05-14(UTC)"],[],[],null,["# Search for devices\n\nYou can search for devices matching certain attributes with the\n[`mobiledevices.list`](/workspace/admin/directory/v1/reference/mobiledevices/list)\nmethod of the Directory API. This method accepts the `query` parameter which is\na search query combining one or more search clauses. Each search clause is made\nup of three parts:\n\nField\n: Device attribute that is searched. For example, `serial`.\n\nOperator\n: Test that is performed on the data to provide a match. For example, the `:`\n operator tests if a text attribute *matches* a value.\n\nValue\n: The content of the attribute that is tested. For example, `serialNumber`.\n\nMultiple clauses are separated by whitespace and are implicitly joined by an\n`AND` operator.\n| **Note:** Most device data updates within 1 hour, however, it may take up to 36 hours for new data to be reflected in all search results.\n\nExamples\n--------\n\nAll queries use the [`mobiledevices.list`](/workspace/admin/directory/v1/reference/mobiledevices/list)\nmethod, which has an HTTP request similar to the following (line breaks included for readability): \n\n```\nGET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile\n?query=query parameters\n```\n\nThe `query` parameters must be URL encoded. For example, the query\n`query=brand:goo*` is URL encoded as `query=brand%3goo*`.\nAll examples on this page show unencoded `query` parameters.\nClient libraries handle this URL encoding automatically.\n\nSearch for devices matching an serial number prefix \n\n serial:525*\n\nSearch for devices with email starting with fred \n\n email:fred* email:contact*\n\n| **Note:** For a complete list of mobile device fields, refer to [Personal device search fields](/workspace/admin/directory/v1/search-operators)."]]
