Method: mobiledevices.list

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

擷取帳戶所有擁有的使用者行動裝置分頁清單。如要擷取包含公司擁有裝置的清單,請改用 Cloud Identity Devices API。這種方法會在 60 分鐘後逾時。詳情請參閱排解錯誤代碼相關問題

HTTP 要求

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customerId

string

客戶 Google Workspace 帳戶的專屬 ID。身為帳戶管理員,您也可以使用 my_customer 別名來代表帳戶的 customerIdcustomerId 也會在使用者資源中傳回。

查詢參數

參數
maxResults

integer

要傳回的結果數量上限。允許的值為 100。

orderBy

enum (OrderBy)

用來排序結果的裝置屬性。

pageToken

string

用於指定清單中下一頁的權杖

projection

enum (Projection)

限制傳回一組所選欄位的資訊。

query

string

搜尋字串,格式為 https://developers.google.com/admin-sdk/directory/v1/search-operators

sortOrder

enum (SortOrder)

要以遞增或遞減順序傳回結果。必須搭配 orderBy 參數使用。

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體即會包含具有以下結構的資料:

JSON 表示法
{
  "kind": string,
  "etag": string,
  "mobiledevices": [
    {
      object (MobileDevice)
    }
  ],
  "nextPageToken": string
}
欄位
kind

string

這是資源類型。

etag

string

資源的 ETag。

mobiledevices[]

object (MobileDevice)

行動裝置物件清單。

nextPageToken

string

存取這個結果下一頁的符記。

授權範圍

需要下列其中一種 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 遞減順序。