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