BatchUsageLogEvents

设备中 events 的批量事件日志。

JSON 表示法 
{
  "device": string,
  "user": string,
  "retrievalTime": string,
  "usageLogEvents": [
    {
      object (UsageLogEvent)
    }
  ]
}
字段
device

string

如果存在，则设备名称采用“enterprises/{enterpriseId}/devices/{deviceId}”格式
user

string

如果存在，则表示拥有相应设备的用户的资源名称，格式为“enterprises/{enterpriseId}/users/{userId}”。
retrievalTime

string (Timestamp format)

从设备收集相应批次事件时的设备时间戳。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
usageLogEvents[]

object (UsageLogEvent)

设备报告的 UsageLogEvent 列表，按事件时间按时间顺序排序。

UsageLogEvent

设备上记录的事件。

JSON 表示法 
{
  "eventId": string,
  "eventTime": string,
  "eventType": enum (EventType),

  // Union field event can be only one of the following:
  "adbShellCommandEvent": {
    object (AdbShellCommandEvent)
  },
  "adbShellInteractiveEvent": {
    object (AdbShellInteractiveEvent)
  },
  "appProcessStartEvent": {
    object (AppProcessStartEvent)
  },
  "keyguardDismissedEvent": {
    object (KeyguardDismissedEvent)
  },
  "keyguardDismissAuthAttemptEvent": {
    object (KeyguardDismissAuthAttemptEvent)
  },
  "keyguardSecuredEvent": {
    object (KeyguardSecuredEvent)
  },
  "filePulledEvent": {
    object (FilePulledEvent)
  },
  "filePushedEvent": {
    object (FilePushedEvent)
  },
  "certAuthorityInstalledEvent": {
    object (CertAuthorityInstalledEvent)
  },
  "certAuthorityRemovedEvent": {
    object (CertAuthorityRemovedEvent)
  },
  "certValidationFailureEvent": {
    object (CertValidationFailureEvent)
  },
  "cryptoSelfTestCompletedEvent": {
    object (CryptoSelfTestCompletedEvent)
  },
  "keyDestructionEvent": {
    object (KeyDestructionEvent)
  },
  "keyGeneratedEvent": {
    object (KeyGeneratedEvent)
  },
  "keyImportEvent": {
    object (KeyImportEvent)
  },
  "keyIntegrityViolationEvent": {
    object (KeyIntegrityViolationEvent)
  },
  "loggingStartedEvent": {
    object (LoggingStartedEvent)
  },
  "loggingStoppedEvent": {
    object (LoggingStoppedEvent)
  },
  "logBufferSizeCriticalEvent": {
    object (LogBufferSizeCriticalEvent)
  },
  "mediaMountEvent": {
    object (MediaMountEvent)
  },
  "mediaUnmountEvent": {
    object (MediaUnmountEvent)
  },
  "osShutdownEvent": {
    object (OsShutdownEvent)
  },
  "osStartupEvent": {
    object (OsStartupEvent)
  },
  "remoteLockEvent": {
    object (RemoteLockEvent)
  },
  "wipeFailureEvent": {
    object (WipeFailureEvent)
  },
  "connectEvent": {
    object (ConnectEvent)
  },
  "dnsEvent": {
    object (DnsEvent)
  },
  "stopLostModeUserAttemptEvent": {
    object (StopLostModeUserAttemptEvent)
  },
  "lostModeOutgoingPhoneCallEvent": {
    object (LostModeOutgoingPhoneCallEvent)
  },
  "lostModeLocationEvent": {
    object (LostModeLocationEvent)
  },
  "enrollmentCompleteEvent": {
    object (EnrollmentCompleteEvent)
  },
  "backupServiceToggledEvent": {
    object (BackupServiceToggledEvent)
  }
  // End of list of possible types for union field event.
}
字段
eventId

string (int64 format)

活动的唯一 ID。
eventTime

string (Timestamp format)

记录事件时的设备时间戳。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
eventType

enum (EventType)

设备上报告的特定使用情况日志事件类型。使用此方法可确定要访问哪个 event 字段。
联合字段 event。设备上记录的事件类型。如需详细了解每种事件类型的发送时间、记录事件时的限制以及包含的字段，请参阅相应事件类型。event 只能是下列其中一项：
adbShellCommandEvent

object (AdbShellCommandEvent)

通过 ADB 发出了 shell 命令（“adb shell command”）。属于 SECURITY_LOGS 的一部分。
adbShellInteractiveEvent

object (AdbShellInteractiveEvent)

