BatchUsageLogEvents

Nhật ký sự kiện theo lô của events trên thiết bị.

Biểu diễn dưới dạng JSON
{   "device": string,   "user": string,   "retrievalTime": string,   "usageLogEvents": [     {       object (UsageLogEvent)     }   ] }
Trường
device

string

Nếu có, tên của thiết bị ở dạng "enterprises/{enterpriseId}/devices/{deviceId}"

user

string

Nếu có, tên tài nguyên của người dùng sở hữu thiết bị này ở dạng "enterprises/{enterpriseId}/users/{userId}".

retrievalTime

string (Timestamp format)

Dấu thời gian của thiết bị khi nhóm sự kiện được thu thập từ thiết bị.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

usageLogEvents[]

object (UsageLogEvent)

Danh sách UsageLogEvent do thiết bị báo cáo, được sắp xếp theo thứ tự thời gian theo thời gian diễn ra sự kiện.

UsageLogEvent

Một sự kiện được ghi lại trên thiết bị.

Biểu diễn dưới dạng 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. }
Trường
eventId

string (int64 format)

Mã nhận dạng duy nhất của sự kiện.

eventTime

string (Timestamp format)

Dấu thời gian của thiết bị khi sự kiện được ghi lại.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

eventType

enum (EventType)

Loại sự kiện nhật ký sử dụng cụ thể đã được báo cáo trên thiết bị. Dùng phương thức này để xác định trường event cần truy cập.

Trường nhóm event. Các loại sự kiện được ghi lại trên thiết bị. Hãy xem từng loại sự kiện để biết thêm thông tin chi tiết về thời điểm gửi, cũng như các quy định hạn chế về thời điểm ghi lại sự kiện và những trường được đưa vào. event chỉ có thể là một trong những trạng thái sau:
adbShellCommandEvent

object (AdbShellCommandEvent)

Một lệnh shell đã được phát hành qua ADB thông qua "lệnh adb shell". Một phần của SECURITY_LOGS.

adbShellInteractiveEvent

object (AdbShellInteractiveEvent)

Một shell tương tác ADB đã được mở thông qua "adb shell". Một phần của SECURITY_LOGS.

appProcessStartEvent

object (AppProcessStartEvent)

Một quy trình ứng dụng đã được bắt đầu. Thuộc SECURITY_LOGS.

keyguardDismissedEvent

object (KeyguardDismissedEvent)

Khoá màn hình đã bị đóng. Thuộc SECURITY_LOGS.

keyguardDismissAuthAttemptEvent

object (KeyguardDismissAuthAttemptEvent)

Có người đã cố gắng mở khoá thiết bị. Thuộc SECURITY_LOGS.

keyguardSecuredEvent

object (KeyguardSecuredEvent)

Thiết bị đã bị khoá do người dùng hoặc hết thời gian chờ. Thuộc SECURITY_LOGS.

filePulledEvent

object (FilePulledEvent)

Một tệp đã được tải xuống thiết bị. Thuộc SECURITY_LOGS.

filePushedEvent

object (FilePushedEvent)

Một tệp đã được tải lên thiết bị. Thuộc SECURITY_LOGS.

certAuthorityInstalledEvent

object (CertAuthorityInstalledEvent)

Một chứng chỉ gốc mới đã được cài đặt vào bộ nhớ thông tin đăng nhập đáng tin cậy của hệ thống. Thuộc SECURITY_LOGS.

certAuthorityRemovedEvent

object (CertAuthorityRemovedEvent)

Một chứng chỉ gốc đã bị xoá khỏi bộ nhớ thông tin xác thực đáng tin cậy của hệ thống. Thuộc SECURITY_LOGS.

certValidationFailureEvent

object (CertValidationFailureEvent)

Không xác thực được chứng chỉ X.509v3. Hiện tại, quá trình xác thực này được thực hiện trên điểm truy cập Wi-Fi và lỗi có thể là do sự không khớp khi xác thực chứng chỉ máy chủ. Tuy nhiên, trong tương lai, có thể API này sẽ bao gồm các sự kiện xác thực khác của chứng chỉ X.509v3. Thuộc SECURITY_LOGS.

cryptoSelfTestCompletedEvent

object (CryptoSelfTestCompletedEvent)

