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