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

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