通过“adb shell”打开了 ADB 交互式 shell。属于 SECURITY_LOGS。
appProcessStartEvent

object (AppProcessStartEvent)

应用进程已启动。“SECURITY_LOGS”的一部分
keyguardDismissedEvent

object (KeyguardDismissedEvent)

键盘锁已关闭。“SECURITY_LOGS”的一部分
keyguardDismissAuthAttemptEvent

object (KeyguardDismissAuthAttemptEvent)

有人尝试解锁设备。“SECURITY_LOGS”的一部分
keyguardSecuredEvent

object (KeyguardSecuredEvent)

设备已由用户或因超时而锁定。“SECURITY_LOGS”的一部分
filePulledEvent

object (FilePulledEvent)

已从设备下载文件。“SECURITY_LOGS”的一部分
filePushedEvent

object (FilePushedEvent)

文件已上传到设备上。“SECURITY_LOGS”的一部分
certAuthorityInstalledEvent

object (CertAuthorityInstalledEvent)

已将新的根证书安装到系统的受信任凭据存储区中。“SECURITY_LOGS”的一部分
certAuthorityRemovedEvent

object (CertAuthorityRemovedEvent)

从系统的可信凭据存储空间中移除了根证书。“SECURITY_LOGS”的一部分
certValidationFailureEvent

object (CertValidationFailureEvent)

X.509v3 证书验证失败，目前此验证是在 Wi-Fi 接入点上执行的，失败可能是由于服务器证书验证时出现不匹配。不过，未来可能会包含 X.509v3 证书的其他验证事件。“SECURITY_LOGS”的一部分
cryptoSelfTestCompletedEvent

object (CryptoSelfTestCompletedEvent)

验证 Android 的内置加密库 (BoringSSL) 是否有效。在设备启动时应始终成功，如果失败，则应将设备视为不受信任。“SECURITY_LOGS”的一部分
keyDestructionEvent

object (KeyDestructionEvent)

用户或管理系统从设备中移除了加密密钥，包括用户安装的、管理员安装的和系统维护的私钥。“SECURITY_LOGS”的一部分
keyGeneratedEvent

object (KeyGeneratedEvent)

用户或管理系统在设备上安装了加密密钥，包括用户安装的、管理员安装的和系统维护的私钥。“SECURITY_LOGS”的一部分
keyImportEvent

object (KeyImportEvent)

用户或管理系统在设备上导入了加密密钥，包括用户安装的、管理员安装的和系统维护的私钥。“SECURITY_LOGS”的一部分
keyIntegrityViolationEvent

object (KeyIntegrityViolationEvent)

由于存储空间损坏、硬件故障或某些操作系统问题，用户安装的、管理员安装的和系统维护的私钥等加密密钥被确定为已损坏。“SECURITY_LOGS”的一部分
loggingStartedEvent

object (LoggingStartedEvent)

已启用 usageLog 政策。“SECURITY_LOGS”的一部分
loggingStoppedEvent

object (LoggingStoppedEvent)

usageLog 政策已停用。“SECURITY_LOGS”的一部分
logBufferSizeCriticalEvent

object (LogBufferSizeCriticalEvent)

审核日志缓冲区已达到其容量的 90%，因此可能会丢弃较旧的事件。“SECURITY_LOGS”的一部分
mediaMountEvent

object (MediaMountEvent)

已装载可移动媒体。“SECURITY_LOGS”的一部分
mediaUnmountEvent

object (MediaUnmountEvent)

已卸载可移动媒体。“SECURITY_LOGS”的一部分
osShutdownEvent

object (OsShutdownEvent)

设备已关机。“SECURITY_LOGS”的一部分
osStartupEvent

object (OsStartupEvent)

设备已启动。“SECURITY_LOGS”的一部分
remoteLockEvent

object (RemoteLockEvent)

设备或资料已通过 LOCK 命令远程锁定。“SECURITY_LOGS”的一部分
wipeFailureEvent

object (WipeFailureEvent)

工作资料或公司自有设备在收到擦除请求时未能成功擦除。这可能是用户发起的，也可能是管理员发起的，例如收到了 delete。“SECURITY_LOGS”的一部分
connectEvent

object (ConnectEvent)

通过标准网络堆栈发起了 TCP 连接事件。“NETWORK_ACTIVITY_LOGS”的一部分
dnsEvent

object (DnsEvent)

通过标准网络堆栈发起了 DNS 查找事件。“NETWORK_ACTIVITY_LOGS”的一部分
stopLostModeUserAttemptEvent

object (StopLostModeUserAttemptEvent)

尝试使设备退出丢失模式。
lostModeOutgoingPhoneCallEvent

