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

這個類型沒有任何欄位。

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