واجهة برمجة التطبيقات لإعداد التقارير: تقرير نشاط تسجيل الدخول

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