object (LostModeOutgoingPhoneCallEvent)

当设备处于丢失模式时，已拨出电话。
lostModeLocationEvent

object (LostModeLocationEvent)

处于丢失模式的设备在丢失模式下的位置信息更新。
enrollmentCompleteEvent

object (EnrollmentCompleteEvent)

设备已完成注册。“AMAPI_LOGS”的一部分
backupServiceToggledEvent

object (BackupServiceToggledEvent)

管理员已启用或停用备份服务。“SECURITY_LOGS”的一部分

KeyguardDismissedEvent

此类型没有字段。

键盘锁已关闭。有意为空。

KeyguardDismissAuthAttemptEvent

尝试解锁设备。

JSON 表示法 
{
  "success": boolean,
  "strongAuthMethodUsed": boolean
}
字段
success

boolean

解锁尝试是否成功。
strongAuthMethodUsed

boolean

是否使用强身份验证方式（密码、PIN 码或解锁图案）解锁设备。

KeyguardSecuredEvent

此类型没有字段。

设备已由用户或因超时而锁定。有意为空。

FilePulledEvent

已从设备下载文件。

JSON 表示法 
{
  "filePath": string
}
字段
filePath

string

正在拉取的文件对应的路径。

FilePushedEvent

文件已上传到设备上。

JSON 表示法 
{
  "filePath": string
}
字段
filePath

string

正在推送的文件的路径。

CertAuthorityInstalledEvent

已将新的根证书安装到系统的受信任凭据存储区中。在完全受管设备上，此功能可在整个设备范围内使用；在具有工作资料的组织自有设备上，此功能可在工作资料内使用。

JSON 表示法 
{
  "certificate": string,
  "userId": integer,
  "success": boolean
}
字段
certificate

string

证书的主题。
userId

integer

发生证书安装事件的用户。仅适用于搭载 Android 11 及更高版本的设备。
success

boolean

安装事件是否成功。

CertAuthorityRemovedEvent

从系统的可信凭据存储空间中移除了根证书。在完全受管设备上，此功能可在整个设备范围内使用；在具有工作资料的组织自有设备上，此功能可在工作资料内使用。

JSON 表示法 
{
  "certificate": string,
  "userId": integer,
  "success": boolean
}
字段
certificate

string

证书的主题。
userId

integer

发生证书移除事件的用户。仅适用于搭载 Android 11 及更高版本的设备。
success

boolean

移除是否成功。

CertValidationFailureEvent

X.509v3 证书验证失败，目前此验证是在 Wi-Fi 接入点上执行的，失败可能是由于服务器证书验证时出现不匹配。不过，未来可能会包含 X.509v3 证书的其他验证事件。

JSON 表示法 
{
  "failureReason": string
}
字段
failureReason

string

证书验证失败的原因。

CryptoSelfTestCompletedEvent

验证 Android 的内置加密库 (BoringSSL) 是否有效。在设备启动时应始终成功，如果失败，则应将设备视为不受信任。

JSON 表示法 
{
  "success": boolean
}
字段
success

boolean

测试是否成功。

KeyDestructionEvent

用户或管理系统从设备中移除了加密密钥，包括用户安装的、管理员安装的和系统维护的私钥。在完全受管设备上，此功能可在整个设备范围内使用；在具有工作资料的组织自有设备上，此功能可在工作资料内使用。

JSON 表示法 
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
字段
keyAlias

string

密钥的别名。
applicationUid

integer

拥有相应密钥的应用的 UID。
success

boolean

操作是否成功。

KeyGeneratedEvent

用户或管理系统在设备上安装的加密密钥，包括用户安装的私钥、管理员安装的私钥和系统维护的私钥。在全托管式设备上，此密钥可在整个设备范围内使用；在具有工作资料的组织自有设备上，此密钥可在工作资料内使用。

JSON 表示法 
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
字段
keyAlias

string

密钥的别名。
applicationUid

integer

生成密钥的应用的 UID。
success

boolean

操作是否成功。

KeyImportEvent

用户或管理系统在设备上导入了加密密钥，包括用户安装的、管理员安装的和系统维护的私钥。在完全受管设备上，此功能可在整个设备范围内使用；在具有工作资料的组织自有设备上，此功能可在工作资料内使用。

JSON 表示法 
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
字段
keyAlias

string

密钥的别名。
applicationUid

integer

导入密钥的应用的 UID
success

boolean

操作是否成功。

KeyIntegrityViolationEvent

