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