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)

מזהה ייחודי של האירוע.
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)

פקודת Shell הופקה באמצעות ADB דרך adb shell command. חלק מ-SECURITY_LOGS.
adbShellInteractiveEvent

object (AdbShellInteractiveEvent)

נפתחה מעטפת אינטראקטיבית של ADB באמצעות adb shell. חלק מ-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.
backupServiceToggledEvent

object (BackupServiceToggledEvent)

אדמין הפעיל או השבית את שירות הגיבוי. חלק מSECURITY_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. יכול להיות שהערך יהיה גבוה יותר ממספר כתובות ה-IP אם היו יותר מדי כתובות לרישום ביומן.
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

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

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