REST Resource: mobiledevices

資源:MobileDevice

Google Workspace 行動管理服務包括 Android、Google Sync 和 iOS 裝置。如要進一步瞭解常見的群組行動裝置 API 工作,請參閱開發人員指南

JSON 表示法
{
  "kind": string,
  "etag": string,
  "resourceId": string,
  "deviceId": string,
  "name": [
    string
  ],
  "email": [
    string
  ],
  "model": string,
  "os": string,
  "type": string,
  "status": string,
  "hardwareId": string,
  "firstSync": string,
  "lastSync": string,
  "userAgent": string,
  "serialNumber": string,
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperator": string,
  "defaultLanguage": string,
  "managedAccountIsOnOwnerProfile": boolean,
  "deviceCompromisedStatus": string,
  "buildNumber": string,
  "kernelVersion": string,
  "basebandVersion": string,
  "unknownSourcesStatus": boolean,
  "developerOptionsStatus": boolean,
  "otherAccountsInfo": [
    string
  ],
  "adbStatus": boolean,
  "supportsWorkProfile": boolean,
  "manufacturer": string,
  "releaseVersion": string,
  "securityPatchLevel": string,
  "brand": string,
  "bootloaderVersion": string,
  "hardware": string,
  "encryptionStatus": string,
  "devicePasswordStatus": string,
  "privilege": string,
  "applications": [
    {
      "packageName": string,
      "displayName": string,
      "versionName": string,
      "versionCode": integer,
      "permission": [
        string
      ]
    }
  ]
}
欄位
kind

string

API 資源的類型。行動裝置資源的值則為 admin#directory#mobiledevice

etag

string

資源的 ETag。

resourceId

string

API 服務用來識別行動裝置的專屬 ID。

deviceId

string

Google Sync 行動裝置的序號。如果是 Android 和 iOS 裝置,這是軟體產生的專屬 ID。

name[]

string

擁有者的使用者名稱清單。如果應用程式需要目前的裝置擁有者名稱清單,請使用 get 方法。如要進一步瞭解如何擷取行動裝置使用者資訊,請參閱開發人員指南

email[]

string

擁有者的電子郵件地址清單。如果應用程式需要目前的使用者電子郵件清單,請使用 get 方法。詳情請參閱「擷取使用者」方法。

model

string

行動裝置的型號名稱,例如 Nexus S。這個屬性可更新。詳情請參閱開發人員指南

os

string

行動裝置的作業系統,例如 iOS 4.3 或 Android 2.3.5。這個屬性可更新。詳情請參閱開發人員指南

type

string

行動裝置類型。

status

string

裝置狀態。

hardwareId

string

Android 硬體的 IMEI/MEID 專屬 ID。不適用於 Google Sync 裝置。在新增 Android 行動裝置時,這是選用屬性。當更新其中一部裝置時,這是唯讀屬性。

firstSync

string

裝置首次與管理控制台中的政策設定同步處理的日期和時間。這個值採用 ISO 8601 日期和時間格式。時間是 <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em> 表單中的完整日期加上時、分、秒。例如:2010-04-05T17:30:04+01:00

lastSync

string

裝置上次與管理控制台中的政策設定同步處理的日期和時間。這個值採用 ISO 8601 日期和時間格式。時間是 <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em> 表單中的完整日期加上時、分、秒。例如:2010-04-05T17:30:04+01:00

userAgent

string

提供裝置相關資訊,例如 os 版本。這個屬性可更新。詳情請參閱開發人員指南

serialNumber

string

裝置的序號。

imei

string

裝置的 IMEI 號碼。

meid

string

裝置的 MEID 號碼。

wifiMacAddress

string

裝置的 Wi-Fi 網路上的 MAC 位址。

networkOperator

string

行動裝置或網路業者 (如果有的話) (唯讀)

defaultLanguage

string

裝置使用的預設語言代碼。

managedAccountIsOnOwnerProfile

boolean

布林值,指出這個帳戶是否屬於擁有者/主要付款資料。

deviceCompromisedStatus

string

裝置遭駭狀態。

buildNumber

string

裝置的作業系統版本號碼。

kernelVersion

string

裝置的核心版本。

basebandVersion

string

裝置的基頻版本。

unknownSourcesStatus

boolean

裝置上啟用或停用不明來源 (唯讀)

developerOptionsStatus

boolean

裝置上啟用或停用開發人員選項 (唯讀)

otherAccountsInfo[]

string

在裝置上新增的帳戶清單 (唯讀)

adbStatus

boolean

在裝置上啟用或停用 ADB (USB 偵錯) (唯讀)

supportsWorkProfile

boolean

裝置支援工作資料夾 (唯讀)

manufacturer

string

行動裝置製造商 (唯讀)

releaseVersion

string

行動裝置發布版本 (唯讀)

securityPatchLevel

string (int64 format)

行動裝置安全性修補程式等級 (唯讀)

brand

string

行動裝置品牌 (唯讀)

bootloaderVersion

string

行動裝置系統啟動載入程式版本 (唯讀)

hardware

string

行動裝置硬體 (唯讀)

encryptionStatus

string

行動裝置加密狀態 (唯讀)

devicePasswordStatus

string

DevicePasswordStatus (唯讀)

privilege

string

DMAgentPermission (唯讀)

applications[]

object

Android 行動裝置上安裝的應用程式清單。不適用於 Google Sync 和 iOS 裝置。這份清單包含所有可存取 Google Workspace 資料的 Android 應用程式。

請務必留意,更新應用程式清單時會取代現有清單。如果 Android 裝置中有兩個現有的應用程式,而 API 更新清單時,顯示五個應用程式,則目前是 5 個應用程式的清單。

applications[].packageName

string

應用程式的套件名稱。範例:com.android.browser

applications[].displayName

string

應用程式的顯示名稱。範例:Browser

applications[].versionName

string

應用程式的版本名稱。範例:3.2-140714

applications[].versionCode

integer

應用程式的版本代碼。範例:13

applications[].permission[]

string

這個應用程式的權限清單。這可以是標準 Android 權限或應用程式所定義的權限,請參閱應用程式的 Android 資訊清單。Google 日曆應用程式的權限範例包括 READ_CALENDARMANAGE_ACCOUNTS

方法

action

採取會影響行動裝置的操作。

delete

移除行動裝置。

get

擷取行動裝置的屬性。

list

擷取分頁清單,當中列出某個帳戶使用者擁有的所有行動裝置。