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 發出殼層指令 (使用「adb shell command」)。部分 SECURITY_LOGS。
adbShellInteractiveEvent

object (AdbShellInteractiveEvent)

透過「adb shell」開啟 ADB 互動式殼層。部分 SECURITY_LOGS。
appProcessStartEvent

object (AppProcessStartEvent)

應用程式程序已啟動。SECURITY_LOGS 的一部分。
keyguardDismissedEvent

object (KeyguardDismissedEvent)

已關閉 Keyguard。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

這個類型沒有任何欄位。

已關閉 Keyguard。刻意留空。

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

這個類型沒有任何欄位。

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