रिपोर्ट एपीआई: लॉगिन गतिविधि की रिपोर्ट

लॉगिन गतिविधि की रिपोर्ट में, आपके खाते के सभी उपयोगकर्ताओं की लॉगिन गतिविधियों की जानकारी दिखती है. हर रिपोर्ट, रिपोर्ट के एंडपॉइंट के बुनियादी अनुरोध का इस्तेमाल करती है. इसमें, उपयोगकर्ता के ईमेल पते जैसे रिपोर्ट के हिसाब से पैरामीटर शामिल होते हैं. हर रिपोर्ट के लिए, ज़्यादा से ज़्यादा समयावधि पिछले 180 दिन की हो सकती है.

लॉगिन गतिविधि की रिपोर्ट का इस्तेमाल, सिर्फ़ कानूनी मकसदों के लिए किया जा सकता है. ऐसा, आपके ग्राहक समझौते के मुताबिक किया जाता है.

किसी डोमेन के लिए, Google Workspace के लॉगिन इवेंट वापस पाना

अपने डोमेन की सभी सेवाओं के लिए सभी लॉगिन वापस पाने के लिए, यहां दिए गए 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 एचटीटीपी अनुरोध का इस्तेमाल करें. यह अनुरोध इस फ़ॉर्मैट में होना चाहिए:

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