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 资源的类型。对于移动设备资源,值为 admin#directory#mobiledevice

etag

string

资源的 ETag。

resourceId

string

API 服务用于标识移动设备的唯一 ID。

deviceId

string

Google Sync 移动设备的序列号。对于 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 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 清单中找到。日历应用的权限示例包括 READ_CALENDARMANAGE_ACCOUNTS

方法

action

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

delete

移除移动设备。

get

检索移动设备的属性。

list

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