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 資源的類型。對於 Mobiledevices 資源,這個值為 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 更新了清單,其中包含五個應用程式,則現在是五個應用程式的更新清單。

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

擷取帳戶中所有使用者擁有的行動裝置,並以分頁方式列出清單。