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 資訊清單中。日曆應用程式的權限範例為 READ_CALENDARMANAGE_ACCOUNTS

方法

action

對行動裝置造成影響。

delete

移除行動裝置。

get

擷取行動裝置的屬性。

list

擷取帳戶所有擁有的使用者行動裝置分頁清單。