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

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

في بعض الحالات، قد تحتاج إلى استرداد أحداث معيّنة، مثل عمليات تسجيل الدخول الناجحة المريبة. لإجراء ذلك، استخدِم طلب 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