گزارش فعالیت ورود اطلاعات مربوط به فعالیت های ورود به سیستم همه کاربران حساب شما را برمی گرداند. هر گزارش از درخواست نقطه پایانی گزارش اولیه با پارامترهای خاص گزارش مانند ایمیل کاربر استفاده می کند. حداکثر دوره زمانی برای هر گزارش 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 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