يعرض تقرير نشاط تسجيل الدخول معلومات عن أنشطة تسجيل الدخول لجميع مستخدمي حسابك. يستخدم كل تقرير طلب نقطة نهاية التقرير الأساسي مع مَعلمات خاصة بالتقرير، مثل عنوان البريد الإلكتروني للمستخدم. تبلغ الفترة الزمنية القصوى لكل تقرير آخر 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 العميل الذي يجب retrieving التقرِير له.
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