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

يعرض تقرير نشاط تسجيل الدخول معلومات حول أنشطة تسجيل الدخول لجميع مستخدمي حسابك. يستخدم كل تقرير طلب نقطة نهاية التقرير الأساسي مع المَعلمات الخاصة بالتقارير مثل عنوان البريد الإلكتروني للمستخدِم. تشير رسالة الأشكال البيانية الفترة الزمنية القصوى لكل تقرير هي آخر 180 يومًا.

لا يمكن استخدام تقرير نشاط تسجيل الدخول إلا للأغراض القانونية فقط بما يتوافق مع اتفاقية العملاء.

استرداد أحداث تسجيل الدخول إلى Google Workspace لنطاق

لاسترداد جميع عمليات تسجيل الدخول إلى جميع خدمات نطاقك، استخدِم ما يلي: GET طلب HTTP وتضمين الرمز المميز للتفويض الموضح في مستندات التفويض لمزيد من المعلومات حول سلاسل طلب البحث وخصائص الاستجابة، يُرجى الاطّلاع على مرجع واجهة برمجة التطبيقات. لأغراض تسهيل القراءة، يتم تنسيق المثال التالي باستخدام أسطر أسطر:

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