您可以使用 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*