בדוח 'פעילות כניסה' מוצג מידע על פעילויות הכניסה של כל המשתמשים בחשבון. בכל דוח נעשה שימוש בבקשה הבסיסית של נקודת הקצה של הדוח עם פרמטרים ספציפיים לדוח, כמו כתובת האימייל של המשתמש. פרק הזמן המקסימלי לכל דוח הוא 180 הימים האחרונים.
ניתן להשתמש בדוח 'פעילות כניסה' רק למטרות חוקיות, בהתאם להסכם הלקוח שלכם.
אחזור אירועי כניסה ל-Google Workspace בדומיין
כדי לאחזר את כל הכניסות לכל שירותי הדומיין, משתמשים בבקשת ה-HTTP הבאה מסוג GET וכוללים את אסימון ההרשאה שמתואר במסמכי ההרשאה.
מידע נוסף על מחרוזות השאילתה של הבקשה ועל מאפייני התגובה זמין בהפניית ה-API.
כדי להקל על הקריאה, הדוגמה הבאה פורמטה עם הפסקות שורה:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/login?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/login?maxResults=25
בדוגמה הבאה מוצג דוח של כל אירועי הכניסה של לקוח ב-180 הימים האחרונים. השדה customerId מציין את הלקוח שאליו צריך לאחזר את הדוח.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?customerId=C03az79cb
אחזור אירועי כניסה ל-Google Workspace לפי שם האירוע
במקרים מסוימים, יכול להיות שתרצו לאחזר אירועים ספציפיים, כמו כניסות מוצלחות חשודות. כדי לעשות זאת, משתמשים בבקשת HTTP מסוג GET בפורמט הבא:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/login?maxResults=maximum number of events returned on a response page &eventName=name of the login event &filters=event parameter relational operator parameter value
בדוגמה הבאה מוסבר איך לאחזר את כל הכניסות המוצלחות החשודות לדומיין:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25