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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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)
  }
  // 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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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 נפתחה באמצעות '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 connect הופעל דרך סטאק הרשת הסטנדרטי. חלק מ-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 connect הופעל דרך סטאק הרשת הסטנדרטי.

ייצוג ב-JSON 
{
  "destinationIpAddress": string,
  "destinationPort": integer,
  "packageName": string
}
שדות
destinationIpAddress

string

כתובת ה-IP של היעד של קריאת ההתחברות.
destinationPort

integer

יציאת היעד של קריאת ה-connect.
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

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

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