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

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