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

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

डिवाइस की ऑडिट गतिविधि की रिपोर्ट का इस्तेमाल, सिर्फ़ आपके ग्राहक समझौते के मुताबिक, कानूनी मकसद के लिए किया जा सकता है. इन रिपोर्ट को देखने के लिए, 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