由于存储空间损坏、硬件故障或某些操作系统问题，用户安装的、管理员安装的和系统维护的私钥等加密密钥被确定为已损坏。在完全受管设备上，此功能可在整个设备范围内使用；在具有工作资料的组织自有设备上，此功能可在工作资料内使用。

JSON 表示法 
{
  "keyAlias": string,
  "applicationUid": integer
}
字段
keyAlias

string

密钥的别名。
applicationUid

integer

拥有相应密钥的应用的 UID

LoggingStartedEvent

此类型没有字段。

已启用 usageLog 政策。有意为空。

LoggingStoppedEvent

此类型没有字段。

usageLog 政策已停用。有意为空。

LogBufferSizeCriticalEvent

此类型没有字段。

设备上的 usageLog 缓冲区已达到其容量的 90%，因此可能会舍弃较旧的事件。有意为空。

MediaMountEvent

已装载可移动媒体。

JSON 表示法 
{
  "mountPoint": string,
  "volumeLabel": string
}
字段
mountPoint

string

装载点。
volumeLabel

string

卷标。在组织自有受管理资料设备上，已编辑为“空”字符串。

MediaUnmountEvent

已卸载可移动媒体。

JSON 表示法 
{
  "mountPoint": string,
  "volumeLabel": string
}
字段
mountPoint

string

装载点。
volumeLabel

string

卷标。在组织自有受管理资料设备上，已编辑为“空”字符串。

OsShutdownEvent

此类型没有字段。

设备已关机。有意为空。

OsStartupEvent

设备已启动。

JSON 表示法 
{
  "verifiedBootState": enum (VerifiedBootState),
  "verityMode": enum (DmVerityMode)
}
字段
verifiedBootState

enum (VerifiedBootState)

启动时验证状态。
verityMode

enum (DmVerityMode)

dm-verity 模式。

RemoteLockEvent

设备或资料已通过 LOCK 命令远程锁定。

JSON 表示法 
{
  "adminPackageName": string,
  "adminUserId": integer,
  "targetUserId": integer
}
字段
adminPackageName

string

请求更改的管理员应用的软件包名称。
adminUserId

integer

请求更改的管理应用的用户 ID。
targetUserId

integer

请求更改的用户 ID。

WipeFailureEvent

此类型没有字段。

工作资料或公司自有设备在收到擦除请求时未能成功擦除。这可能是用户发起的，也可能是管理员发起的，例如收到了 delete。有意为空。

ConnectEvent

通过标准网络堆栈发起了 TCP 连接事件。

JSON 表示法 
{
  "destinationIpAddress": string,
  "destinationPort": integer,
  "packageName": string
}
字段
destinationIpAddress

string

连接调用的目标 IP 地址。
destinationPort

integer

连接调用的目标端口。
packageName

string

执行连接调用的 UID 的软件包名称。

DnsEvent

通过标准网络堆栈发起了 DNS 查找事件。

JSON 表示法 
{
  "hostname": string,
  "ipAddresses": [
    string
  ],
  "totalIpAddressesReturned": string,
  "packageName": string
}
字段
hostname

string

所查找的主机名。
ipAddresses[]

string

DNS 查找返回的 IP 地址列表（可能已截断）（最多 10 个 IPv4 或 IPv6 地址）。
totalIpAddressesReturned

string (int64 format)

从 DNS 查找事件返回的 IP 地址数量。如果需要记录的地址过多，则可能高于 ipAddresses 的数量。
packageName

string

执行 DNS 查找的 UID 的软件包名称。

StopLostModeUserAttemptEvent

丢失模式事件，表示用户尝试停止丢失模式。

JSON 表示法 
{
  "status": enum (Status)
}
字段
status

enum (Status)

尝试停止丢失模式的状态。

LostModeOutgoingPhoneCallEvent

此类型没有字段。

一种事件，用于指示当设备处于丢失模式时，已拨出电话。有意为空。

LostModeLocationEvent

包含设备位置信息和电池电量百分比的丢失模式事件。

JSON 表示法 
{
  "location": {
    object (Location)
  },
  "batteryLevel": integer
}
字段
location

object (Location)

设备位置信息
batteryLevel

integer

电池电量，介于 0 到 100 之间（含边界值）的数字

位置

包含纬度和经度的设备位置信息。

JSON 表示法 
{
  "latitude": number,
  "longitude": number
}
字段
latitude

number

相应位置的纬度
longitude

number

相应位置的经度

EnrollmentCompleteEvent

此类型没有字段。

表示设备已完成注册。此时，用户应位于启动器中，设备应符合要求，并且所有设置步骤均已完成。有意为空。