您可以使用 Directory API 的 mobiledevices.list
方法搜尋符合特定屬性的裝置。這個方法接受 query
參數,這是結合一或多個搜尋子句的搜尋查詢。每個搜尋子句都由三個部分組成:
- 欄位
- 搜尋的裝置屬性。例如
serial
。 - 業者
- 對資料執行測試以提供匹配。舉例來說,
:
運算子會測試文字屬性是否「與」值相符。 - 值
- 受測試的屬性內容。例如
serialNumber
。
多個子句以空格字元分隔,並以 AND
運算子隱含。
示例
所有查詢都使用 mobiledevices.list
方法,其中的 HTTP 要求類似於以下內容 (為了方便閱讀,納入換行符號):
GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile
?query=query parameters
query
參數必須經過網址編碼。舉例來說,查詢 query=brand:goo*
的網址編碼為 query=brand%3goo*
。本頁中的所有範例都會顯示未經編碼的 query
參數。用戶端程式庫會自動處理這個網址編碼。
搜尋與序號前置字串相符的裝置
serial:525*
搜尋開頭為 fred 的裝置裝置
email:fred* email:contact*