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, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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)

מאמת אם הספרייה הקריפטוגרפית המובנית (BoringSSL) ב-Android תקינה. תמיד אמור להצליח באתחול המכשיר. אם הפעולה נכשלת, המכשיר ייחשב כבלתי מהימן. חלק מרשת 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

מאמת אם הספרייה הקריפטוגרפית המובנית (BoringSSL) ב-Android תקינה. תמיד אמור להצליח באתחול המכשיר. אם הפעולה נכשלת, המכשיר ייחשב כבלתי מהימן.

ייצוג 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

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

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