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 UTC '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)

המזהה הייחודי של האירוע.
eventTime

string (Timestamp format)

חותמת הזמן של המכשיר כשהאירוע נרשם ביומן.

חותמת זמן ב-RFC3339 UTC '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 נפתחה באמצעות 'מעטפת 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

האם נעשה שימוש באמצעי אימות חזק (סיסמה, קוד אימות או קו ביטול נעילה) כדי לבטל את נעילת המכשיר.

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

מזהה המשתמש של אפליקציית הניהול שממנה התבקש השינוי.
targetUserId

integer

מזהה המשתמש שבו נשלחה הבקשה לשינוי.

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

הרשימה (שעשויות להיות חתוכה) של כתובות ה-IP שהוחזרו לחיפוש DNS (עד 10 כתובות IPv4 או IPv6).
totalIpAddressesReturned

string (int64 format)

מספר כתובות ה-IP שהוחזרו מאירוע חיפוש ה-DNS. יכול להיות שהוא יהיה גבוה יותר מכמות כתובות ה-ipAddresses אם היו יותר מדי כתובות לתיעוד.
packageName

string

שם החבילה של ה-UID שביצע את חיפוש ה-DNS.

StopLostModeUserAttemptEvent

אירוע של 'מצב אובדן מכשיר' שמציין שהמשתמש ניסה להפסיק את 'מצב אובדן מכשיר'.

ייצוג JSON 
{
  "status": enum (Status)
}
שדות
status

enum (Status)

הסטטוס של הניסיון להפסיק את 'מצב אובדן מכשיר'.

LostModeOutgoingPhoneCallEvent

אין שדות בסוג הזה.

אירוע שמציין שהתבצעה שיחת טלפון יוצאת כשמכשיר נמצא במצב 'אבד'. ריק בכוונה.

LostModeLocationEvent

אירוע של 'מצב אובדן מכשיר', שכולל את מיקום המכשיר ורמת הטעינה באחוזים.

ייצוג JSON 
{
  "location": {
    object (Location)
  },
  "batteryLevel": integer
}
שדות
location

object (Location)

מיקום המכשיר
batteryLevel

integer

רמת הטעינה של הסוללה כמספר בין 0 ל-100, כולל

מיקום

מיקום המכשיר שכולל את קו הרוחב וקו האורך.

ייצוג JSON 
{
  "latitude": number,
  "longitude": number
}
שדות
latitude

number

קו הרוחב של המיקום
longitude

number

קו האורך של המיקום

EnrollmentCompleteEvent

אין שדות בסוג הזה.

מציין שהמכשיר השלים את הרישום. המשתמש צריך להיות במרכז האפליקציות בשלב הזה, המכשיר בשלב הזה יעמוד בדרישות וכל שלבי ההגדרה הושלמו. ריק בכוונה.