با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
گزارش فعالیت ورود اطلاعات مربوط به فعالیت های ورود به سیستم همه کاربران حساب شما را برمی گرداند. هر گزارش از درخواست نقطه پایانی گزارش اولیه با پارامترهای خاص گزارش مانند ایمیل کاربر استفاده می کند. حداکثر دوره زمانی برای هر گزارش 180 روز گذشته است.
گزارش فعالیت ورود به سیستم ممکن است فقط برای اهداف قانونی مطابق با توافق نامه مشتری شما استفاده شود.
رویدادهای ورود به سیستم Google Workspace را برای یک دامنه بازیابی کنید
برای بازیابی همه ورودی‌ها برای همه سرویس‌های دامنه خود، از درخواست GET HTTP زیر استفاده کنید و کد مجوز توضیح داده شده در اسناد مجوز را وارد کنید. برای اطلاعات بیشتر در مورد رشته های درخواست درخواست و ویژگی های پاسخ، به مرجع 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 روز گذشته دریافت می کند. پارامتر query 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 را بر اساس نام رویداد بازیابی کنید
در برخی موارد، ممکن است بخواهید رویدادهای خاصی را بازیابی کنید، مانند ورودهای موفق مشکوک. برای انجام این کار، از یک درخواست GET HTTP از فرم زیر استفاده کنید:
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
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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 بهوقت ساعت هماهنگ جهانی."],[],[],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```"]]
