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」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。範例："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」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如 "2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
eventType

enum (EventType)

裝置上回報的特定用量記錄事件類型。可用來判斷要存取哪個 event 欄位。
聯集欄位 event。裝置記錄的事件類型。請參閱各個事件類型，進一步瞭解事件傳送時間，以及記錄事件的時機和納入的欄位。event 只能是下列其中一項：
adbShellCommandEvent

object (AdbShellCommandEvent)

殼層指令是透過「ADB 殼層指令」透過 ADB 發出。SECURITY_LOGS 部分。
adbShellInteractiveEvent

object (AdbShellInteractiveEvent)

透過「adb shell」開啟 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)

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

位置

含有經緯度的裝置位置。

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

number

地點的緯度位置
longitude

number

地點的經度

EnrollmentCompleteEvent

這個類型沒有任何欄位。

表示裝置已完成註冊。使用者應已進入啟動器，裝置也已符合規定，且已完成所有設定步驟。故意空白。