रिपोर्ट एपीआई: डिवाइस ऑडिट गतिविधि रिपोर्ट

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

डिवाइस की ऑडिट गतिविधि की रिपोर्ट का इस्तेमाल, सिर्फ़ कानूनी तौर पर मान्य कामों के लिए किया जा सकता है. यह आपके ग्राहक समझौते के मुताबिक होना चाहिए. इन रिपोर्ट को ऐक्सेस करने की सुविधा, Google Workspace के किन वर्शन में उपलब्ध है, यह जानने के लिए Google Workspace के अलग-अलग वर्शन की तुलना करें लेख पढ़ें.

किसी डोमेन के लिए, डिवाइस के ऑडिट इवेंट वापस पाना

अपने डोमेन के सभी उपयोगकर्ताओं के लिए, डिवाइस से जुड़े सभी ऑडिट इवेंट वापस पाने के लिए, यहां दिया गया GET एचटीटीपी अनुरोध इस्तेमाल करें. साथ ही, अनुमति से जुड़े दस्तावेज़ में बताया गया अनुमति वाला टोकन शामिल करें. अनुरोध क्वेरी स्ट्रिंग और रिस्पॉन्स प्रॉपर्टी के बारे में ज़्यादा जानने के लिए, डिवाइस ऑडिट गतिविधि इवेंट देखें. पढ़ने में आसानी हो, इसके लिए यहां दिए गए उदाहरण को लाइन ब्रेक के साथ फ़ॉर्मैट किया गया है:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?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/mobile?maxResults=25

यहां दिए गए उदाहरण में, पिछले 180 दिनों के लिए, डिवाइस के सभी ऑडिट इवेंट की रिपोर्ट मिलती है. customerId से यह पता चलता है कि किस ग्राहक की रिपोर्ट वापस लाई गई है.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb

इवेंट के नाम के हिसाब से, डिवाइस के ऑडिट इवेंट वापस पाना

कुछ मामलों में, आपको खास इवेंट वापस पाने पड़ सकते हैं. जैसे, संदिग्ध गतिविधि के इवेंट. इसके लिए, यहां दिए गए फ़ॉर्म में GET एचटीटीपी अनुरोध का इस्तेमाल करें:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?maxResults=maximum number of events returned on a response page
&eventName=name of the event
&filters=event parameter relational operator parameter value

यहां दिए गए उदाहरण में, डोमेन में Android उपयोगकर्ताओं के लिए, संदिग्ध गतिविधि से जुड़े सभी इवेंट वापस पाने का तरीका बताया गया है:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25