يعرض تقرير "نشاط تسجيل الدخول" معلومات عن أنشطة تسجيل الدخول لجميع مستخدمي حسابك. يستخدم كل تقرير طلب نقطة نهاية التقرير الأساسي مع معلَمات خاصة بالتقرير مثل البريد الإلكتروني للمستخدم. الحد الأقصى للفترة الزمنية لكل تقرير هو آخر 180 يومًا.
لا يجوز استخدام تقرير نشاط تسجيل الدخول إلا للأغراض القانونية وفقًا لاتفاقية العميل.
استرداد أحداث تسجيل الدخول إلى Google Workspace لنطاق
لاسترداد جميع عمليات تسجيل الدخول لجميع خدمات نطاقك، استخدِم طلب HTTP GET
التالي وأدرِج الرمز المميز للتفويض الموضّح في
مستندات التفويض.
للمزيد من المعلومات حول سلاسل طلبات البحث وخصائص الاستجابة، راجِع مرجع واجهة برمجة التطبيقات.
لأغراض سهولة القراءة، تم تنسيق المثال التالي بإرجاع أسطر:
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