Drive की गतिविधि की रिपोर्ट से, आपके उपयोगकर्ताओं की गतिविधियों के बारे में जानकारी मिलती है. जैसे, जब वे Google Workspace में Google Drive पर फ़ाइलों को मैनेज करते हैं, उनमें बदलाव करते हैं, और उन्हें शेयर करते हैं. उदाहरण के लिए, Drive पर की गई गतिविधि की रिपोर्ट का इस्तेमाल करके, किसी खास उपयोगकर्ता के बनाए गए सभी नए Drive दस्तावेज़ों की सूची देखी जा सकती है. यह सूची, तारीख की तय सीमा के हिसाब से देखी जा सकती है. इस जानकारी का इस्तेमाल, कॉन्टेंट को बेहतर तरीके से मैनेज करने और डेटा लीक होने की संभावनाओं के बारे में अहम जानकारी पाने के लिए किया जा सकता है. रिपोर्ट पाने के लिए, रिपोर्ट के हिसाब से पैरामीटर के साथ, रिपोर्ट एंडपॉइंट के बुनियादी अनुरोध का इस्तेमाल किया जाता है. जैसे, उपयोगकर्ता का ईमेल पता या Google Drive में किया गया कोई खास बदलाव. रिपोर्ट में, पिछले 180 दिनों का डेटा शामिल किया जा सकता है.
Google Drive की गतिविधि की रिपोर्ट का इस्तेमाल, सिर्फ़ उन खातों में कानूनी मकसद के लिए किया जा सकता है जिनके लिए लाइसेंस असाइन किया गया है.
अनुरोध की क्वेरी स्ट्रिंग और रिस्पॉन्स प्रॉपर्टी के बारे में जानकारी पाने के लिए, एपीआई रेफ़रंस देखें. Google Drive से जुड़े किसी खास इवेंट के बारे में जानकारी पाने के लिए, Drive इवेंट के नाम देखें.
किसी डोमेन के लिए Google Drive के इवेंट वापस पाना
Drive में मौजूद दस्तावेज़ों के बारे में जानकारी देखने के लिए, Drive में की गई गतिविधि की रिपोर्ट का इस्तेमाल किया जा सकता है. उदाहरण के लिए, आपके पास अपने खाते के Drive में हुए सबसे हाल के 25 इवेंट की सूची वाली रिपोर्ट का अनुरोध करने का विकल्प है. यह सूची, 180 दिनों तक की हो सकती है. यह रिपोर्ट पाने के लिए, अनुमति से जुड़ी गाइड में बताए गए तरीके से अनुमति टोकन पाएं. इसके बाद, यहां दिए गए एचटीटीपी GET अनुरोध का इस्तेमाल करें:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25
इस एपीआई कॉल का उदाहरण रिस्पॉन्स देखा जा सकता है.
इस उदाहरण में, Drive में हुए सभी इवेंट की रिपोर्ट, पिछले 180 दिनों के लिए दिखाई गई है. यह समयसीमा, ज़्यादा से ज़्यादा 180 दिन की हो सकती है.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive
उपयोगकर्ता के हिसाब से Google Drive के इवेंट वापस पाना
किसी उपयोगकर्ता की Google Drive गतिविधियों की रिपोर्ट पाने के लिए, अनुमति से जुड़ी गाइड में बताए गए ऑथराइज़ेशन टोकन के साथ, एचटीटीपी GET अनुरोध का इस्तेमाल करें.
userKey फ़ील्ड, रिपोर्ट में उपयोगकर्ता का प्राइमरी ईमेल पता होता है या सभी उपयोगकर्ताओं के लिए all होता है.
नीचे दिए गए उदाहरण में, किसी उपयोगकर्ता के किए गए सभी बदलावों की सूची वाली रिपोर्ट को वापस लाया गया है. एपीआई के रिस्पॉन्स का उदाहरण देखने के लिए, JSON रिस्पॉन्स का सैंपल देखें.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive
शेयर की गई ड्राइव के लिए Google Drive इवेंट वापस पाना
अनुमति से जुड़ी गाइड में बताए गए अनुमति टोकन के साथ एचटीटीपी GET अनुरोध का इस्तेमाल करके, शेयर की गई किसी ड्राइव के लिए Google Drive की गतिविधियों की रिपोर्ट देखी जा सकती है. userKey फ़ील्ड में, उस उपयोगकर्ता का ईमेल पता डालें जिसके लिए आपको रिपोर्ट चलानी है. इसके अलावा, सभी उपयोगकर्ताओं के लिए रिपोर्ट चलाने के लिए, all डालें.
इस उदाहरण में, शेयर की गई किसी ड्राइव में किए गए सभी बदलावों की रिपोर्ट दिखाई गई है. एपीआई के रिस्पॉन्स का उदाहरण देखने के लिए, JSON रिस्पॉन्स का सैंपल देखें.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=shared_drive_id==<id of shared drive>
शेयर की गई ड्राइव के इवेंट देखने के लिए, doc_type का इस्तेमाल करके फ़िल्टर करें. यहां दिए गए उदाहरण में, ऐसे इवेंट दिखाए गए हैं जिनका असर सभी शेयर की गई ड्राइव पर पड़ता है:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive
सदस्यता में हुए बदलावों के लिए इवेंट वापस पाने के लिए, shared_drive_membership_change इवेंट की जानकारी दें. इस उदाहरण में, शेयर की गई ड्राइव में जोड़े गए सभी सदस्यों की जानकारी मिलती है:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?evetName=shared_drive_membership_change&
filters=membership_change_type==add_to_shared_drive
इवेंट के टाइप के हिसाब से, Google Drive के इवेंट वापस पाना
किसी खास तरह के इवेंट के सभी इंस्टेंस की रिपोर्ट पाने के लिए, एचटीटीपी GET अनुरोध का इस्तेमाल करें. साथ ही, अनुमति से जुड़ी गाइड में बताए गए अनुमति टोकन का इस्तेमाल करें. जैसे, कोई दस्तावेज़ बनाना या उसमें बदलाव करना.
userKey फ़ील्ड, रिपोर्ट में उपयोगकर्ता का प्राइमरी ईमेल पता होता है या सभी उपयोगकर्ताओं के लिए all होता है.
यहां दिए गए उदाहरण में, खाते के दस्तावेज़ बनाने से जुड़ी सभी गतिविधियों की रिपोर्ट देखी जा सकती है. एपीआई के रिस्पॉन्स का उदाहरण देखने के लिए, JSON रिस्पॉन्स का सैंपल देखें:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create
JSON रिस्पॉन्स का उदाहरण
एपीआई को एचटीटीपी GET अनुरोध करने पर, सही जवाब के तौर पर एचटीटीपी 200 स्टेटस कोड दिखता है. स्टेटस कोड के साथ-साथ, जवाब में Drive के लिए एक रिपोर्ट भी मिलती है. ये रिपोर्ट, Admin console में भी उपलब्ध हैं. ज़्यादा जानकारी के लिए, Google Workspace एडमिन सहायता केंद्र पर जाएं.
eventName के बारे में जानकारी पाने के लिए, Drive में इवेंट के नाम का रेफ़रंस देखें. अनुरोध की क्वेरी स्ट्रिंग और रिस्पॉन्स प्रॉपर्टी के बारे में ज़्यादा जानकारी के लिए, एपीआई रेफ़रंस देखें.
{
"kind": "reports#auditActivities",
"nextPageToken": "next page's token",
"items": [
{
"kind": "audit#activity",
"id": {
"time": "2014-03-17T15:39:18.460Z",
"uniqQualifier": "report's unique ID",
"applicationName": "drive",
"customerId": "ABC123xyz"
},
"actor": {
"callerType": "USER",
"email": "kim@example.com",
"profileId": "user's unique Google Workspace profile ID",
"key": "consumer key of requestor in an OAuth 2LO request"
},
"ownerDomain": "domain of the source owner",
"ipAddress": "user's IP address",
"events": [
{
"type": "access",
"name": "edit",
"parameters": [
{
"name": "primary_event",
"boolValue": true
},
{
"name": "owner_is_shared_drive",
"boolValue": false
}, {
"name": "doc_id",
"value": "1DWuYM3ot_sAyEQqOz0xWJ9bVMSYzOmRNeBqbgtSwuK8"
},
{
"name": "doc_title",
"value": "Meeting notes"
},
{
"name": "doc_type",
"value": "document"
},
{
"name": "owner",
"value": "mary@example.com"
}
]
}
]
},
]
}