如需了解此资源的方法列表,请参阅本页结尾部分。
资源表示形式
设备资源表示由 EMM 管理且属于特定企业用户的移动设备。
{ "kind": "androidenterprise#device", "androidId": string, "managementType": string, "policy": { "autoUpdatePolicy": string, "productAvailabilityPolicy": string, "productPolicy": [ { "productId": string, "tracks": [ string ], "trackIds": [ string ], "managedConfiguration": { "kind": string, "productId": string, "managedProperty": [ { "key": string, "valueBool": boolean, "valueInteger": integer, "valueString": string, "valueStringArray": [ string ], "valueBundle": { "managedProperty": [ (ManagedProperty) ] }, "valueBundleArray": [ { "managedProperty": [ (ManagedProperty) ] } ] } ], "configurationVariables": { "kind": "androidenterprise#configurationVariables", "mcmId": string, "variableSet": [ { "kind": "androidenterprise#variableSet", "placeholder": string, "userValue": string } ] } }, "autoInstallPolicy": { "autoInstallMode": string, "autoInstallPriority": integer, "autoInstallConstraint": [ { "networkTypeConstraint": string, "chargingStateConstraint": string, "deviceIdleStateConstraint": string } ], "minimumVersionCode": integer }, "autoUpdateMode": string, "enterpriseAuthenticationAppLinkConfigs": [ { "uri": string } ] } ], "maintenanceWindow": { "startTimeAfterMidnightMs": long, "durationMs": long }, "deviceReportPolicy": string }, "report": { "lastUpdatedTimestampMillis": long, "appState": [ { "packageName": string, "keyedAppState": [ { "key": string, "stateTimestampMillis": long, "severity": string, "message": string, "data": string } ] } ] }, "latestBuildFingerprint": string, "sdkVersion": integer, "maker": string, "model": string, "device": string, "product": string, "retailBrand": string }
属性名称 | 值 | 说明 | 备注 |
---|---|---|---|
androidId |
string |
设备的 Google Play 服务 Android ID,以小写十六进制字符串编码。例如 "123456789abcdef0" 。 |
|
device |
string |
设备的内部硬件代号。这条消息来自 android.os.Build.DEVICE 。(每个 Logs/wireless/android/android_checkin.proto 名为“device”的字段) |
|
kind |
string |
||
latestBuildFingerprint |
string |
设备的 build 指纹(如果已知)。 | |
maker |
string |
设备的制造商。这条消息来自 android.os.Build.MANUFACTURER 。 |
|
managementType |
string |
确定在各种部署配置下设备在多大程度上受 Google Play 企业版 EMM 的控制。 可采用的值包括:
可接受的值:
|
|
model |
string |
设备的型号名称。这条消息来自 android.os.Build.MODEL 。 |
|
policy |
nested object |
在设备上强制执行的政策。 | |
policy.autoUpdatePolicy |
string |
控制何时可以应用设备上的应用自动更新。 推荐的替代方案:按应用设置 autoUpdateMode ,在更新频率方面具有更大的灵活性。如果将 autoUpdateMode 设置为 AUTO_UPDATE_POSTPONED 或 AUTO_UPDATE_HIGH_PRIORITY ,autoUpdatePolicy 将不会产生任何影响。“choiceToTheUser”允许设备用户配置应用更新政策。“always”可启用自动更新。“never”将停用自动更新。“wifiOnly”仅会在设备连接到 WLAN 时启用自动更新。 可接受的值为:
|
|
policy.deviceReportPolicy |
string |
指定设备是否向 EMM 报告应用状态。默认值为“deviceReportDisabled”。
可接受的值:
|
|
policy.maintenanceWindow |
nested object |
维护窗口用于定义何时在前台运行的应用应更新。 | |
policy.maintenanceWindow.durationMs |
long |
维护窗口的时长(以毫秒为单位)。该时长必须介于 30 分钟到 24 小时(含 30 分钟)之间。 | |
policy.maintenanceWindow.startTimeAfterMidnightMs |
long |
设备维护期的开始时间(以毫秒为单位)。窗户可以跨越午夜。 | |
policy.productAvailabilityPolicy |
string |
针对指定产品授予设备的库存状况。“all”会授予设备对所有产品的访问权限,无论审批状态如何。选择“all”不会为“alpha”或“beta”轨道启用自动显示功能。“白名单”可向设备授予访问 productPolicy[] 中指定的产品的权限。只有获得批准的产品或之前已被企业批准的产品(即已被撤消审批的产品)才能列入白名单。如果未提供任何值,则默认应用在用户级设置的可用性。 可接受的值:
|
|
policy.productPolicy[] |
list |
产品政策列表。productAvailabilityPolicy 需要设置为 WHITELIST 或 ALL 才能应用产品政策。 |
|
policy.productPolicy[].autoInstallPolicy |
nested object |
产品的自动安装政策。 | |
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[] |
list |
自动安装应用的限制条件。您最多可以指定一个限制条件。 |
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint |
string |
充电状态限制。
可接受的值:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint |
string |
设备空闲状态限制。
可接受的值:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint |
string |
网络类型限制条件。
可接受的值:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallMode |
string |
自动安装模式。如果未设置,则默认为“doNotAutoInstall”。无论设置维护期如何,应用都会自动安装应用。 可接受的值:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallPriority |
integer |
安装优先级(以无符号整数表示)。数字越小,优先级越高。 | |
policy.productPolicy[].autoInstallPolicy.minimumVersionCode |
integer |
应用的最低版本。如果用户安装的是较低版本的应用,该应用将根据自动安装限制自动更新,而不是等待常规自动更新。您可以为每台设备最多 20 个应用设置最低版本代码。 | |
policy.productPolicy[].autoUpdateMode |
string |
产品的自动更新模式。使用 autoUpdateMode 时,它始终优先于用户的选择。因此,当用户手动更改设备设置时,系统会忽略这些更改。
可接受的值为:
|
|
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[] |
list |
身份提供方的身份验证器应用的身份验证网址配置。在使用 Android WebView 的专用应用中进行身份验证期间,这有助于启动身份提供方的身份验证器应用。身份验证器应用应该已经是设备上的身份验证网址的 默认处理程序。 | |
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri |
string |
身份验证网址。 | |
policy.productPolicy[].managedConfiguration |
nested object |
产品的托管配置。 | |
policy.productPolicy[].managedConfiguration.configurationVariables |
nested object |
包含托管配置文件的 ID 以及为用户指定的一组配置变量(如果有)。 | |
policy.productPolicy[].managedConfiguration.configurationVariables.kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.mcmId |
string |
托管配置设置的 ID。 | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[] |
list |
归因于用户的变量集。 | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder |
string |
由 EMM 定义的占位符字符串。 | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue |
string |
特定于用户的占位符值。 | |
policy.productPolicy[].managedConfiguration.kind |
string |
已弃用。 |
|
policy.productPolicy[].managedConfiguration.managedProperty[] |
list |
此配置的一组代管式属性。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].key |
string |
标识属性的唯一键。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBool |
boolean |
布尔值 - 仅当属性类型为布尔值时,此值才会显示。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle |
nested object |
受管理的房源包 - 此属性仅在房源类型为 bundle 时才会显示。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] |
list |
受管理资源的列表。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] |
list |
属性捆绑包列表 - 仅当属性类型为 bundle_array 时,此字段才会显示。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[] |
list |
受管理资源的列表。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger |
integer |
整数值 - 仅当属性类型为整数时,此值才会显示。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueString |
string |
字符串值 - 仅当属性类型为字符串、可选或隐藏时才会出现。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[] |
list |
字符串值列表 - 仅当属性类型为多选时才会出现。 | |
policy.productPolicy[].managedConfiguration.productId |
string |
托管配置所适用的产品的 ID,例如“app:com.google.android.gm”。 | |
policy.productPolicy[].productId |
string |
商品的 ID。例如 "app:com.google.android.gm" 。 |
|
policy.productPolicy[].trackIds[] |
list |
向由 trackIds 标识的指定产品发布轨道授予设备公开范围。可通过调用 Products.Get 获取产品的发布轨道列表。 |
|
policy.productPolicy[].tracks[] |
list |
已弃用。请改用 trackIds 。 |
|
product |
string |
设备的产品名称。这条消息来自 android.os.Build.PRODUCT 。 |
|
report |
nested object |
设备报告已更新为采用最新的应用状态。 | |
report.appState[] |
list |
由设备上的受管理应用设置的应用状态列表。应用状态由应用的开发者定义。此字段将始终显示。 | |
report.appState[].keyedAppState[] |
list |
键控应用状态的列表。此字段将始终显示。 | |
report.appState[].keyedAppState[].data |
string |
用于计算机可读数据的额外字段。例如,数字或 JSON 对象。为防止出现 XSS,我们建议先从数据中移除所有 HTML,然后再显示数据。 | |
report.appState[].keyedAppState[].key |
string |
指示应用为其提供状态的键。密钥的内容由应用开发者设置。为防止出现 XSS,我们建议先移除该密钥中的所有 HTML,然后再显示该密钥。此字段将始终显示。 | |
report.appState[].keyedAppState[].message |
string |
用于描述应用状态的自由格式、人类可读的消息。例如,错误消息。为防止出现 XSS,我们建议在显示消息前删除其中的所有 HTML。 | |
report.appState[].keyedAppState[].severity |
string |
应用状态的严重性。此字段将始终显示。
可接受的值:
|
|
report.appState[].keyedAppState[].stateTimestampMillis |
long |
应用设置状态时的时间戳(以自纪元以来的毫秒数表示)。此字段将始终显示。 | |
report.appState[].packageName |
string |
应用的软件包名称。此字段将始终存在。 | |
report.lastUpdatedTimestampMillis |
long |
上次报告更新的时间戳(以自纪元以来的毫秒数表示)。此字段将始终显示。 | |
retailBrand |
string |
设备的零售品牌(如果已设置)。请参阅 android.os.Build.BRAND 。 |
|
sdkVersion |
integer |
API 兼容性版本。 |
方法
- forceReportUpload
- 上传一个报告,其中包含自上次生成报告以来设备上的应用状态发生的任何变化。对于给定设备,您每 24 小时最多可调用此方法 3 次。
- get
- 检索设备的详细信息。
- getState
- 检索设备对 Google 服务的访问权限是处于启用还是停用状态。只有在 Google 管理控制台中启用了在 Android 设备上强制执行 EMM 政策的情况下,设备状态才会生效。否则,系统会忽略设备状态,允许所有设备访问 Google 服务。 只有由 Google 管理的用户支持此功能。
- list
- 检索用户所有设备的 ID。
- setState
- 设置是启用还是禁止设备访问 Google 服务。 只有在 Google 管理控制台中启用了在 Android 设备上强制执行 EMM 政策的情况下,设备状态才会生效。否则,系统会忽略设备状态,允许所有设备访问 Google 服务。 只有由 Google 管理的用户支持此功能。
- update
- 更新设备政策。
为确保正确强制执行此政策,您需要在 Google Play 软件包的受管理配置中设置allowed_accounts
,以防止非受管帐号访问 Google Play。请参阅限制 Google Play 中的帐号。