रिपोर्ट API: लॉगिन गतिविधि रिपोर्ट

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