Xác thực xem thư viện mã hoá tích hợp của Android (BoringSSL) có hợp lệ hay không. Luôn thành công khi khởi động thiết bị. Nếu không thành công, thiết bị sẽ được coi là không đáng tin cậy. Thuộc SECURITY_LOGS.

keyDestructionEvent

object (KeyDestructionEvent)

Khoá mã hoá (bao gồm cả khoá riêng tư do người dùng cài đặt, quản trị viên cài đặt và hệ thống duy trì) sẽ bị người dùng hoặc hệ thống quản lý xoá khỏi thiết bị. Thuộc SECURITY_LOGS.

keyGeneratedEvent

object (KeyGeneratedEvent)

Khoá mã hoá (bao gồm khoá riêng tư do người dùng cài đặt, do quản trị viên cài đặt và do hệ thống duy trì) được người dùng hoặc hoạt động quản lý cài đặt trên thiết bị. Thuộc SECURITY_LOGS.

keyImportEvent

object (KeyImportEvent)

Người dùng hoặc hoạt động quản lý nhập một khoá mã hoá (bao gồm cả khoá riêng tư do người dùng cài đặt, do quản trị viên cài đặt và do hệ thống duy trì) vào thiết bị. Thuộc SECURITY_LOGS.

keyIntegrityViolationEvent

object (KeyIntegrityViolationEvent)

Một khoá mã hoá (bao gồm khoá riêng tư do người dùng cài đặt, quản trị viên cài đặt và hệ thống duy trì) được xác định là bị hỏng do bộ nhớ bị hỏng, phần cứng bị lỗi hoặc một số vấn đề về hệ điều hành. Thuộc SECURITY_LOGS.

loggingStartedEvent

object (LoggingStartedEvent)

Bạn đã bật chính sách usageLog. Thuộc SECURITY_LOGS.

loggingStoppedEvent

object (LoggingStoppedEvent)

Chính sách usageLog đã bị vô hiệu hoá. Thuộc SECURITY_LOGS.

logBufferSizeCriticalEvent

object (LogBufferSizeCriticalEvent)

Vùng đệm nhật ký kiểm tra đã đạt 90% dung lượng, do đó, các sự kiện cũ hơn có thể bị loại bỏ. Thuộc SECURITY_LOGS.

mediaMountEvent

object (MediaMountEvent)

Đã gắn phương tiện di động. Thuộc SECURITY_LOGS.

mediaUnmountEvent

object (MediaUnmountEvent)

Đã tháo phương tiện di động. Thuộc SECURITY_LOGS.

osShutdownEvent

object (OsShutdownEvent)

Thiết bị đã tắt. Thuộc SECURITY_LOGS.

osStartupEvent

object (OsStartupEvent)

Thiết bị đã khởi động. Thuộc SECURITY_LOGS.

remoteLockEvent

object (RemoteLockEvent)

Thiết bị hoặc hồ sơ đã bị khoá từ xa thông qua lệnh LOCK. Thuộc SECURITY_LOGS.

wipeFailureEvent

object (WipeFailureEvent)

Không xoá được dữ liệu trong hồ sơ công việc hoặc trên thiết bị thuộc sở hữu của công ty khi được yêu cầu. Thao tác này có thể do người dùng hoặc quản trị viên thực hiện, ví dụ: delete đã được nhận. Thuộc SECURITY_LOGS.

connectEvent

object (ConnectEvent)

Một sự kiện kết nối TCP được bắt đầu thông qua ngăn xếp mạng tiêu chuẩn. Thuộc NETWORK_ACTIVITY_LOGS.

dnsEvent

object (DnsEvent)

Một sự kiện tra cứu DNS đã được bắt đầu thông qua ngăn xếp mạng tiêu chuẩn. Thuộc NETWORK_ACTIVITY_LOGS.

stopLostModeUserAttemptEvent

object (StopLostModeUserAttemptEvent)

Có người tìm cách đưa thiết bị ra khỏi chế độ thất lạc.

lostModeOutgoingPhoneCallEvent

object (LostModeOutgoingPhoneCallEvent)

Đã thực hiện cuộc gọi đi khi thiết bị ở chế độ thất lạc.

lostModeLocationEvent

object (LostModeLocationEvent)

Thông tin cập nhật vị trí ở chế độ thất lạc khi thiết bị ở chế độ này.

enrollmentCompleteEvent

object (EnrollmentCompleteEvent)

