קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדוח פעילות הכניסה מוצג מידע על פעילויות הכניסה של כל המשתמשים בחשבון. כל דוח משתמש בבקשת נקודת הקצה של הדוח הבסיסי עם פרמטרים ספציפיים לדוח, כמו כתובת האימייל של המשתמש. פרק הזמן המקסימלי לכל דוח הוא 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 parameterrelational operatorparameter value
בדוגמה הבאה מוצגות כל ההתחברויות החשודות שבוצעו בהצלחה בדומיין:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-08-29 (שעון UTC)."],[],[],null,["# Reports API: Login Activity Report\n\nThe login activity report returns information on the login activities of all of\nyour account's users. Each report uses the basic report endpoint request with\nreport-specific parameters such as a user's email. The\nmaximum time period for each report is the last 180 days.\n| **Note:** The login activity report only audits explicit password and SAML-based single sign-on (SSO) logins.\n\nThe login activity report may be used only for lawful purposes in accordance with your Customer Agreement.\n\nRetrieve Google Workspace login events for a domain\n---------------------------------------------------\n\nTo retrieve all logins for all of your domain's services, use the following\n`GET` HTTP request and include the authorization token described in the\n[authorization documentation](https://developers.google.com/workspace/admin/reports/v1/guides/authorizing.html).\nFor more information about the request query strings and response properties,\nsee the [API Reference](/workspace/admin/reports/v1/reference/activity-ref-appendix-a/login-event-names).\nFor readability purposes, the following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/login?endTime=end date&startTime=start date\n&maxResults=maximum number of events returned on a response page\n```\n\nThe following example gets a report on all of your account's login events for\nthe past 180 days. The `maxResults` query parameter has this report return\n25 results per page. \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?maxResults=25\n```\n\nThe following example gets a report on all of a customer's login events for\nthe past 180 days. The `customerId` specifies which customer the report is\nto be retrieved for. \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?customerId=C03az79cb\n```\n\nRetrieve Google Workspace login events by event name\n----------------------------------------------------\n\nIn some instances, you may want to retrieve specific\n[events](/workspace/admin/reports/v1/reference/activity-ref-appendix-a/login-event-names),\nsuch as suspicious successful logins. To do this, use a `GET` HTTP request of\nthe following form: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/login?maxResults=maximum number of events returned on a response page\n&eventName=name of the login event\n&filters=event parameter relational operator parameter value\n```\n\nThe following example shows how to retrieve all suspicious successful logins\nfor a domain: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25\n```"]]
