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)

從裝置收集整批事件的裝置時間戳記。

RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

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)
  }
  // End of list of possible types for union field event.
}
欄位
eventId

string (int64 format)

事件的專屬 ID。

eventTime

string (Timestamp format)

記錄事件的裝置時間戳記。

RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

eventType

enum (EventType)

裝置上回報的特定使用記錄事件類型。這個欄位會決定要存取的「event」欄位。

聯集欄位 event。裝置上記錄的事件類型。請參閱各個事件類型,進一步瞭解事件傳送時間,以及記錄事件的時機和納入的欄位。event 只能是下列其中一項:
adbShellCommandEvent

object (AdbShellCommandEvent)

殼層指令是透過「adb shell 指令」透過 ADB 發出。「SECURITY_LOGS」的一部分。

adbShellInteractiveEvent

object (AdbShellInteractiveEvent)

一個透過「ADB 殼層」開啟 ADB 互動殼層。「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」的一部分。

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)

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 位址數量。如果要記錄的位址過多,則可能會超過 ipAddress 的數量。

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 之間的數字表示電池電量 (含 0 和 100)

位置

含有經緯度的裝置位置。

JSON 表示法
{
  "latitude": number,
  "longitude": number
}
欄位
latitude

number

營業地點的緯度位置

longitude

number

營業地點的經度位置

EnrollmentCompleteEvent

這個類型沒有任何欄位。

代表裝置已完成註冊。此時,使用者應該會顯示在啟動器中,目前裝置就符合規定,且所有設定步驟都已完成。刻意空白。