Thiết bị đã hoàn tất quy trình đăng ký. Thuộc AMAPI_LOGS.

backupServiceToggledEvent

object (BackupServiceToggledEvent)

Quản trị viên đã bật hoặc tắt dịch vụ sao lưu. Thuộc SECURITY_LOGS.

KeyguardDismissedEvent

Loại này không có trường nào.

Khoá màn hình đã bị đóng. Cố tình để trống.

KeyguardDismissAuthAttemptEvent

Có người đã cố gắng mở khoá thiết bị.

Biểu diễn dưới dạng JSON
{   "success": boolean,   "strongAuthMethodUsed": boolean }
Trường
success

boolean

Lần thử mở khoá có thành công hay không.

strongAuthMethodUsed

boolean

Liệu có sử dụng một phương thức xác thực mạnh (mật khẩu, mã PIN hoặc hình mở khoá) để mở khoá thiết bị hay không.

KeyguardSecuredEvent

Loại này không có trường nào.

Thiết bị đã bị khoá do người dùng hoặc hết thời gian chờ. Cố tình để trống.

FilePulledEvent

Một tệp đã được tải xuống thiết bị.

Biểu diễn dưới dạng JSON
{   "filePath": string }
Trường
filePath

string

Đường dẫn của tệp đang được kéo.

FilePushedEvent

Một tệp đã được tải lên thiết bị.

Biểu diễn dưới dạng JSON
{   "filePath": string }
Trường
filePath

string

Đường dẫn của tệp đang được đẩy.

CertAuthorityInstalledEvent

Một chứng chỉ gốc mới đã được cài đặt vào bộ nhớ thông tin đăng nhập đáng tin cậy của hệ thống. Tính năng này có trên toàn bộ thiết bị đối với các thiết bị được quản lý hoàn toàn và trong hồ sơ công việc đối với các thiết bị do tổ chức sở hữu có hồ sơ công việc.

Biểu diễn dưới dạng JSON
{   "certificate": string,   "userId": integer,   "success": boolean }
Trường
certificate

string

Chủ đề của chứng chỉ.

userId

integer

Người dùng mà sự kiện cài đặt chứng chỉ đã xảy ra. Chỉ có trên các thiết bị chạy Android 11 trở lên.

success

boolean

Sự kiện cài đặt có thành công hay không.

CertAuthorityRemovedEvent

Một chứng chỉ gốc đã bị xoá khỏi bộ nhớ thông tin xác thực đáng tin cậy của hệ thống. Tính năng này có trên toàn bộ thiết bị đối với các thiết bị được quản lý hoàn toàn và trong hồ sơ công việc đối với các thiết bị do tổ chức sở hữu có hồ sơ công việc.

Biểu diễn dưới dạng JSON
{   "certificate": string,   "userId": integer,   "success": boolean }
Trường
certificate

string

Chủ đề của chứng chỉ.

userId

integer

Người dùng mà sự kiện xoá chứng chỉ đã xảy ra. Chỉ có trên các thiết bị chạy Android 11 trở lên.

success

boolean

Việc xoá có thành công hay không.

CertValidationFailureEvent

Không xác thực được chứng chỉ X.509v3. Hiện tại, quá trình xác thực này được thực hiện trên điểm truy cập Wi-Fi và lỗi có thể là do sự không khớp khi xác thực chứng chỉ máy chủ. Tuy nhiên, trong tương lai, có thể API này sẽ bao gồm các sự kiện xác thực khác của chứng chỉ X.509v3.

Biểu diễn dưới dạng JSON
{   "failureReason": string }
Trường
failureReason

string

Lý do xác thực chứng nhận không thành công.

CryptoSelfTestCompletedEvent

Xác thực xem thư viện mã hoá tích hợp của Android (BoringSSL) có hợp lệ hay không. Luôn thành công khi khởi động thiết bị. Nếu không thành công, thiết bị sẽ được coi là không đáng tin cậy.

Biểu diễn dưới dạng JSON
{   "success": boolean }
Trường
success

boolean

Thử nghiệm có thành công hay không.

KeyDestructionEvent

Khoá mã hoá (bao gồm cả khoá riêng tư do người dùng cài đặt, quản trị viên cài đặt và hệ thống duy trì) sẽ bị người dùng hoặc hệ thống quản lý xoá khỏi thiết bị. Tính năng này có trên toàn bộ thiết bị đối với các thiết bị được quản lý hoàn toàn và trong hồ sơ công việc đối với các thiết bị do tổ chức sở hữu có hồ sơ công việc.

