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)

因為儲存體損毀、硬體故障或 OS 問題，包含由使用者安裝、由管理員安裝、由系統維護的私密金鑰等加密編譯金鑰已經損毀。「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

因為儲存體損毀、硬體故障或 OS 問題，包含由使用者安裝、由管理員安裝、由系統維護的私密金鑰等加密編譯金鑰已經損毀。這項功能適用於全裝置管理，包括全代管裝置，以及設有工作資料夾的機構裝置工作資料夾。

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 位址數量。如有要記錄的位址過多，該位址可能會高於 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

這個類型沒有任何欄位。

代表裝置已完成註冊。使用者應在此啟動器中瀏覽，現在裝置即符合規定，且所有設定步驟均已完成。刻意空白。