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)

חותמת הזמן של המכשיר בזמן איסוף קבוצת האירועים מהמכשיר.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
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

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

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

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