Biểu diễn dưới dạng JSON
{   "keyAlias": string,   "applicationUid": integer,   "success": boolean }
Trường
keyAlias

string

Bí danh của khoá.

applicationUid

integer

UID của ứng dụng sở hữu khoá.

success

boolean

Thao tác có thành công hay không.

KeyGeneratedEvent

Khoá mã hoá (bao gồm khoá riêng tư do người dùng cài đặt, do quản trị viên cài đặt và do hệ thống duy trì) được người dùng hoặc hoạt động quản lý cài đặt trên thiết bị.Khoá này có trên toàn bộ thiết bị đối với các thiết bị được quản lý hoàn toàn và trong hồ sơ công việc trên các thiết bị thuộc sở hữu của tổ chức có hồ sơ công việc.

Biểu diễn dưới dạng JSON
{   "keyAlias": string,   "applicationUid": integer,   "success": boolean }
Trường
keyAlias

string

Bí danh của khoá.

applicationUid

integer

UID của ứng dụng đã tạo khoá.

success

boolean

Thao tác có thành công hay không.

KeyImportEvent

Người dùng hoặc hoạt động quản lý nhập một khoá mã hoá (bao gồm cả khoá riêng tư do người dùng cài đặt, do quản trị viên cài đặt và do hệ thống duy trì) vào thiết bị. Tính năng này có trên toàn bộ thiết bị đối với các thiết bị được quản lý hoàn toàn và trong hồ sơ công việc đối với các thiết bị do tổ chức sở hữu có hồ sơ công việc.

Biểu diễn dưới dạng JSON
{   "keyAlias": string,   "applicationUid": integer,   "success": boolean }
Trường
keyAlias

string

Bí danh của khoá.

applicationUid

integer

UID của ứng dụng đã nhập khoá

success

boolean

Thao tác có thành công hay không.

KeyIntegrityViolationEvent

Một khoá mã hoá (bao gồm khoá riêng tư do người dùng cài đặt, quản trị viên cài đặt và hệ thống duy trì) được xác định là bị hỏng do bộ nhớ bị hỏng, phần cứng bị lỗi hoặc một số vấn đề về hệ điều hành. Tính năng này có trên toàn bộ thiết bị đối với các thiết bị được quản lý hoàn toàn và trong hồ sơ công việc đối với các thiết bị do tổ chức sở hữu có hồ sơ công việc.

Biểu diễn dưới dạng JSON
{   "keyAlias": string,   "applicationUid": integer }
Trường
keyAlias

string

Bí danh của khoá.

applicationUid

integer

UID của ứng dụng sở hữu khoá

LoggingStartedEvent

Loại này không có trường nào.

Bạn đã bật chính sách usageLog. Cố tình để trống.

LoggingStoppedEvent

Loại này không có trường nào.

Chính sách usageLog đã bị vô hiệu hoá. Cố tình để trống.

LogBufferSizeCriticalEvent

Loại này không có trường nào.

Vùng đệm usageLog trên thiết bị đã đạt 90% dung lượng, do đó, các sự kiện cũ hơn có thể bị loại bỏ. Cố tình để trống.

MediaMountEvent

Đã gắn phương tiện di động.

Biểu diễn dưới dạng JSON
{   "mountPoint": string,   "volumeLabel": string }
Trường
mountPoint

string

Điểm gắn.

volumeLabel

string

Nhãn ổ đĩa. Được chỉnh sửa thành chuỗi trống trên các thiết bị có hồ sơ được quản lý do tổ chức sở hữu.

MediaUnmountEvent

Đã tháo phương tiện di động.

Biểu diễn dưới dạng JSON
{   "mountPoint": string,   "volumeLabel": string }
Trường
mountPoint

string

Điểm gắn.

volumeLabel

string

Nhãn ổ đĩa. Được chỉnh sửa thành chuỗi trống trên các thiết bị có hồ sơ được quản lý do tổ chức sở hữu.

OsShutdownEvent

Loại này không có trường nào.

Thiết bị đã tắt. Cố tình để trống.

OsStartupEvent

Thiết bị đã khởi động.

