Reports API: דוח פעילות ביקורת על מכשירים

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

אפשר להשתמש בדוח פעילות הביקורת של המכשיר רק למטרות חוקיות בהתאם להסכם הלקוח. כדי לדעת באילו מהדורות הדוחות האלה כלולים, אפשר לעיין בהשוואה בין המהדורות של Google Workspace.

אחזור אירועי ביקורת של מכשירים בדומיין

כדי לאחזר את כל האירועים שמצריכים בדיקה במכשירים של כל המשתמשים בדומיין, צריך להשתמש בבקשת ה-HTTP הבאה ולכלול את אסימון ההרשאה שמתואר במסמכי ההרשאה.GET מידע נוסף על מחרוזות השאילתות של הבקשות ומאפייני התגובה זמין במאמר אירועי פעילות של ביקורת מכשירים. לצורך קריאות, הדוגמה הבאה מעוצבת עם מעברי שורה:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?endTime=end date&startTime=start date
&maxResults=maximum number of events returned on a response page

בדוגמה הבאה מוצג דוח על כל אירועי הביקורת של המכשירים בחשבון ב-180 הימים האחרונים. פרמטר השאילתה maxResults מחזיר 25 תוצאות לכל דף.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?maxResults=25

בדוגמה הבאה מוצג דוח על כל אירועי הביקורת של המכשירים ב-180 הימים האחרונים. הערך customerId מציין את הדוח של איזה לקוח יאוחזר.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb

אחזור אירועי ביקורת של מכשירים לפי שם האירוע

במקרים מסוימים, יכול להיות שתרצו לאחזר אירועים ספציפיים, כמו אירועים של פעילות חשודה. כדי לעשות את זה, משתמשים בבקשת HTTP‏ GET בפורמט הבא:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?maxResults=maximum number of events returned on a response page
&eventName=name of the event
&filters=event parameter relational operator parameter value

בדוגמה הבאה מוצגות פעולות לאחזור כל האירועים של פעילות חשודה של משתמשי Android בדומיין:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25