रिपोर्ट 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