- JSON 表示法
- UsageLogEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- KeyguardDismissedEvent
- KeyguardDismissAuthAttemptEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- KeyguardSecuredEvent
- FilePulledEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- FilePushedEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CertAuthorityInstalledEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CertAuthorityRemovedEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CertValidationFailureEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CryptoSelfTestCompletedEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- KeyDestructionEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- KeyGeneratedEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- KeyImportEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- KeyIntegrityViolationEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LoggingStartedEvent
- LoggingStoppedEvent
- LogBufferSizeCriticalEvent
- MediaMountEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- MediaUnmountEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- OsShutdownEvent
- OsStartupEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- RemoteLockEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- WipeFailureEvent
- ConnectEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- DnsEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- StopLostModeUserAttemptEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LostModeOutgoingPhoneCallEvent
- LostModeLocationEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 位置
- EnrollmentCompleteEvent
来自设备的 events
批量事件日志。
JSON 表示法 |
---|
{
"device": string,
"user": string,
"retrievalTime": string,
"usageLogEvents": [
{
object ( |
字段 | |
---|---|
device |
设备名称,格式为“enterprises/{enterpriseId}/devices/{deviceId}”(如果存在) |
user |
拥有此设备的用户的资源名称(如果存在),格式为“enterprises/{enterpriseId}/users/{userId}”。 |
retrievalTime |
从设备收集批量事件时的设备时间戳。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: |
usageLogEvents[] |
设备报告的 UsageLogEvent 列表,按事件时间按时间顺序排序。 |
UsageLogEvent
设备上记录的事件。
JSON 表示法 |
---|
{ "eventId": string, "eventTime": string, "eventType": enum ( |
字段 | |
---|---|
eventId |
事件的唯一 ID。 |
eventTime |
记录事件时的设备时间戳。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: |
eventType |
设备上报告的特定使用情况日志事件类型。使用此方法确定要访问的 |
联合字段 event 。设备上记录的事件类型。请参阅每种事件类型,详细了解何时发送事件、对何时记录事件以及包含哪些字段的限制。event 只能是下列其中一项: |
|
adbShellCommandEvent |
系统通过“adb shell 命令”在 ADB 上发出了 shell 命令。“ |
adbShellInteractiveEvent |
通过“adb shell”打开了一个 ADB 交互式 shell。“ |
appProcessStartEvent |
启动了应用进程。“ |
keyguardDismissedEvent |
键盘锁已关闭。“ |
keyguardDismissAuthAttemptEvent |
有人尝试解锁设备。“ |
keyguardSecuredEvent |
设备被用户锁定或超时。“ |
filePulledEvent |
从设备下载了一个文件。“ |
filePushedEvent |
一个文件上传到了设备。“ |
certAuthorityInstalledEvent |
新的根证书已安装到系统的可信凭据存储空间中。“ |
certAuthorityRemovedEvent |
一个根证书已从系统的可信凭据存储空间中移除。“ |
certValidationFailureEvent |
X.509v3 证书验证失败,目前在 Wi-Fi 接入点上执行此验证,验证失败可能是服务器证书验证不匹配所致。不过,它将来可能会包含 X.509v3 证书的其他验证事件。“ |
cryptoSelfTestCompletedEvent |
验证 Android 的内置加密库 (BoringSSL) 是否有效。应该会在设备启动时始终成功;如果启动失败,则相应设备应被视为不可信设备。“ |
keyDestructionEvent |
由用户或管理者从设备中移除某个加密密钥(包括用户安装的、由管理员安装的和由系统维护的私钥)。“ |
keyGeneratedEvent |
由用户或管理者在设备上安装的加密密钥包括由用户安装的、由管理员安装的和由系统维护的私钥。“ |
keyImportEvent |
由用户或管理者将加密密钥(包括用户安装的私钥、管理员安装的私钥和系统维护的私钥)导入设备。“ |
keyIntegrityViolationEvent |
我们发现某个加密密钥(包括用户安装的、由管理员安装的和由系统维护的私钥)遭到了损坏,原因是存储设备损坏、硬件故障或某些操作系统问题。“ |
loggingStartedEvent |
已启用“ |
loggingStoppedEvent |
|
logBufferSizeCriticalEvent |
审核日志缓冲区已达到其容量的 90%,因此较早的事件可能会被舍弃。“ |
mediaMountEvent |
已装载可移动介质。“ |
mediaUnmountEvent |
已卸载可移动介质。“ |
osShutdownEvent |
设备已关机。“ |
osStartupEvent |
设备已启动。“ |
remoteLockEvent |
已通过 |
wipeFailureEvent |
未能按照要求擦除工作资料或公司自有设备。可能由用户启动或由管理员启动,例如已收到 |
connectEvent |
TCP 连接事件通过标准网络堆栈发起。“ |
dnsEvent |
DNS 查找事件通过标准网络堆栈启动。“ |
stopLostModeUserAttemptEvent |
尝试使设备退出丢失模式。 |
lostModeOutgoingPhoneCallEvent |
设备处于丢失模式时去电。 |
lostModeLocationEvent |
设备处于丢失模式时,系统会更新丢失模式的位置信息。 |
enrollmentCompleteEvent |
设备已完成注册。“ |
KeyguardDismissedEvent
此类型没有字段。
键盘锁已关闭。特意为空。
KeyguardDismissAuthAttemptEvent
有人尝试解锁设备。
JSON 表示法 |
---|
{ "success": boolean, "strongAuthMethodUsed": boolean } |
字段 | |
---|---|
success |
解锁尝试是否成功。 |
strongAuthMethodUsed |
是否使用了安全系数高的身份验证方式(密码、PIN 码或图案)来解锁设备。 |
KeyguardSecuredEvent
此类型没有字段。
设备被用户锁定或超时。特意为空。
FilePulledEvent
从设备下载了一个文件。
JSON 表示法 |
---|
{ "filePath": string } |
字段 | |
---|---|
filePath |
要提取的文件的路径。 |
FilePushedEvent
一个文件上传到了设备。
JSON 表示法 |
---|
{ "filePath": string } |
字段 | |
---|---|
filePath |
要推送的文件的路径。 |
CertAuthorityInstalledEvent
新的根证书已安装到系统的可信凭据存储空间中。在完全受管设备上,您可以在整个设备范围内使用;在组织拥有的装有工作资料的单位自有设备上的工作资料中,可以使用此 API。
JSON 表示法 |
---|
{ "certificate": string, "userId": integer, "success": boolean } |
字段 | |
---|---|
certificate |
证书的主题。 |
userId |
发生了证书安装事件的用户。仅适用于搭载 Android 11 及更高版本的设备。 |
success |
安装事件是否成功。 |
CertAuthorityRemovedEvent
一个根证书已从系统的可信凭据存储空间中移除。在完全受管设备上,您可以在整个设备范围内使用;在组织自有且装有工作资料的设备上的工作资料中,可以使用此 API。
JSON 表示法 |
---|
{ "certificate": string, "userId": integer, "success": boolean } |
字段 | |
---|---|
certificate |
证书的主题。 |
userId |
发生了证书移除事件的用户。仅适用于搭载 Android 11 及更高版本的设备。 |
success |
移除是否成功。 |
CertValidationFailureEvent
X.509v3 证书验证失败,目前在 Wi-Fi 接入点上执行此验证,验证失败可能是服务器证书验证不匹配所致。不过,它将来可能会包含 X.509v3 证书的其他验证事件。
JSON 表示法 |
---|
{ "failureReason": string } |
字段 | |
---|---|
failureReason |
认证验证失败的原因。 |
CryptoSelfTestCompletedEvent
验证 Android 的内置加密库 (BoringSSL) 是否有效。应该会在设备启动时始终成功;如果启动失败,则相应设备应被视为不可信设备。
JSON 表示法 |
---|
{ "success": boolean } |
字段 | |
---|---|
success |
测试是否成功。 |
KeyDestructionEvent
加密密钥(包括用户安装的、由管理员安装的和系统维护的私钥)已被用户或管理者从设备中移除。在完全受管设备上,您可以在整个设备范围内使用;在组织拥有的装有工作资料的单位自有设备上的工作资料中,可以使用此 API。
JSON 表示法 |
---|
{ "keyAlias": string, "applicationUid": integer, "success": boolean } |
字段 | |
---|---|
keyAlias |
密钥的别名。 |
applicationUid |
拥有密钥的应用的 UID。 |
success |
操作是否成功。 |
KeyGeneratedEvent
加密密钥(包括用户安装的、由管理员安装的和由系统维护的私钥)已由用户或管理者在设备上安装。在完全受管设备上均可使用,在单位拥有且装有工作资料的单位设备上的工作资料中。
JSON 表示法 |
---|
{ "keyAlias": string, "applicationUid": integer, "success": boolean } |
字段 | |
---|---|
keyAlias |
密钥的别名。 |
applicationUid |
生成密钥的应用的 UID。 |
success |
操作是否成功。 |
KeyImportEvent
由用户或管理者将加密密钥(包括用户安装的私钥、管理员安装的私钥和系统维护的私钥)导入设备上。在完全受管设备上,您可以在整个设备范围内使用;在组织拥有的装有工作资料的单位自有设备上的工作资料中,可以使用此 API。
JSON 表示法 |
---|
{ "keyAlias": string, "applicationUid": integer, "success": boolean } |
字段 | |
---|---|
keyAlias |
密钥的别名。 |
applicationUid |
导入密钥的应用的 UID |
success |
操作是否成功。 |
KeyIntegrityViolationEvent
我们发现某个加密密钥(包括用户安装的、由管理员安装的和由系统维护的私钥)遭到了损坏,原因是存储设备损坏、硬件故障或某些操作系统问题。在完全受管设备上,您可以在整个设备范围内使用;在组织自有且装有工作资料的设备上的工作资料中,可以使用此 API。
JSON 表示法 |
---|
{ "keyAlias": string, "applicationUid": integer } |
字段 | |
---|---|
keyAlias |
密钥的别名。 |
applicationUid |
拥有密钥的应用的 UID |
LoggingStartedEvent
此类型没有字段。
已启用“
”政策。特意为空。usageLog
LoggingStoppedEvent
此类型没有字段。
政策已停用。特意为空。usageLog
LogBufferSizeCriticalEvent
此类型没有字段。
设备上的
缓冲区已达到其容量的 90%,因此较旧的事件可能会被丢弃。特意为空。usageLog
MediaMountEvent
已装载可移动介质。
JSON 表示法 |
---|
{ "mountPoint": string, "volumeLabel": string } |
字段 | |
---|---|
mountPoint |
装载点。 |
volumeLabel |
卷标签。在组织自有的受管理个人资料设备上隐去为空字符串。 |
MediaUnmountEvent
已卸载可移动介质。
JSON 表示法 |
---|
{ "mountPoint": string, "volumeLabel": string } |
字段 | |
---|---|
mountPoint |
装载点。 |
volumeLabel |
卷标签。在组织自有的受管理个人资料设备上隐去为空字符串。 |
OsShutdownEvent
此类型没有字段。
设备已关机。特意为空。
OsStartupEvent
设备已启动。
JSON 表示法 |
---|
{ "verifiedBootState": enum ( |
字段 | |
---|---|
verifiedBootState |
启动时验证状态。 |
verityMode |
dm-verity 模式。 |
RemoteLockEvent
已通过
命令远程锁定设备或个人资料。LOCK
JSON 表示法 |
---|
{ "adminPackageName": string, "adminUserId": integer, "targetUserId": integer } |
字段 | |
---|---|
adminPackageName |
请求更改的管理应用的软件包名称。 |
adminUserId |
提出更改请求的管理应用的用户 ID。 |
targetUserId |
提出更改请求的用户 ID。 |
WipeFailureEvent
此类型没有字段。
未能按照要求擦除工作资料或公司自有设备。可能由用户启动或由管理员启动,例如已收到 delete
。特意为空。
ConnectEvent
TCP 连接事件通过标准网络堆栈发起。
JSON 表示法 |
---|
{ "destinationIpAddress": string, "destinationPort": integer, "packageName": string } |
字段 | |
---|---|
destinationIpAddress |
连接调用的目标 IP 地址。 |
destinationPort |
Connect 调用的目标端口。 |
packageName |
执行连接调用的 UID 的软件包名称。 |
DnsEvent
DNS 查找事件通过标准网络堆栈启动。
JSON 表示法 |
---|
{ "hostname": string, "ipAddresses": [ string ], "totalIpAddressesReturned": string, "packageName": string } |
字段 | |
---|---|
hostname |
查询的主机名。 |
ipAddresses[] |
DNS 查找返回的 IP 地址列表(可能被截断),最多 10 个 IPv4 或 IPv6 地址。 |
totalIpAddressesReturned |
DNS 查找事件返回的 IP 地址数量。如果要记录的地址过多,可能会多于 ipAddresses 数量。 |
packageName |
执行 DNS 查找的 UID 的软件包名称。 |
StopLostModeUserAttemptEvent
丢失模式事件,表示用户尝试停止丢失模式。
JSON 表示法 |
---|
{
"status": enum ( |
字段 | |
---|---|
status |
尝试停止丢失模式的状态。 |
LostModeOutgoingPhoneCallEvent
此类型没有字段。
当设备处于丢失模式时,表示拨打了电话的事件。特意为空。
LostModeLocationEvent
丢失模式事件,包含设备位置和电池电量(以百分比表示)。
JSON 表示法 |
---|
{
"location": {
object ( |
字段 | |
---|---|
location |
设备位置信息 |
batteryLevel |
电池电量,以 0 到 100(含 0 和 100)之间的数字表示 |
位置
包含纬度和经度的设备位置信息。
JSON 表示法 |
---|
{ "latitude": number, "longitude": number } |
字段 | |
---|---|
latitude |
相应位置的纬度位置 |
longitude |
相应位置的经度位置 |
EnrollmentCompleteEvent
此类型没有字段。
表示设备已完成注册。此时,用户应该位于启动器中,此时设备将合规,并且所有设置步骤都已完成。特意为空。