REST Resource: mobiledevices

资源:MobileDevice

Google Workspace 移动设备管理服务适用于 Android、Google 同步和 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 同步移动设备的序列号。对于 Android 和 iOS 设备,这是软件生成的唯一标识符。

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 唯一标识符。不适用于 Google 同步设备。添加 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

设备的操作系统 build 号。

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 同步和 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 清单中。日历应用权限的示例包括 READ_CALENDARMANAGE_ACCOUNTS

方法

action

执行会影响移动设备的操作。

delete

移除移动设备。

get

检索移动设备的属性。

list

检索某个账号的所有用户拥有的移动设备的分页列表。