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