דוחות 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