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

בדוח הפעילות של ביקורת המכשיר מוצג מידע על הפעילויות של כל המכשירים שנמצאים בניהול נקודות הקצה של 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