Biểu diễn dưới dạng JSON
{   "verifiedBootState": enum (VerifiedBootState),   "verityMode": enum (DmVerityMode) }
Trường
verifiedBootState

enum (VerifiedBootState)

Trạng thái Xác minh quy trình khởi động.

verityMode

enum (DmVerityMode)

chế độ dm-verity.

RemoteLockEvent

Thiết bị hoặc hồ sơ đã bị khoá từ xa thông qua lệnh LOCK.

Biểu diễn dưới dạng JSON
{   "adminPackageName": string,   "adminUserId": integer,   "targetUserId": integer }
Trường
adminPackageName

string

Tên gói của ứng dụng quản trị yêu cầu thay đổi.

adminUserId

integer

Mã nhận dạng người dùng của ứng dụng quản trị mà từ đó yêu cầu thay đổi được gửi.

targetUserId

integer

Mã nhận dạng người dùng mà bạn đã yêu cầu thay đổi.

WipeFailureEvent

Loại này không có trường nào.

Không xoá được dữ liệu trong hồ sơ công việc hoặc trên thiết bị thuộc sở hữu của công ty khi được yêu cầu. Thao tác này có thể do người dùng hoặc quản trị viên thực hiện, ví dụ: delete đã được nhận. Cố tình để trống.

ConnectEvent

Một sự kiện kết nối TCP được bắt đầu thông qua ngăn xếp mạng tiêu chuẩn.

Biểu diễn dưới dạng JSON
{   "destinationIpAddress": string,   "destinationPort": integer,   "packageName": string }
Trường
destinationIpAddress

string

Địa chỉ IP đích của lệnh gọi kết nối.

destinationPort

integer

Cổng đích của lệnh gọi kết nối.

packageName

string

Tên gói của UID đã thực hiện lệnh gọi kết nối.

DnsEvent

Một sự kiện tra cứu DNS đã được bắt đầu thông qua ngăn xếp mạng tiêu chuẩn.

Biểu diễn dưới dạng JSON
{   "hostname": string,   "ipAddresses": [     string   ],   "totalIpAddressesReturned": string,   "packageName": string }
Trường
hostname

string

Tên máy chủ lưu trữ đã được tra cứu.

ipAddresses[]

string

Danh sách (có thể bị cắt bớt) các địa chỉ IP được trả về cho hoạt động tra cứu DNS (tối đa 10 địa chỉ IPv4 hoặc IPv6).

totalIpAddressesReturned

string (int64 format)

Số lượng địa chỉ IP được trả về từ sự kiện tra cứu DNS. Có thể cao hơn số lượng ipAddresses nếu có quá nhiều địa chỉ để ghi nhật ký.

packageName

string

Tên gói của UID đã thực hiện tra cứu DNS.

StopLostModeUserAttemptEvent

Một sự kiện ở chế độ thất lạc cho biết người dùng đã cố gắng dừng chế độ thất lạc.

Biểu diễn dưới dạng JSON
{   "status": enum (Status) }
Trường
status

enum (Status)

Trạng thái của lần thử dừng chế độ thất lạc.

LostModeOutgoingPhoneCallEvent

Loại này không có trường nào.

Một sự kiện cho biết cuộc gọi điện thoại đi đã được thực hiện khi thiết bị ở chế độ thất lạc. Cố tình để trống.

LostModeLocationEvent

Một sự kiện ở chế độ thất lạc chứa thông tin về vị trí thiết bị và mức pin theo tỷ lệ phần trăm.

Biểu diễn dưới dạng JSON
{   "location": {     object (Location)   },   "batteryLevel": integer }
Trường
location

object (Location)

Vị trí của thiết bị

batteryLevel

integer

Mức pin dưới dạng một số từ 0 đến 100

Vị trí

Vị trí của thiết bị chứa vĩ độ và kinh độ.

Biểu diễn dưới dạng JSON
{   "latitude": number,   "longitude": number }
Trường
latitude

number

Vị trí vĩ độ của địa điểm

longitude

number

Vị trí kinh độ của địa điểm

EnrollmentCompleteEvent

Loại này không có trường nào.

Cho biết thiết bị đã hoàn tất quy trình đăng ký. Lúc này, người dùng sẽ ở trong trình chạy, thiết bị sẽ tuân thủ và tất cả các bước thiết lập đã hoàn tất. Cố tình để trống.