擷取帳戶所有擁有的使用者行動裝置分頁清單。如要擷取包含公司擁有裝置的清單,請改用 Cloud Identity Devices API。這種方法會在 60 分鐘後逾時。詳情請參閱排解錯誤代碼相關問題。
HTTP 要求
GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
customerId |
客戶 Google Workspace 帳戶的專屬 ID。身為帳戶管理員,您也可以使用 |
查詢參數
參數 | |
---|---|
maxResults |
要傳回的結果數量上限。允許的值為 100。 |
orderBy |
用來排序結果的裝置屬性。 |
pageToken |
用於指定清單中下一頁的權杖 |
projection |
限制傳回一組所選欄位的資訊。 |
query |
搜尋字串,格式為 https://developers.google.com/admin-sdk/directory/v1/search-operators |
sortOrder |
要以遞增或遞減順序傳回結果。必須搭配 |
要求主體
要求主體必須為空白。
回應主體
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"kind": string,
"etag": string,
"mobiledevices": [
{
object ( |
欄位 | |
---|---|
kind |
這是資源類型。 |
etag |
資源的 ETag。 |
mobiledevices[] |
行動裝置物件清單。 |
nextPageToken |
存取這個結果下一頁的符記。 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/admin.directory.device.mobile
https://www.googleapis.com/auth/admin.directory.device.mobile.action
https://www.googleapis.com/auth/admin.directory.device.mobile.readonly
詳情請參閱 OAuth 2.0 總覽。
OrderBy
列舉 | |
---|---|
DEVICE_ID |
Google Sync 行動裝置的序號。如果是 Android 裝置,這是軟體產生的專屬 ID。 |
EMAIL |
裝置擁有者的電子郵件地址。 |
LAST_SYNC |
裝置的上次政策設定同步處理時間。 |
MODEL |
行動裝置的型號。 |
NAME |
裝置擁有者的使用者名稱。 |
OS |
裝置的作業系統 |
STATUS |
裝置狀態。 |
TYPE |
裝置的類型。 |
Projection
列舉 | |
---|---|
BASIC |
只包含基本中繼資料欄位 (例如 deviceId、model、status、type 和 status) |
FULL |
包含所有中繼資料欄位 |
SortOrder
列舉 | |
---|---|
ASCENDING |
遞增排序。 |
DESCENDING |
遞減順序。 |